Процесс диплинкинга

Настройки

Для настройки OneLink требуется, чтобы два сотрудника организации — маркетолог и разработчик — работали сообща, используя свои ресурсы.

Роль маркетолога

Маркетолог планирует маркетинговые кампании и настраивает ссылки OneLink. URL-адреса OneLink передают параметры (например, deep_link_value) и данные, с помощью которых персонализируется опыт пользователей в рамках диплинкинга и отложенного диплинкинга.

📘

Совет

Маркетолог и разработчики должны вместе выбрать оптимальную систему для deep_link_value (and any other parameters/values) to minimize additional app updates.

The deep_link_value can be based on a SKU, post ID, path, or anything else. We strongly recommend agreeing on a system that allows for you to enter dynamic values on your chosen parameter, so you can generate many different deep links that go to different content within the app, without any further changes to the app code by the developers.

See the following URL examples. The deep_link_value of a fruit type was chosen by the marketer and developer together. And the developers made the values dynamic, so the marketer could enter any fruit without the need for further work by the dev team.

https://onelink-sample-app.onelink.me/H5hv?pid=Email&c=fruit_of_the_month&deep_link_value=apples...
https://onelink-sample-app.onelink.me/H5hv?pid=Email&c=fruit_of_the_month&deep_link_value=bananas...
https://onelink-sample-app.onelink.me/H5hv?pid=Email&c=fruit_of_the_month&deep_link_value=peaches...

Роль разработчика

Разработчики настраивают OneLink в приложении:

  • Начальная настройка
  • Реализация API для UDL
  • Реализация расширенного отложенного диплинкинга

Initial setup

Начальная настройка приложения для Android и iOS: открытие приложения (с помощью Android App Links, универсальных ссылок iOS или схем URI).

Implement Unified Deep Linking (UDL)

Implement the unified deep linking (UDL) API to retrieve data from the click and use that data to redirect users for a personalized experience to a specific in-app activity (deep linking or deferred deep linking).
This API is fast, easy to use, and supports both owned and paid media sources.

Примечание. По новым пользователям метод UDL возвращает только те параметры, которые относятся к отложенному диплинкингу: deep_link_value and deep_link_sub1-10. If you try to get any other parameters (media_source, campaign, af_sub1-5, etc.), they return null.

Implement UDL

[Recommended] Implement extended deferred deep linking

В некоторых случаях UDL не активируется для отложенного диплинкинга. Например, если:
- Пользователь переходит по ссылке из сети с самостоятельной атрибуцией (SRN), таких как Meta Ads или Twitter.
- Пользователь переходит по ссылке, которая не содержит такие параметры, как deep_link_value or deep_link_sub1-10.
- Время между кликом и установкой превышает окно атрибуции UDL, составляющее 15 минут.
Чтобы гарантировать отложенный диплинкинг в таких случаях, мы рекомендуем реализовать метод onConversionDataSuccess (OCDS), который является частью API для GCD. OCDS обычно используется для получения данных о конверсиях и до UDL был эксклюзивным методом обработки отложенного диплинкинга.
Важно: при реализации как UDL, так и OCDS разработчик должен гарантировать обработку отложенного диплинкинга только одним из методов.
См. инструкции по реализации расширенного отложенного диплинкинга для Android и iOS.

Legacy: Use only GCD API for Deep-Linking

Вместо UDL разработчики, уже применяющие OneLink, могут использовать устаревшие методы для диплинкинга и отложенного диплинкинга.
Устаревшие методы используют исключительно API для GCD, который состоит из двух методов: onConversionDataSuccess для отложенного диплинкинга и onAppOpenAttribution для диплинкинга. См. информацию об устаревших методах для Android и iOS.

Рекомендуется. Приложения только с реализованным API для GCD должны реализовать UDL и расширенный отложенный диплинкинг.

User invites

Позвольте пользователям направлять других людей в приложение с помощью ссылок OneLink, создав приглашения пользователей