Интеграция с 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 откройте Настройки, затем выберите Конфигурация платформ.
3. На странице Конфигурация email-канала прокрутите до Пользовательский домен отслеживания и выберите Включить.

Примечание

Раздел Пользовательский домен отслеживания отображается только после настройки email-канала для вашего приложения. Если вы его не видите, сначала выполните конфигурацию email-канала.

4. Введите ваш CTD в поле Домен и выберите Далее.

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

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

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

6. В Pushwoosh выберите Проверить.

7. Когда проверка будет успешно завершена, выберите Сохранить.

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

9. После нажатия Сохранить ваш CTD появится в списке Пользовательский домен отслеживания в Конфигурации email-канала.

Чтобы отключить его позже, выберите ... рядом с вашим CTD, а затем выберите Отключить пользовательский домен отслеживания.

Совет

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

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

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

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

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

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

• Домен для отслеживания кликов: ваш CTD (например, clickpush.example.com)
• Конечная точка ESP: 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)