Интеграция с AppsFlyer ESP 2.0

Требуется помощь разработчика

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

AppsFlyer — это платформа мобильной атрибуции и маркетинговой аналитики. AppsFlyer ESP 2.0 — это интеграция AppsFlyer для поставщиков услуг электронной почты (ESP). Подключите Pushwoosh к ESP 2.0, чтобы включить отслеживание ссылок в email-кампаниях. В этой интеграции Pushwoosh оборачивает URL-адреса, а решение ESP 2.0 обеспечивает работу диплинков для iOS Universal Links и Android App Links, когда ссылки оборачиваются для отслеживания.

Эта интеграция также отправляет данные о кликах по ссылкам в AppsFlyer, предоставляя вам полную видимость эффективности email-рассылок наряду с другими маркетинговыми каналами и позволяя измерять реальное влияние email-сообщений на привлечение и вовлечение пользователей.

Обзор интеграции

Предварительные требования

• Приложение Pushwoosh с настроенной отправкой email-сообщений
• Аккаунт AppsFlyer с интеграцией AppsFlyer ESP 2.0. Это премиум-функция. Свяжитесь с вашим CSM в AppsFlyer или со службой поддержки AppsFlyer, чтобы получить доступ.

Синхронизируемые сущности

Клики по email-ссылкам через ваш домен для отслеживания кликов (Click Tracking Domain) регистрируются как статистика кликов в Pushwoosh и как события кликов с данными атрибуции в AppsFlyer.

Сценарии использования

• Отслеживание кликов в email-сообщениях: измеряйте клики по ссылкам в email-сообщениях через AppsFlyer.
• Диплинки из email-сообщений: обеспечивайте работу Universal Links (iOS) и App Links (Android), когда ссылки в email-сообщениях оборачиваются.

Как работает интеграция

После запуска интеграции каждый клик проходит три этапа:

1. Pushwoosh заменяет ссылки в ваших email-сообщениях на URL-адреса для отслеживания на вашем CTD, например: https://clickpush.yourdomain.com/json/1.3/emailRedirect?d=...

2. Когда пользователь нажимает на ссылку, запрос направляется в AppsFlyer через настроенный CNAME. AppsFlyer регистрирует атрибуцию, обрабатывает диплинки и перенаправляет пользователя на конечный URL-адрес или в приложение через Universal Link / App Link. Он также отправляет GET-запрос в Pushwoosh, передавая ваш CTD в заголовке Host, чтобы Pushwoosh мог зарегистрировать клик:

   GET https://<Pushwoosh CNAME target>/json/1.3/emailRedirect
   Host: <your CTD>

3. Pushwoosh получает запрос и регистрирует клик для своей собственной статистики.

Настройка интеграции

Pushwoosh и AppsFlyer

Pushwoosh участвует только в первоначальной настройке CTD. Остальная часть интеграции выполняется на стороне AppsFlyer.

Шаг 1. Создайте и активируйте домен для отслеживания кликов

Домен для отслеживания кликов (Click Tracking Domain, CTD) — это доменная часть URL-адреса отслеживаемой ссылки, отображаемой в email-сообщении. Он состоит из поддомена и вашего основного домена, например, clickpush.esp-integrations1.com. Поддомен создается в настройках DNS вашего домена у вашего доменного провайдера, обычно путем добавления записи CNAME.

Требуется новый CTD

Создание нового CTD является обязательным для интеграции с AppsFlyer ESP 2.0, даже если вы уже используете существующий домен для отслеживания кликов. Использование нового домена позволит избежать влияния на трафик ваших текущих email-кампаний.

Для получения подробной информации см. руководство AppsFlyer: Настройте интеграцию с ESP в AppsFlyer.

1. Решите, какой поддомен вы будете использовать в качестве CTD (например, clickpush.esp-integrations1.com).
2. В Pushwoosh откройте Settings, затем выберите Configure Platforms.
3. На странице Email channel configuration прокрутите до Custom tracking domain и выберите Enable.

Примечание

Раздел Custom tracking domain отображается только после настройки email-канала для вашего приложения. Если вы его не видите, сначала выполните настройку email-канала.

4. Введите ваш CTD в поле Domain и выберите Next.

5. За пределами Pushwoosh откройте сервис, где вы управляете публичными DNS для домена вашего CTD (обычно это ваш регистратор доменов, DNS-хостинг или ваш хостинг-аккаунт). В его редакторе DNS или зон для этого домена добавьте CNAME, который Pushwoosh показывает на этом шаге, чтобы ваш CTD указывал на api.pushwoosh.com.

Распространение DNS

Изменения DNS обычно вступают в силу в течение нескольких минут, но могут занять до 48 часов.

6. В Pushwoosh выберите Verify.

7. Когда верификация будет успешно завершена, выберите Save.

8. Если вам нужно изменить Domain или DNS-запись, выберите Back и скорректируйте предыдущие шаги.

9. После нажатия Save ваш CTD появится в списке Custom tracking domain в разделе Email channel configuration.

Чтобы отключить его позже, выберите ... рядом с вашим CTD, а затем выберите Disable custom tracking domain.

Совет

Прежде чем продолжить, отправьте тестовое email-сообщение и убедитесь, что ссылка использует ваш CTD.

Пример отслеживаемой ссылки

https://clickpush.example.com/json/1.3/emailRedirect?d=...

Шаг 2. Начните интеграцию в AppsFlyer

На платформе AppsFlyer начните интеграцию с ESP 2.0. Следуйте руководству AppsFlyer по настройке интеграции с ESP.

AppsFlyer запросит следующие данные:

• Click-tracking domain: ваш CTD (например, clickpush.example.com)
• ESP endpoint: api.pushwoosh.com (цель CNAME, указанная в Pushwoosh при включении пользовательского домена отслеживания)

AppsFlyer проверит конфигурацию. Оставьте CNAME для CTD указывающим на api.pushwoosh.com до завершения проверки.

Шаг 3. Обновите CNAME для AppsFlyer

После того как AppsFlyer проверит настройку, он предоставит вам домен маршрутизации (например, jyvls.espclicks.appsflyer.com).

Обновите ваш CNAME так, чтобы CTD указывал на AppsFlyer вместо Pushwoosh:

До:

clickpush.example.com → api.pushwoosh.com

После:

clickpush.example.com → jyvls.espclicks.appsflyer.com (используйте домен, предоставленный AppsFlyer)

Время распространения

После обновления CNAME интеграция может заработать в течение 24 часов.

После переключения CNAME отправьте тестовое email-сообщение и убедитесь, что ссылки открываются корректно и клики появляются в AppsFlyer.

Что дальше

Как только изменение вступит в силу, трафик кликов будет проходить через инфраструктуру AppsFlyer. AppsFlyer предоставляет уровень маршрутизации, SSL, AASA (Apple App Site Association) и Android App Links.

Pushwoosh продолжит оборачивать ссылки и регистрировать статистику кликов. Никаких дополнительных настроек в Pushwoosh не требуется.

Чтобы узнать больше о настройке и тестировании на стороне AppsFlyer, см.:

Настройка интеграции с ESP в AppsFlyer

Руководство по интеграции с поставщиком email-услуг (ESP)