Чем мы можем помочь?

Поиск

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

  • Обновлено

EmailLabs, платформа доставки и аналитики электронной почты, встраивает OneLink AppsFlyer в электронные письма. Когда получатели электронных писем переходят по ссылке, они перенаправляются по диплинку в ваше приложение.
emaillabs-af-logo.png

Введение

ESP (поставщики услуг электронной почты) могут быть отличными источниками сегментированного пользовательского трафика.

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

Однако при использовании ESP, которые поддерживают универсальные ссылки поверх своего домена отслеживания кликов, диплинкинг и отслеживание кликов по-прежнему можно успешно выполнять.

Требования к версии SDK

https://support.appsflyer.com/hc/article_attachments/360016192917
  • AppsFlyer iOS SDK версии 6.0.4
Android;
  • SDK AppsFlyer для Android версии 6.0.0

Шаг 1. Настройка интеграции в EmailLabs

Чтобы настроить интеграцию в EmailLabs:

  1. Настройте свой домен в соответствии с этой статьей
  2. Настройте свой домен для записи кликов в соответствии с этой статьей и снимком экрана ниже.
    whitelabel-section-2.png
  3. Включите отслеживание ссылок в соответствии с этой статьей и снимком экрана ниже.
    link-tracking-section-3.png
  4. Свяжитесь со службой поддержки EmailLabs по адресу bok@emaillabs.pl и попросите включить SSL.
  5. В EmailLabs перейдите в раздел Панель > Учетные записи SMTP > Настройки > Диплинки и установите флажок «Активировано». Для приложений iOS введите Apple Application ID в соответствующее поле.
    deeplinking-section-5.png

Шаг 2: Настройка SDK AppsFlyer

Примечание

Если вы еще этого не сделали, убедитесь, что ваше приложение настроено для поддержки диплинкинга с помощью OneLink.

После настройки домена отслеживания кликов для поддержки Universal Links, как описано выше, необходимо настроить приложение для диплинкинга и обработки соответствующей Universal Link.

  1. Свяжите домен записи кликов в Xcode:
    configure-xcode-deeplinking-domain.png
  2. Передайте домен записи кликов в API SDK setResolveDeepLinkURLs. Этот API необходимо вызывать до инициализации SDK. Более подробная информация приведена в документации по SDK здесь.
    [[AppsFlyerLib shared] resolveDeepLinkURLs = @[@"example.com",@"click.example.com"];
  3. Когда приложение вызывается кликом по универсальной ссылке, AppsFlyer SDK разрешает диплинк и извлекает ссылку OneLink. Затем все параметры диплинка передаются в API onAppOpenAttribution для выполнения логики диплинка.

Шаг 3: Отправка электронных писем с OneLink через EmailLabs

  1. Создайте URL-адрес OneLink на странице управления ссылками (или вручную). Необходимо выполнить URL-кодирование значений параметров.
  2. [Рекомендуемая практика] Используйте следующие параметры:
    • pid (медиаисточник): укажите медиаисточник, отражающий этот сценарий использования, например EmailLabs.
    • c (кампания): название кампании
    • af_dp: схема URI для диплинкинга, по которой вы хотите перенаправлять пользователей.
    • af_web_dp: куда перенаправлять пользователей, переходящих по ссылке на компьютере.
    • af_ios_url: куда перенаправлять пользователей, у которых нет приложения, при переходе по ссылке на устройстве iOS.
    • af_android_url: Куда перенаправлять пользователей, у которых нет приложения, при переходе по ссылке на устройстве Android.
  3. Вставьте URL-адрес OneLink в электронное письмо.
    Пример: 
    <a href="links.example.com data-msys-sublink="appsflyer">Ссылка на ваше приложение!</a>
  4. Если электронное письмо является частью ретаргетинговой кампании, добавьте параметр is_retargeting=true.
    Это указывает на то, что ссылка атрибуции относится к ретаргетинговой кампании. Узнать больше о ретаргетинге.
  5. EmailLabs оборачивает ссылку в заданный домен кликов, чтобы клик по этому домену перенаправлял на ссылку атрибуции OneLink.

Например

Параметры URL-адреса в следующем примере не закодированы для удобства чтения. 

https://example.onelink.me/abcd?pid=emaillabs&c=Spring_Newsletter&is_retargeting=true&
af_dp=testapp://path/to/content&af_web_dp=https://www.example.com/path/to/content&
af_ios_url=https://www.example.com/path/to/content&af_android_url=https://www.example.com/path/to/content

Шаг 4: Протестируйте ссылки

Чтобы протестировать интеграцию:

  1. Настройте EmailLabs.
  2. Создайте URL-адрес OneLink.
  3. Вставьте URL-адрес в электронное письмо.
  4. Отправьте себе тестовое электронное письмо.

Ожидаемый результат:

  • Если приложение установлено, оно должно открыться, и вы перейдете на указанную страницу приложения по диплинку.
  • Клик отображается в:
    • Дэшборд AppsFlyer с атрибуцией по медиаисточнику и кампании.
    • Данные EmailLabs.

Tags