Обзор

AppsFlyer поддерживает измерение кампаний push-уведомлений от всех push-провайдеров, а также кампаний, реализованных непосредственно на базе Firebase Cloud Messaging или Apple Push Notification Services (APNS).

Есть два возможных способа реализовать интеграцию:

• С помощью шаблонов OneLink (рекомендуется).
• Отправив объект JSON с ключом af в полезной нагрузке push-уведомления (устарело).

Конверсии отображаются на обзорном дэшборде, в ретаргетинге или объединенных представлениях.

Как это работает?

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

1. Вы запускаете push-уведомление, содержащее шаблон OneLink или ключ af в его полезной нагрузке.
2. Пользователь приложения получает push-уведомление и нажимает на него.
3. Приложение загружается, и запускается SDK AppsFlyer.
4. SDK обрабатывает полезную нагрузку push-уведомления, которое открыло приложение.
5. SDK извлекает и отправляет данные атрибуции в AppsFlyer.

В сценарии OneLink, если OneLink настроен на направление пользователя на определенный экран в приложении, запускается диплинкинг.

Необходимые условия

Прежде чем продолжить, убедитесь, что ваше приложение имеет интегрированный SDK AppsFlyer и может получать push-уведомления.

Шаги

Чтобы настроить измерение push-уведомлений, необходимо выполнить следующие шаги:

1. Создайте push-уведомление, содержащее пользовательский ключ данных с шаблоном OneLink или ключ af с объектом JSON в качестве значения.
2. Настройте SDK для получения пользовательского ключа (выполняется разработчиком приложения).
3. Протестируйте интеграцию, запустив push-уведомление.
4. Просматривайте эффективность кампаний push-уведомлений на дэшборде.

1. Создание push-уведомления

Сначала создайте push-уведомление, содержащее данные атрибуции, используя один из следующих методов.

Примечание

В следующем примере мы используем Firebase в качестве push-провайдера. Инструкции должны быть применимы к любому push-провайдеру, с небольшими отличиями (если таковые имеются). Обратитесь к документации соответствующего push-провайдера.

Использование OneLink (рекомендуется) Использование JSON (устарело)

Использование OneLink (рекомендуется)

Это рекомендуемый метод для интеграции AppsFlyer с push-уведомлениями.

1. Создайте ссылку OneLink и настройте ее на ретаргетинг.
   Примечание: поддерживаются как короткие, так и длинные URL-адреса OneLink.
2. В пользовательских данных push-уведомления добавьте ссылку OneLink, содержащую данные атрибуции, которые вы хотите отправлять в AppsFlyer.

Пример Firebase

В Firebase:

https://support.appsflyer.com/hc/article_attachments/8452865227665/appsflyer-push-custom-data-firebase-json.png

Использование JSON (устарело)

Примечание

Ниже приводится документация по устаревшему методу интеграции AppsFlyer с push-уведомлениями, которая доступна для целей обратной совместимости. Если вы настраиваете новое приложение, используйте рекомендованное решение на базе OneLink.

В пользовательских данных push-уведомления добавьте пользовательский ключ af, который содержит данные атрибуции, которые вы хотите отправлять в AppsFlyer в формате JSON. Требуются следующие параметры атрибуции:

• pid
• is_retargeting
• c

Пример Firebase

В Firebase:

2. Настройка SDK

Эта задача требует изменения кода приложения. Следуйте инструкциям по настройке SDK:

• При внедрении рекомендованного решения на базе OneLink:
  1. сообщите разработчику приложения, как называется пользовательский ключ, который вы добавили к уведомлению. В нашем примере это af_push_link.
  2. Отправьте ему эти инструкции.
• При реализации устаревшего решения на базе JSON отправьте своим разработчикам эти инструкции.

3. Тестирование интеграции

Чтобы проверить, что измерения push-уведомлений интегрированы корректно, просто запустите push-уведомление в кампании, которую вы настроили в Шаге 1.

Если все настроено правильно, SDK будет делать следующее:

1. Прослушивать push-уведомления.
2. Обрабатывать данные атрибуции, встроенные в push-уведомление, и отправлять их в AppsFlyer.
3. Выполнять стандартный диплинкинг, если измерение push-уведомлений реализовано с помощью OneLink.

4. Просмотр кампаний push-уведомлений на дэшборде

Данные, полученные из push-уведомлений, можно увидеть на дэшборде Ретаргетинг.

Примечание: AppsFlyer устраняет дублирование данных push-уведомлений. То есть если AppsFlyer несколько раз получает идентичные полезные нагрузки, учитывается только одна.