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

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

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

Однако диплинкинг и регистрация кликов все еще возможны с ESP, поддерживающими универсальные ссылки и App Links в дополнение к домену регистрации кликов. Кроме того, можно настроить собственный домен для регистрации кликов.

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

• Настройте приложение на поддержку диплинкинга с помощью OneLink.
• Проверьте версию SDK (как для Android, так и для iOS)

Настройка домена регистрации кликов Oracle Responsys

Следуйте указаниям в этом разделе, чтобы настроить домен кликов (домен регистрации кликов) в Oracle Responsys.

Шаг 1: Настройка домена кликов в Oracle Responsys

Для настройки домена кликов следуйте официальному руководству Oracle Responsys по созданию доменов кликов. Oracle Responsys использует таблицы ссылок для регистрации кликов для конкретной кампании.

Примечание. В таблицах ссылок можно задать URL для ссылки IOS, который будет совпадать с URL ссылки:

После настройки доменов кликов в таблице ссылок компания Responsys использует эти домены для упаковывания OneLinks, которые вы включаете в рассылки. Таким образом, Responsys может регистрировать клики в своей системе, сохраняя при этом функциональность OneLink и диплинкинга.

Шаг 2. Предоставьте Responsys файл AASA (iOS) и файл Asset Links (Android)

Настройка приложения

<activity android:name=".DeepLinkActivity">
    <intent-filter  android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
           <category android:name="android.intent.category.DEFAULT" />
           <category android:name="android.intent.category.BROWSABLE" />
           <data android:scheme="https"
               android:host="click.example.com"
               android:pathPrefix="/campaign" />
     </intent-filter>
</activity>

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

SDK необходимо разрешить ссылку OneLink в рамках домена кликов, чтобы получить информацию о кампании. Данные возвращаются в методе onAppOpenAttribution.

Для разрешения доменов кликов:

1. Убедитесь, что версия SDK не ниже 4.9.0.
2. Перечислите домены кликов в свойстве SDK resolveDeepLinkURLs. Это свойство должно быть установлено перед инициализацией SDK. Более подробная информация приведена в документации по SDK здесь.
   
   Objective-C Swift

   [AppsFlyerTracker sharedTracker].resolveDeepLinkURLs = @[@"example.com",@"click.example.com"];

   AppsFlyerTracker.shared().resolveDeepLinkURLs = ["example.com", "click.example.com"]
   

   • Важно! Если вы используете Movable Ink (MI) совместно с Oracle, то вам необходимо получить от менеджера MI CNAME и внутренние домены и добавить их в setResolveDeepLinkURLs, в дополнение к ссылке клика для Oracle. Пример доменов:
     • Домен Oracle: oracle-click.example.com
     • Домен MI CNAME: mi.example.com
     • Внутренний домен MI: example.micpn.com
3. Добавьте следующий код, чтобы SDK мог разрешить домен регистрации кликов:
   
   Objective-C Swift

   Добавьте этот код в AppDelegate.m

   - (NSDictionary *)allHTTPHeaderFieldsForResolveDeepLinkURL:(NSURL *)URL {
       if ([URL.host  isEqual: @"click.example.com"]) {
           return [NSDictionary dictionary];
       }
       else {
           return nil;
       }
   }

   Добавьте этот код в AppDelegate.swift

   func allHTTPHeaderFields(forResolveDeepLinkURL URL: URL!) -> [String : String]! {
       if (URL.host == "click.example.com") {
           /// Change User-Agent
           return [:]
       } else {
           return nil;
       }
   }
   

Отправка первого письма

1. Создайте URL OneLink на странице управления ссылками (или вручную).
2. При создании URL OneLink убедитесь, что в URL все значения параметров закодированы.
3. Настоятельно рекомендуется использовать следующие параметры:
   • pid (media source) — используйте медиа-источник, который означает данное использование, например, Email.
   • c (campaign) — название кампании, которую вы хотите измерить.
   • af_dp — схема URI диплинка, куда вы хотите перенаправлять своих пользователей.
   • af_web_dp — куда перенаправлять пользователей, перешедших по ссылке на компьютере.
   • af_ios_url — куда перенаправлять пользователей, не имеющих приложения, перешедших по ссылке на устройстве iOS.
   • af_android_url — куда перенаправлять пользователей, не имеющих приложения, при переходе по ссылке на устройстве Android.
4. Поместите URL-адрес OneLink в электронное письмо, созданное в Responsys. Пример:

   <a href="greatapp.onelink.me/abcd/1234567">Скачайте это суперское приложение!</a>

   На этом этапе Responsys упаковывает приведенную выше ссылку с помощью домена кликов, который вы задали на предыдущих шагах. Любой клик по домену кликов перенаправляет на ссылку атрибуции OneLink. Если приложение установлено на устройство пользователя, то домен кликов перенаправляет по диплинку в приложение.

https://greatapp.onelink.me/abcd?pid=Email&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

Тестирование ссылок

После выполнения всех описанных выше действий, создания соответствующего URL OneLink и размещения его в электронном письме отправьте себе тестовое письмо.

Чего следует ожидать?

Если приложение установлено, оно должно быть вызвано. Если реализованы соответствующие API для диплинкинга AppsFlyer SDK, то вы должны перейти по диплинку на соответствующий контент.
Кроме того, клик должен появиться как на дэшборде AppsFlyer, атрибутированный к указанному медиа-источнику и кампании, так и в данных Responsys.