---
title: "Контекстный диплинк: что это и как он работает · Appy"
description: "Контекстный диплинк открывает экран приложения и передаёт данные о переходе: кто пригласил, какой промокод и из какой кампании пришёл человек."
source: "https://appy.to/ru/glossary/contextual-deep-link"
---

1.  [Главная](https://appy.to/ru)
2.  [Глоссарий](https://appy.to/ru/glossary)
3.  Контекстный диплинк (contextual deep link)

Диплинки

# Что такое контекстный диплинк?

Коротко

Контекстный диплинк (contextual deep link) — диплинк, который вместе с адресом экрана несёт дополнительные данные: кто поделился ссылкой, к какой кампании она относится, какой в ней промокод. Приложение читает эти данные при открытии и подстраивает под них экран, а с отложенным диплинком они переживают и новую установку.

Краткий пересказ в[ChatGPT](https://chatgpt.com/?q=%D0%9A%D1%80%D0%B0%D1%82%D0%BA%D0%BE%20%D0%BF%D0%B5%D1%80%D0%B5%D1%81%D0%BA%D0%B0%D0%B6%D0%B8%20%D1%8D%D1%82%D1%83%20%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D1%83%20%D0%B8%20%D0%BF%D0%B5%D1%80%D0%B5%D1%87%D0%B8%D1%81%D0%BB%D0%B8%20%D0%B3%D0%BB%D0%B0%D0%B2%D0%BD%D1%8B%D0%B5%20%D1%82%D0%B5%D0%B7%D0%B8%D1%81%D1%8B%3A%20https%3A%2F%2Fappy.to%2Fru%2Fglossary%2Fcontextual-deep-link) [Claude](https://claude.ai/new?q=%D0%9A%D1%80%D0%B0%D1%82%D0%BA%D0%BE%20%D0%BF%D0%B5%D1%80%D0%B5%D1%81%D0%BA%D0%B0%D0%B6%D0%B8%20%D1%8D%D1%82%D1%83%20%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D1%83%20%D0%B8%20%D0%BF%D0%B5%D1%80%D0%B5%D1%87%D0%B8%D1%81%D0%BB%D0%B8%20%D0%B3%D0%BB%D0%B0%D0%B2%D0%BD%D1%8B%D0%B5%20%D1%82%D0%B5%D0%B7%D0%B8%D1%81%D1%8B%3A%20https%3A%2F%2Fappy.to%2Fru%2Fglossary%2Fcontextual-deep-link) [Perplexity](https://www.perplexity.ai/search?q=%D0%9A%D1%80%D0%B0%D1%82%D0%BA%D0%BE%20%D0%BF%D0%B5%D1%80%D0%B5%D1%81%D0%BA%D0%B0%D0%B6%D0%B8%20%D1%8D%D1%82%D1%83%20%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D1%83%20%D0%B8%20%D0%BF%D0%B5%D1%80%D0%B5%D1%87%D0%B8%D1%81%D0%BB%D0%B8%20%D0%B3%D0%BB%D0%B0%D0%B2%D0%BD%D1%8B%D0%B5%20%D1%82%D0%B5%D0%B7%D0%B8%D1%81%D1%8B%3A%20https%3A%2F%2Fappy.to%2Fru%2Fglossary%2Fcontextual-deep-link)

## Что такое контекст

Обычный диплинк отвечает на один вопрос: какой экран открыть. Контекстный отвечает ещё и на второй: при каких обстоятельствах. Контекст — это набор значений, прикреплённых к ссылке, обычно в виде параметров запроса. Чаще всего это ID пригласившего, название кампании, код скидки, предпочитаемый язык или ID того, чем поделились.

Для приложения эти значения — входные данные. Оно может встретить нового пользователя именем друга, который его пригласил, само подставить код при оформлении заказа или пропустить шаг онбординга, который не подходит к кампании.

## Как данные попадают в приложение

Когда приложение уже установлено, всё просто. Ссылка приходит целиком — через Universal Link, Android App Link или URI-схему, — и приложение разбирает строку запроса.

Когда приложения нет, между ссылкой и приложением оказывается магазин, и он отбрасывает всё. Тогда данные идут тем же путём, что и отложенный диплинк: сервис ссылок сохраняет переход вместе с параметрами, а SDK в приложении забирает их при первом запуске. На Android значения можно пронести через Install Referrer в Google Play. Поэтому контекстные диплинки обычно описывают как возможность инструмента для отложенных диплинков. В Appy SDK тарифа Enterprise передаёт приложению ссылку, которая привела к новой установке, вместе с её параметрами.

## На что обратить внимание

Относитесь к контексту как к непроверенным входным данным. Строку запроса может отредактировать кто угодно, поэтому ссылка сама по себе не должна выдавать ни награду, ни скидку. Отправьте код на свой сервер, и пусть решает он.

Не кладите в ссылку персональные данные. ID пригласившего — нормально, адрес электронной почты — нет: ссылки оседают в истории браузера, в системах аналитики и на скриншотах. И заранее договоритесь об именах параметров. Передача параметров помогает, только если страница сайта, ссылка и приложение ждут одни и те же ключи.

ПримерДиплинк с контекстом

```
https://example.com/invite?ref=K42&promo=WELCOME10
```

Попробуйте здесь

## Создайте deep link для приложения

Укажите схему приложения, нужный экран, адреса в магазинах и сайт. Вы увидите ссылки для iOS и Android и сможете превратить их в одну ссылку Appy, которая отправит каждый телефон в нужный магазин.

## Соберите deep link

Заполнить примером

Схема приложения

URL-схема, которую регистрирует приложение, без ://

Путь к экрануНеобязательно

app://

Оставьте пустым, чтобы открыть главный экран.

Ссылка на App Store

Сюда попадёт iPhone, если приложение не установлено.

Ссылка на Google Play

Сюда попадут телефоны Android. Из неё же мы берём имя пакета.

Сайт для компьютеровНеобязательно

Куда ведёт ссылка на ноутбуке.

Создать deep link

Бесплатная регистрация. Без банковской карты.

Регистрация бесплатная, и ссылка сразу начинает отправлять людей в магазины. Открытие самого приложения входит в Pro за $9.99 в месяц.

Что дальше

1.  01Бесплатная регистрация через Google или email
2.  02Мы создаём smart-ссылку с этими настройками
3.  03Делитесь ей или включите открытие приложения на Pro

Предпросмотр

Ваш smart deep link

https://appy.to/•••••

1.  Приложение установлено

Заполните форму

2.  Приложение не установлено

Заполните форму

3.  На компьютере

Заполните форму


Deep link URI

—

Android intent URL

Добавьте ссылку на Google Play, чтобы его увидеть.

Что делает каждая ссылка

Прямые ссылки

Открывают приложение, только если оно уже установлено. В остальных случаях не работают.

Free

Одна https-ссылка: iPhone попадают в App Store, Android — в Google Play, компьютеры — на ваш сайт. Приложение не открывается.

Pro

Та же ссылка, которая ещё и открывает нужный экран, если приложение установлено.

Короткая ссылка появится после регистрации: бесплатно, около 30 секунд. Ссылки ниже в чистом виде работают только на телефонах, где приложение уже установлено.

[ПодробнееDeferred deep linking: как это работает и когда применятьКак ссылка и её параметры переживают установку, чтобы новый пользователь пришёл уже с приглашением или предложением.](https://appy.to/ru/blog/deferred-deep-linking)

## Частые вопросы

### Чем контекстный диплинк отличается от отложенного?

Это разные свойства. Отложенный значит, что адрес назначения переживает установку. Контекстный — что ссылка несёт данные помимо адреса. Ссылка может быть и той, и другой сразу, и реферальные ссылки обычно такие: код приглашения должен дойти до приложения, которого в момент нажатия на телефоне не было.

### Какие данные может нести контекстный диплинк?

Всё, что помещается в строку запроса и не относится к чувствительным данным: ID пригласившего или приглашения, UTM-метки, промокод, ID товара или материала, язык. Имён, адресов почты и токенов, дающих доступ, в ссылке быть не должно: ссылки хранятся и пересылаются там, где вы их не контролируете.

### Нужен ли для контекстных диплинков SDK?

Только для новых установок. Установленное приложение получает от системы всю ссылку и само читает параметры. Чтобы получить те же параметры после установки из магазина, в приложении нужен код, который запрашивает их при первом запуске, — это и делает SDK для отложенных диплинков.

## Связанные термины

-   [Отложенный диплинк (deferred deep link)](https://appy.to/ru/glossary/deferred-deep-link)

Отложенный диплинк (deferred deep link) — диплинк, адрес назначения которого переживает установку приложения. Человек без приложения нажимает на ссылку, попадает в магазин, устанавливает приложение, и при первом запуске открывается экран, который обещала ссылка: товар, приглашение или промокод, а не стартовый экран.

-   [Диплинк (deep link)](https://appy.to/ru/glossary/deep-link)

Диплинк (deep link) — ссылка, которая открывает конкретный экран внутри мобильного приложения: карточку товара, статью, сохранённую корзину, а не веб-страницу и не стартовый экран. Диплинком может быть ссылка на URI-схему, Universal Link на iOS, Android App Link или отложенный диплинк.

-   [Передача параметров (parameter forwarding)](https://appy.to/ru/glossary/parameter-forwarding)

Передача параметров (parameter forwarding) — когда smart-ссылка не теряет параметры из адреса, а несёт их дальше: в магазин приложений, на сайт и в диплинк. UTM-метки, промокоды и реферальные ID доходят до места назначения, поэтому одной ссылки хватает на все варианты кампании — не нужно заводить отдельную под каждый.


[Все термины глоссария](https://appy.to/ru/glossary)

## Одна ссылка на App Store, Google Play и сайт

На бесплатном тарифе Appy — 4 ссылки с QR-кодами. Каждый телефон попадает в свой магазин: App Store, Google Play, AppGallery, Galaxy Store или GetApps, а компьютер — на сайт. Без рекламы и без банковской карты.

[Создать ссылку бесплатно](https://appy.to/ru/account/register)
