Интеграция Salesforce Marketing Cloud с AppsFlyer

Краткий обзор. Интегрируйте данные AppsFlyer с аккаунтом Salesforce Marketing Cloud (SFMC), чтобы беспрепятственно использовать перенаправление по диплинкам из электронных писем. В этом потоке используется поддержка SFMC для универсальных ссылок в фирменном домене регистрации кликов.

SFMC_AF-logo.png

Введение 

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

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

Интеграция Salesforce Marketing Cloud с AppsFlyer

Шаги 1-4, описанные ниже, необходимы для поддержки диплинкинга на iOS.

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

iOSAndroid

SDK AppsFlyer для iOS версии 4.9.0 

Для универсальных ссылок iOS в среде SFMC необходимо выполнить следующее:

  • Приобретите и внедрите пакет аутентификации отправителя (SAP).
  • Приобретите сертификат SSL (также известный как конфигурация SSL) и отправьте форму запроса SSL.
    * Чтобы получить пакет аутентификации отправителя и сертификат SSL, обратитесь к своему представителю по работе с клиентами Salesforce или отправьте запрос в службу поддержки через центр Salesforce Help.

Шаг 1: Настройте свой домен для записи кликов в SFMC

Чтобы настроить домен для записи кликов, следуйте официальным руководствам SFMC:

Шаг 2: Загрузите свой SSL-сертификат в SFMC

Для правильной работы универсальных ссылок iOS ваш домен, регистрирующий клики, должен содержать сертификат SSL вашего домена, который следует установить в вашем аккаунте SFMC. Инструкции по настройке сертификатов SSL можно найти в официальном руководстве SFMC.

Шаг 3: Настройка диплинкинга в SFMC

Чтобы активировать перенаправление по диплинкам из электронных писем SFMC, выполните следующие действия:

  1. Войдите в свой аккаунт SFMC и перейдите к представлению Email Studio.
  2. Перейдите на вкладку Администратор.
  3. В боковом меню нажмите на диплинкинг. В этом представлении вы можете настроить новую интеграцию диплинков со своим приложением или изменить существующие.

  4. Чтобы создать новую конфигурацию, нажмите кнопку Создать и введите свой AppID. Значение AppID представляет собой комбинацию идентификатора вашей команды разработчиков Apple и идентификатора пакета. Оба эти значения можно получить из вашего аккаунта Apple Developer.

    Пример

    Если префикс идентификатора команды 5UABCDFGH и идентификатор пакета com.your.app, необходимо ввести следующее значение:
    5uabcdfgh.com.your.app

    SFMC_Deep_Linking_2.png

  5. Настройка универсальных ссылок и диплинкинга будет завершена после того, как SFMC создаст файл Apple App Site Association (AASA). Этот процесс может занять несколько часов. Сгенерированный файл можно увидеть по следующему URL-адресу:
    https://<click_recording_link_domain>/apple-app-site-association

Шаг 4: Настройте свой SDK AppsFlyer

Примечание

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

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

  1. Свяжите домен регистрации кликов в Xcode:

  2. Предоставьте домен регистрации кликов в API SDK setResolveDeepLinkURLs. Этот API необходимо вызывать до инициализации SDK. Более подробная информация приведена в документации по SDK здесь.
    AppsFlyerLib.shared().resolveDeepLinkURLs = ["example.com", "click.example.com"]
    
    • Важно! Если вы используете Movable Ink (MI) вместе с Salesforce, вам необходимо получить MI CNAME и внутренние домены у своего менеджера по работе с клиентами MI и добавить их в setResolveDeepLinkURLs, а также ссылку для кликов для Salesforce. Например:
      AppsFlyerLib.shared().resolveDeepLinkURLs = ["salesforce-click.example.com", "mi.example.com", "example.micpn.com"]
      
  3. Когда приложение вызывается кликом по универсальной ссылке, AppsFlyer SDK разрешает диплинк и извлекает ссылку OneLink. Затем все параметры диплинка передаются в API onAppOpenAttribution для выполнения логики диплинка.

Отправка электронных писем с OneLink через SFMC

  1. Создайте ссылку OneLink вручную или на странице ссылок OneLink на дэшборде AppsFlyer.
    • URL-адрес кодирует все значения параметров при создании OneLink. 
    • Настоятельно рекомендуются следующие параметры:
      pid медиа-источник Репрезентативный медиа-источник
      c название кампании Кампания, которая будет атрибутирована.
      af_dp URL-адрес диплинка Адрес перенаправления пользователей по диплинку.
      af_web_dp перенаправление на ПК Перенаправление для пользователей настольных компьютеров.
      af_ios_url  

      Перенаправление для пользователей iOS-устройств, у которых не установлено приложение.

      af_android_url   Перенаправление для пользователей Android-устройств, у которых приложение не установлено.
  2. Скопируйте ссылку в электронное письмо, созданное в Salesforce Email Studio.
    • Теперь Salesforce Marketing Cloud содержит ссылку на ранее заданный домен для записи кликов.
    • Любой клик на домен, регистрирующий клики, перенаправляет на ссылку атрибуции OneLink.

Пример

Для удобства чтения параметры URL не закодированы в URL-адресе:

https://example.onelink.me/ABcd?pid=Email&c=Spring_Newsletter&
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

Протестируйте ссылки

Чтобы протестировать ссылки атрибуции:

  1. Создайте соответствующий URL-адрес OneLink.
  2. Поместите его в электронное письмо.
  3. Отправьте электронное письмо себе.
  4. Нажмите ссылку.
  • Если приложение установлено на вашем устройстве, оно должно быть вызвано.
  • Если реализованы соответствующие API для диплинкинга в AppsFlyer SDK, то вы должны перейти по диплинку на соответствующий контент.
  • Клик должен появиться на дэшборде AppsFlyer, атрибутированный к указанному медиа-источнику и кампании.
  • Клик появляется в данных Salesforce.