Domaines de marque

En bref : les annonceurs qui utilisent les liens OneLink peuvent les marquer de leur propre domaine. Ceci améliorera les performances des campagnes et augmentera l'exposition de la marque.

Branded_1__3_.jpg

Domaines de marque

  • Les domaines de marque sont utilisés pour estampiller les liens d'attribution avec votre marque et votre domaine. Cf exemple ci-dessous :
    • OneLink : abcdef.onelink.me
    • Marque abcdef.com
    • Sous-domaine : ex. app
    • Implémentez des domaines de marque tout en utilisant votre domaine complet. Le lien d'attribution sera cliquer.abcdef.com.
  • Les domaines de marque augmentent les performances des campagnes, car :
    • Ils renforcent la confiance : capitalisez sur votre marque, proposez une identité cohérente, simplifiez les parcours utilisateur et améliorez vos taux CTR. 
    • Ils permettent au deep linking d'utiliser votre marque.
    • Ils sont faciles à implémenter et fonctionnent comme les OneLinks. 
    • Ils améliorent la visibilité de votre marque :  vos liens de campagne portent le nom de votre marque, ils ne sont pas génériques.
    • Autorisez les e-mails pour qu'ils ne soient pas considérés comme des spams à cause du lien qui ne correspond pas à l'e-mail de l'expéditeur.

Principes de mise en œuvre

Les liens de marque sont implémentés en associant un domaine complet défini dans votre Domain Name System (DNS) à un sous-domaine OneLink (la destination CNAME AppsFlyer). Pour ce faire, vous utilisez les paramètres standard de votre DNS et configurez un domaine de marque dans AppsFlyer. Vous devrez également apporter quelques petites modifications à votre app pour qu'elle prenne en charge les domaines de marque. 

Vous devrez faire appel au développeur d'app et à l'admin DNS (généralement un membre de votre équipe informatique ou de votre hébergeur DNS). 

Différents domaines complets peuvent être associés à un seul sous-domaine OneLink. Il est donc possible d'avoir plusieurs marques qui utilisent le même sous-domaine OneLink.

Configurer les domaines de marque

Suivez toutes les étapes de la procédure pour configurer un domaine de marque. 

  Responsable Action Remarques
1 Le marketer et l'admin DNS Configurer un lien de marque dans AppsFlyer L'admin DNS (généralement un membre de votre équipe informatique ou de votre hébergeur DNS) doit définir le domaine complet (ie l'hôte) puis définir un enregistrement CNAME tel qu'indiqué dans les instructions.
2 Développeur Configurer des domaines de marque dans l'app De petites modifications sont apportées au code de l'app.
3 Marketeur Utiliser et tester des domaines de marque  
Options Marketeur Modifier et supprimer des domaines de marque  

Procédures

Configurer un domaine de marque dans AppsFlyer

Pour configurer un domaine de marque, vous devez associer un domaine complet de votre DNS à un sous-domaine OneLink de AppsFlyer, comme illustré ci-dessous. 

Domaine de marque pointant vers les serveurs AppsFlyer

Branded2__3_.jpg

Avant de commencer :

  • Choisissez un nom de domaine complet, comme app.abcdef.com où abcdef.com est votre marque.
    • Le sous-domaine, par exemple app, peut également être personnalisé.
  • Demandez à l'admin DNS de créer le domaine complet (c'est à dire l'hôte).
  • Demandez à l'admin DNS de définir un enregistrement CNAME pour que le domaine complet (domaine de marque) pointe vers l'URL spécifiée (soit l'hôte AppsFlyer). Cf schéma ci-dessus qui illustre un domaine de marque pointant vers les serveurs AppsFlyer.

Pour mapper votre domaine complet à un sous-domaine OneLink :

  1. Allez dans Experiences et Deep Linking > Domaines de marque.
  2. Cliquez sur + Nouveau domaine de marque.
  3. Dans le champ Domaine de marque, entrez votre domaine complet tel que défini dans votre DNS. Par exemple cliquer.abcdef.com
    N'inscrivez pas de point après le domaine. 
  4. Sélectionnez le sous-domaine OneLink dans la liste qui s'ouvre.  Si aucune liste ne s’affiche, vous devez créer un template OneLink, celui-ci fournira un sous-domaine par défaut.
  5. Cliquez sur Suivant.
  6. Créez un enregistrement CNAME :
    • Si votre domaine a été correctement dirigé vers la destination CNAME AppsFlyer, le message « AppsFlyer CNAME trouvé » s'affiche.
    • Si le CNAME est introuvable, copiez la destination CNAME AppsFlye, transmettez-la à votre admin DNS et demandez-lui de s’assurer que votre domaine complet pointe bien vers la destination CNAME. Votre domaine complet doit forcément pointer vers une destination CNAME AppsFlyer. Dans le cas contraire, le domaine de marque sera bien créé mais il ne sera pas fonctionnel.  Si vous utilisez votre domaine de marque avec des ESP, sélectionnez Utiliser le domaine de marque pour une configuration ESP avant même de copier la destination CNAME..
  7. Cliquez sur Terminer.
    Vous pouvez maintenant créer de nouveaux liens avec votre domaine de marque en vous basant sur le template OneLink.

Remarque :

  • Si vous avez déjà créé des liens sans le domaine de marque à partir de votre template OneLink, ils continueront de fonctionner.
  • Cela peut demander jusqu’à 24 heures pour qu’un nouveau domaine de marque entre en activité.
  • Si vous ne créez pas d’enregistrement CNAME dans les 7 jours suivants, votre domaine de marque sera expiré. Vous devez actualiser votre domaine de marque avant de pouvoir l'utiliser. Pour l'actualiser : 
    1. Allez dans Experiences et Deep Linking > Domaines de marque.
    2. Ouvrez le domaine de marque que vous souhaitez actualiser.
    3. Cliquez sur Actualiser.
    4. Créez un enregistrement CNAME.

Configurer des domaines de marque dans l'app

  • Utilisez les versions suivantes du SDK  :
    • Android V4.10.1 et +
    • iOS V4.10.1 et +
    • Le référant d'invitation d'un utilisateur (inviter un ami) nécessite le SDK V5.2.0 et + pour iOS et Android 

Recommandations concernant l'implémentation du SDK de domaines de marque

  • Lorsque le deep linking est réalisé à travers un domaine de marque, le SDK AppsFlyer ne peut pas obtenir de données de conversion pour les installations et pour le deep linking.
  • Pour contourner ce problème, le développeur doit utiliser l'API de SDK setOneLinkCustomDomain pour Android, et oneLinkCustomDomains pour IOS.
  • Cette API envoie une requête au domaine, elle obtient le domaine de OneLink qui lui est associé, puis finalise le OneLink.
Android iOS

Pensez à mettre à jour intent-filter dans le manifeste pour inclure le domaine de votre marque en paramétrant android:host.

Utilisez cette API avant d'initialiser le SDK dans la classe d'applications globale Android .

Exemple

public class AFApplication extends Application {

    @Override
    public void onCreate() {
    super.onCreate();
      
      // Set branded link domain. Don't include https:// as part of the domain. 
      AppsFlyerLib.getInstance().setOneLinkCustomDomain("promotion.greatapp.com");
      AppsFlyerLib.getInstance().init(AF_DEV_KEY, conversionListener, this);
      AppsFlyerLib.getInstance().start(this, AF_DEV_KEY);

    }
}

Si vous avez plusieurs domaines de marque, transmettez-les tous à l'API pour être sûr d'obtenir toutes les données de conversion et de pouvoir toujours créer un deep link dans l'application.

Exemple

AppsFlyerLib.getInstance().setOneLinkCustomDomain("promotion.greatapp.com", 
                                                        "click.greatapp.com", 
                                                        "deals.greatapp.com");

Utiliser et tester des domaines de marque

Conditions préalables :

Avant d'utiliser et de tester les domaines de marque, suivez l'intégralité de la marche à suivre pour les domaines de marque.

Pour créer et tester des domaines de marque :

  1. Créez un lien OneLink en utilisant le template OneLink mappé au domaine de marque.
  2. Copiez le lien d'attribution personnalisé dans un éditeur de texte.
  3. Le lien d'attribution personnalisé est composé d'un sous-domaine OneLink, d'un ID OneLink et d'un ID de lien personnalisé. Remplacez le sous-domaine OneLink par le domaine complet du domaine de marque. Exemple :
    Lien d'attribution personnalisé Domaine de marque
    abcdef.onelink.me/A1bc/dc1234ef cliquer.abcdef.com/A1bc/dc1234ef
  4. Utilisez le lien de marque pour tester les installations ainsi que le deep linking.
  5. Si vous utilisez des rapports de données brutes pour le test, le champ «URL d'origine» sera rempli par les liens de marque. 

Modifier et supprimer des domaines de marque

La modification vous permet de changer le mappage d'un domaine complet pour qu'il soit associé à un autre sous-domaine OneLink. Il ne sera pas demandé de définir de CNAME.

 Attention

Modifier le domaine de marque d'une campagne active peut altérer ou interrompre le bon fonctionnement des liens.

Pour modifier un mappage de domaine de marque :

  1. Allez dans Experiences et Deep Linking > Domaines de marque.
  2. Ouvrez le domaine de marque que vous souhaitez modifier.
  3. Cliquez sur Modifier.

Pour supprimer un mappage de domaine de marque :

Dépannage, caractéristiques et seuils

Dépannage

Symptôme Cause/solution
Impossible de mapper le domaine de marque avec un template OneLink
  • Nom de domaine non valide : lors du mappage d'un domaine de marque avec un template OneLink, AppsFlyer cherche à vérifier que le lien de marque possède un nom de domaine valide. Un nom de domaine valide aura le format cliquer.abdef.com
  • Le domaine de marque est déjà mappé : un domaine complet ne peut être mappé qu'une seule fois.
Le domaine de marque ne se deep linke pas vers l'app
  • Vérifiez que le domaine de marque fonctionne bien
  • Vérifiez le CNAME : un enregistrement CNAME doit forcément partir de votre domaine de marque et pointer vers AppsFlyer.
  • Vérifier les paramètres de deep linking pour le template OneLink : un problème dans les paramètres de deep linking OneLink est possible. Pensez à bien configurer le deep linking pour OneLink :
  • Modification du mappage OneLink: vous pouvez modifier le domaine de marque et le mapper vers un autre OneLink. Si le OneLink nouvellement mappé a des paramètres de deep linking différents (ou aucun), le deep linking risque de ne pas fonctionner.
Aucune installation n'est mesurée depuis les domaines de marque
  • Vérifiez les paramètres du template OneLink : le sous-domaine OneLink utilisé pour mapper le domaine de marque doit être correctement associé aux différentes apps.
  • Le sous-domaine OneLink a été modifié : si vous mappez un domaine de marque avec un template OneLink et que le sous-domaine OneLink est modifié, cela peut avoir des effets sur l'attribution.
  • Pensez à implémenter  : l'API setOneLinkCustomDomain dans l'application.
Aucun réengagement n'est enregistré depuis les domaines de marque

Vérifiez que les éléments suivants sont actifs et correctement définis :

Durant la phase de configuration du domaine de marque, le message Domaine inexistant s'affiche

  1. Contactez votre admin DNS pour qu'il lance les vérifications.
  2. Attendez que l'admin DNS vous confirme que le domaine est bien enregistré.
  3. Cliquez sur Vérifier.

Durant la phase de configuration du domaine de marque, le message CNAME AppsFlyer introuvable s'affiche

  1. Demandez à l'admin DNS de définir un enregistrement CNAME pour que le domaine complet (domaine de marque) pointe vers l'URL spécifiée (soit l'hôte AppsFlyer). Cf schéma de cette section qui illustre un lien de marque pointant vers les serveurs AppsFlyer.
  2. Attendez que l'admin DNS vous confirme que le CNAME est bien actif.

Erreur route_not_found lors du chargement d'une page de domaine de marque

Les domaines de marque n'incluent ni le template ni les paramètres. Lorsque vous utilisez un domaine de marque, vous devez ajouter le template ou les paramètres à la fin de l'URL du domaine de marque.

Ex : si 'click.abcdef.com' est votre domaine de marque et que vous utilisez 'click.abcdef.com' tout seul, vous obtiendrez route_not_found_error.

Vous devez forcément ajouter les paramètres ou templates à la fin. Ex : click.abcdef.com/A1bc/dc1234ef

 

Erreur err_cert_authority_invalid lors du chargement d'une page de domaine de marque

Cette erreur indique que votre domaine de marque n'a pas de certificat HTTPS valide car l'autorité de certification n'est pas reconnue. Comme AppsFlyer certifie vos domaines de marque avec Let's Encrypt, le problème est certainement dû au fait que Let's Encrypt n'est pas reconnue comme autorité de certification (CA) valide selon les enregistrements DNS CAA (Certification Authority Authorization) de votre domaine.

Solution
Veuillez procéder comme suit :

  1. Déterminez si votre domaine reconnaît Let's Encrypt comme CA en passant par un service comme celui-ci.
  2. Demandez à vos admins système de mettre à jour les enregistrements CAA de votre domaine pour inclure Let's Encrypt comme autorité de certification autorisée.

Particularités et limites

Particularité Oui  / Non x Remarques 
Accès du ad network  X  
Autorisations de l'agence X Les agences ne peuvent pas accéder à la section Domaines de marque pour créer des domaines de marque. Elles peuvent cependant créer des liens personnalisés OneLink avec un sous-domaine de domaine de marque.
Transparence de l'agence X  
Fuseau horaire spécifique à l'app S/O  
Devise spécifique à l'app  S/O  
Restrictions liées aux caractères S/O Lorsque vous saisissez votre domaine de marque, le dernier caractère ne peut pas être un point (".").
Limitations de taille S/O  
Limitation de taux

Les certificats SSL/HTTP des domaines de marque sont générés par AppsFlyer via Let's Encrypt, avec un nombre de nouveaux certificats limité à 50 par semaine et par domaine.

Données organiques  
Données non organiques  
Actualisation des données N/A   
Données historiques  
Accès utilisateur du compte  
HTTP X Le protocole HTTP n'est pas pris en charge par les liens de marque. Vous devez utiliser HTTPS.