Intégration de Salesforce Marketing Cloud avec AppsFlyer

En bref : Intégrez les données AppsFlyer à un compte Salesforce Marketing Cloud (SFMC) pour créer facilement des deep links à partir d'e-mails. Le flux utilise le support SFMC des liens universels pour un domaine d'enregistrement des clics de marque.

SFMC_AF-logo.png

Introduction 

Les ESP (Email Service Providers) sont d'excellentes sources de trafic segmenté. Mais certains ESP, et c'est un problème courant chez eux, n'effectuent pas correctement l'attribution ni le deep linking.

Les ESP intègrent une URL de deep linking dans leur propre domaine d'enregistrement ESP des clics. Cette procédure perturbe souvent les liens universels d'iOS. Certains ESP prennent cependant en charge les liens universels dans leur propre domaine d'enregistrement des clics, ce qui permet de créer le deep linking et d'enregistrer les clics.

Intégration de Salesforce Marketing Cloud avec AppsFlyer

Les étapes 1 à 4 décrites ci-dessous sont nécessaires pour prendre en charge le deep linking iOS.

Conditions à remplir

iOSAndroid

AppsFlyer iOS SDK version 4.9.0 

Pour les liens universels iOS, vous devez effectuer les opérations suivantes dans votre environnement SFMC :

  • Achat et mise en œuvre du Package d'authentification de l'expéditeur (SAP)
  • Achat d’un certificat SSL (également connu sous le nom de configuration SSL) et envoi du formulaire de demande SSL
    * Pour obtenir le SAP (package d'authentification de l'expéditeur) et le certificat SSL, contactez votre représentant de compte Salesforce, ou déposez une demande via l'Assistance Salesforce.

Étape 1 : définir votre domaine d'enregistrement des clics dans SFMC

Pour définir un domaine d'enregistrement des clics, suivez les différents guides proposés par SFMC :

Étape 2 : télécharger votre certificat SSL dans le SFMC

Pour que les liens universels iOS fonctionnent correctement, votre domaine d'enregistrement de clics doit inclure le certificat SSL de votre domaine, qui doit être installé dans votre compte SFMC. Les instructions concernant la configuration de vos certificats SSL se trouvent dans le Guide officiel de SFMC.

Étape 3 : Définir le deep linking dans SFMC

Pour permettre la création de deep linking à partir des e-mails de SFMC :

  1. Connectez-vous à votre compte SFMC et choisissez la vue E-mail Studio.
  2. Cliquez sur l'onglet Admin
  3. Dans le menu latéral, cliquez sur deep linking. Dans cette vue, vous pouvez configurer de nouvelles intégrations de deep linking avec votre app, ou modifier celles qui existent déjà.

  4. Pour créer une nouvelle configuration, cliquez sur le bouton Créer et saisissez votre ID d’app (AppID). La valeur AppID est constituée de l'ID de votre équipe de développeurs Apple et de l'ID de bundle. Ces deux valeurs peuvent être récupérées dans votre compte Apple Developer.

    Exemple

    Imaginons que le préfixe ID d’équipe est 5UABCDFGH et l’ID de bundle est com.your.app, alors la valeur à saisir est la suivante :
    5UABCDFGH.com.your.app

    SFMC_Deep_Linking_2.png

  5. La mise en place des liens universels et des deep linking est terminée une fois que SFMC a créé le fichier Apple App Site Association (AASA). Cette opération peut prendre quelques heures. Vous pouvez consulter le fichier généré via l'URL suivante :
    https://<click_recording_link_domain>/apple-app-site-association

Étape 4 : configurer votre SDK AppsFlyer

Remarque

Si ce n’est encore fait, veillez à configurer votre app pour qu'elle prenne en charge le deep linking avec OneLink.

Après avoir configuré votre domaine d'enregistrement de clics pour qu'il prenne en charge les liens universels (comme nous l’avons vu précédemment), vous devez configurer votre app pour qu'elle puisse deep linker et résoudre le lien universel.

  1. Associez le domaine d'enregistrement des clics dans Xcode :

  2. Fournissez le domaine d'enregistrement des clics à l'API SDKsetResolveDeepLinkURLs. Cette API doit être appelée avant l'initialisation du SDK. Pour plus d'informations, veuillez consulter ce guide du SDKsetResolveDeepLinkURLs.
    AppsFlyerLib.shared().resolveDeepLinkURLs = ["example.com", "click.example.com"]
    
    • Attention ! Si vous utilisez Movable Ink (MI) en plus de Salesforce, vous devez obtenir le CNAME MI et les domaines internes auprès de votre gestionnaire de compte MI, puis les ajouter à setResolveDeepLinkURLs, et ce en plus du lien de clic pour Salesforce, exemple :
      AppsFlyerLib.shared().resolveDeepLinkURLs = ["salesforce-click.example.com", "mi.example.com", "example.micpn.com"]
      
  3. Lorsque l'application est invoquée suite à un clic sur le lien universel, le SDK AppsFlyer résout le deep linking et extrait le OneLink sous-jacent. Tous les paramètres du deep linking sont ensuite distribués dans l'API onAppOpenAttribution pour exécuter le processus de deep linking.

Envoyer des e-mails avec OneLink via SFMC

  1. Dans le tableau de bord AppsFlyer, créez un lien OneLink manuellement ou sur la page des liens OneLink.
    • L'URL encode toutes les valeurs des paramètres lors de la création du OneLink. 
    • Ces paramètres sont fortement recommandés :
      pid Source média Source médiatique représentative
      c Nom de la campagne La campagne qui va être attribuée.
      af_dp URL de deep link Redirection via deep linking pour les utilisateurs.
      af_web_dp redirection depuis un ordinateur Redirection pour les utilisateurs d'un ordinateur.
      af_ios_url  

      Redirection pour les utilisateurs d'un appareil iOS qui n'ont pas installé l'app.

      af_android_url   Redirection pour les utilisateurs d'un appareil Android qui n'ont pas installé l'app.
  2. Copiez le lien dans l'e-mail créé dans l’E-mail Studio Salesforce.
    • Maintenant, Salesforce Marketing Cloud peut encapsuler le lien avec le domaine d'enregistrement des clics défini précédemment.
    • Tout clic sur le domaine d'enregistrement des clics redirigera vers le lien d'attribution OneLink.

Exemple

Pour des raisons de lisibilité, les paramètres URL ne sont pas encodés :

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

Tester vos liens

Pour tester vos liens d'attribution :

  1. Créez l'URL OneLink.
  2. Mettez-la dans un e-mail.
  3. Envoyez-vous l’e-mail.
  4. Cliquez sur le lien.
  • Si l'application est déjà installée sur votre appareil, elle devrait être invoquée.
  • Si les bonnes API de deep linking du SDK AppsFlyer ont été mises en œuvre, vous devriez être deep linké vers le bon contenu.
  • Un clic doit apparaître dans le tableau de bord AppsFlyer, attribué à la source média et à la campagne définies.
  • Un clic apparaît dans les données de Salesforce.