Intégration d'Oracle Responsys avec AppsFlyer

Les ESP (Email Service Providers) peuvent être d'excellentes sources de trafic segmenté.

L'un des défis posés par les ESP est d'obtenir une attribution et un deep linking corrects.Les ESP intègrent l'URL de deep linking dans le domaine d'enregistrement des clics de leur propre ESP. Cette procédure perturbe souvent la fonctionnalité des liens universels iOS et des liens d'app Android. 

Cependant, l'enregistrement des liens de deep linking et des clics est toujours possible avec les ESP qui prennent en charge les liens universels et les liens d'app en plus de leur domaine d'enregistrement des clics. Vous pouvez également configurer votre propre domaine de clics comme domaine d'enregistrement des clics.

Conditions préalables

• Configurez votre application pour qu'elle prenne en charge le deep linking avec OneLink.
• Vérifiez la version de votre SDK (Android et iOS)

Configuration du domaine de clics dans Oracle Responsys

Suivez cette section pour configurer votre domaine de clics (domaine d'enregistrement de clics) dans Oracle Responsys.

Étape 1 : Configurer un domaine de clics dans Oracle Responsys

Pour configurer un domaine de clics, suivez le guide officiel d'Oracle Responsys Créer des domaines de clics.Oracle Responsys utilise des tableaux de liens pour faciliter l'enregistrement des clics des campagnes.

Remarque: Dans les tableaux de liens, vous pouvez définir l'URL du lien iOS comme étant identique à l'URL du lien.

Une fois que vous avez défini des domaines de clics dans les tableaux de liens, Responsys utilise ces domaines pour encapsuler les OneLinks que vous incluez dans les campagnes d'e-mailing. De cette manière, Responsys peut enregistrer les clics dans son système tout en préservant les fonctionnalités de OneLink et de deep linking.

Étape 2 : Donner à Responsys un fichier AASA (iOS) et un fichier Asset Links (Android)

Configuration de votre app

<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>

Étape 2 : Configurer l'application pour les domaines de clics

Pour obtenir les détails de la campagne, le SDK doit résoudre le OneLink qui soutient le domaine de clic. Les détails sont renvoyés dans la méthode onAppOpenAttribution.

Pour résoudre les domaine de clics :

1. Assurez-vous de posséder le SDK 4.9.0 ou +.
2. Listez les domaines de clics dans la propriété du SDK ResolveDeepLinkURLs. Cette propriété doit être définie avant l'initialisation du SDK. Pour plus d'informations, veuillez vous référer à cette documentation sur le SDK.
   
   Objective-C Swift

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

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

   • Important ! Si vous utilisez Movable Ink (MI) conjointement avec Oracle, vous devez obtenir le CNAME MI et les domaines internes auprès de votre gestionnaire de compte MI et les ajouter à setResolveDeepLinkURLs, en plus du lien de clic pour Oracle. Exemples de domaines :
     • Domaine Oracle : oracle-click.example.com
     • Domaine MI CNAME : mi.example.com
     • Domaine interne MI : example.micpn.com
3. Ajoutez le code suivant pour que le SDK puisse résoudre le domaine d'enregistrement des clics :
   
   Objective-C Swift

   Ajouter ce code dans AppDelegate.m

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

   Ajouter ce code dans AppDelgate.swift

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

Envoyer le premier e-mail

1. Créez une URL OneLink dans la page de gestion des liens (ou manuellement).
2. Lors de la création de l'URL OneLink, veillez à encoder toutes les valeurs des paramètres.
3. Nous vous recommandons d'utiliser les paramètres suivants :
   • pid (source média) - Utilisez une source média qui indique cette utilisation, par exemple Email.
   • c (campagne) - Le nom de la campagne que vous souhaitez mesurer.
   • af_dp - Le schéma d'URI de deep linking vers lequel vos utilisateurs seront deep linkés.
   • af_web_dp - Où rediriger les utilisateurs qui cliquent sur le lien depuis un ordinateur de bureau.
   • af_ios_url - Où rediriger les utilisateurs qui n'ont pas l'application en cliquant sur le lien depuis un appareil iOS.
   • af_android_url - Où rediriger les utilisateurs qui n'ont pas l'application et qui cliquent sur le lien depuis un appareil Android.
4. Placez l'URL OneLink dans l'e-mail que vous créez dans Responsys. Exemple :

   <a href="greatapp.onelink.me/abcd/1234567">Téléchargez ma super app !</a>

   À ce stade, Responsys entoure le lien ci-dessus avec le domaine de clics que vous avez défini dans les étapes précédentes. Tout clic sur le domaine de clics redirige vers le lien d'attribution OneLink. Si l'application est installée sur l'appareil de l'utilisateur, le domaine de clics envoie le deep link dans l'app.

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

Tester vos liens

Après avoir suivi toutes les étapes mentionnées ci-dessus, créé l'URL OneLink et l'avoir placée dans un e-mail, envoyez-vous un e-mail de test.

Que va-t-il se passer ?

Si l'application est bien installée, elle devrait être appelée.Si les bonnes API de deep linking du SDK AppsFlyer ont été mises en œuvre, vous devez être deep linké vers le contenu attendu.
Un clic doit apparaître à la fois dans le tableau de bord d'AppsFlyer, attribué à la source média et à la campagne fournies, et dans les données de Responsys.