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.
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
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 :
- Allez dans Experiences et Deep Linking > Domaines de marque.
- Cliquez sur + Nouveau domaine de marque.
- 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. - 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.
- Cliquez sur Suivant.
- 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..
- 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 :
- Allez dans Experiences et Deep Linking > Domaines de marque.
- Ouvrez le domaine de marque que vous souhaitez actualiser.
- Cliquez sur Actualiser.
- 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, etoneLinkCustomDomains
pour IOS. - Cette API envoie une requête au domaine, elle obtient le domaine de OneLink qui lui est associé, puis finalise le OneLink.
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");
Pour associer les domaines aux liens universels iOS :
- Configurez le domaine/sous-domaine OneLink pour qu'il soit un domaine associé dans Xcode.
- Configurez le domaine de marque comme un domaine associé dans Xcode.
- Configurez le lien de marque afin de pouvoir obtenir les données de conversion via la méthode ci-dessous.
Utilisez l'API dans AppDelegate.m, au sein de la méthode didFinishLaunchingWithOptions :
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
/** APPSFLYER INIT **/
[AppsFlyerLib shared].appsFlyerDevKey = @"SED_DEV_KEY";
[AppsFlyerLib shared].appleAppID = @"123456789";
[AppsFlyerLib shared].oneLinkCustomDomains = @[@"promotion.greatapp.com"];
//...
//...
}
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 shared].oneLinkCustomDomains = @[@"promotion.greatapp.com", @"click.greatapp.com"];
L'API doit être utilisée dans le fichier AppDelegate.swift, au sein de la méthode didFinishLaunchingWithOptions :
func application(_ application: UIApplication, didFinishLaunchingWithOptions
launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
AppsFlyerLib.shared().appsFlyerDevKey = "6CQi4Be6Zs9oNLsCusPbUL"
AppsFlyerLib.shared().appleAppID = "340954504"
AppsFlyerLib.shared().oneLinkCustomDomains = ["example.com"]
//...
//...
}
Si vous avez plusieurs domaines de marque, vous pouvez les transmettre à l'API sous la forme d'une série de chaînes. Ainsi, quel que soit le domaine de marque utilisé, vous serez assuré d'obtenir toutes les données de conversion et de pouvoir toujours créer un deep link dans l'application.
Exemple
AppsFlyerLib.shared().oneLinkCustomDomains = ["promotion.greatapp.com", "click.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 :
- Créez un lien OneLink en utilisant le template OneLink mappé au domaine de marque.
- Copiez le lien d'attribution personnalisé dans un éditeur de texte.
- 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 - Utilisez le lien de marque pour tester les installations ainsi que le deep linking.
- 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 :
- Allez dans Experiences et Deep Linking > Domaines de marque.
- Ouvrez le domaine de marque que vous souhaitez modifier.
- Cliquez sur Modifier.
Pour supprimer un mappage de domaine de marque :
- Contactez votre CSM AppsFlyer ou écrivez à hello@appsflyer.com.
Dépannage, caractéristiques et seuils
Dépannage
Symptôme | Cause/solution |
---|---|
Impossible de mapper le domaine de marque avec un template OneLink |
|
Le domaine de marque ne se deep linke pas vers l'app |
|
Aucune installation n'est mesurée depuis les domaines de marque |
|
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 |
|
Durant la phase de configuration du domaine de marque, le message CNAME AppsFlyer introuvable s'affiche |
|
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
|
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. |