Configurer un fichier app-ads.txt pour votre application

Pour qu'AdMob puisse trouver et valider votre fichier app-ads.txt :

• Votre application doit être enregistrée sur le Google Play Store ou sur l'App Store d'Apple.
• La fiche de l'application sur la plate-forme de téléchargement doit inclure un site Web version développeur, comme expliqué ci-dessous.

Pour configurer un fichier app-ads.txt pour votre application, vous devez suivre les étapes ci-dessous :

• Étape 1 : Créer votre site Web version développeur
• Étape 2 : Créer votre fichier app-ads.txt
• Étape 3 : Publier votre fichier app-ads.txt sur votre site Web version développeur
• Étape 4 : Attendre qu'AdMob explore et valide votre fichier app-ads.txt
• Étape 5 : Vérifier que votre fichier app-ads.txt est validé dans votre compte AdMob

Étape 1 : Créer votre site Web version développeur

Un site Web version développeur permet à vos utilisateurs d'en savoir plus sur vos applications et autres contenus. C'est également via ce site que la norme app-ads.txt identifie le propriétaire d'une application. Votre site Web version développeur doit être associé à votre fiche sur Google Play ou l'App Store pour qu'AdMob et les autres plates-formes publicitaires vérifient que vous êtes propriétaire de l'application.

Si vous n'avez pas encore configuré de site Web pour votre activité de développement d'applications, vous devez réaliser cette opération avant d'intégrer le fichier app-ads.txt. Plusieurs solutions d'hébergement Web gratuites et payantes sont disponibles.

Si vous ne disposez pas d'un site Web approprié permettant d'importer un fichier app-ads.txt au niveau racine, vous pouvez utiliser Firebase Hosting pour héberger votre fichier app-ads.txt. Découvrez comment publier le fichier app-ads.txt grâce à Firebase Hosting.

Une fois votre site Web version développeur créé, ajoutez-le comme URL de contact du développeur dans la fiche de votre application sur les plates-formes de téléchargement. Si vous le souhaitez, vous pouvez publier sur ce site Web toutes les informations pertinentes concernant le marketing et l'assistance pour votre application.

Remarque : Vous n'avez pas besoin d'indiquer votre URL app-ads.txt complète dans la fiche de la plate-forme de téléchargement d'applications. AdMob explore votre fichier app-ads.txt en se basant sur le nom d'hôte (domaine) de l'URL du site Web. Découvrez comment nous trouvons votre fichier app-ads.txt.

Étape 1a : Ajouter votre site Web version développeur à la fiche de votre application sur la plate-forme de téléchargement

Pour ajouter votre site Web version développeur à la fiche de votre application sur les plates-formes de téléchargement :

• Pour Google Play : ajoutez l'URL du site Web dans la section "Coordonnées" de la fiche de votre application :
  1. Connectez-vous à la Play Console.
  2. Sélectionnez une application.
  3. Dans le menu de gauche, cliquez sur Présence sur le Play Store, puis sur Paramètres de la fiche Play Store.
  4. Faites défiler la page jusqu'à Coordonnées sur la fiche Play Store.
  5. Ajoutez l'URL de votre site Web version développeur. Pour confirmer que vous avez bien ajouté l'URL, vérifiez que le lien "Site Web du développeur" s'affiche en bas de la page de votre application Android.
     Remarque : Si vous avez ajouté ou mis à jour votre site Web version développeur dans la fiche de votre application sur Google Play, patientez jusqu'à 24 heures avant qu'AdMob détecte ces modifications.

• Pour l'App Store d'Apple : ajoutez votre site Web version développeur dans le champ de l'URL marketing de la fiche de votre application. Pour confimer que vous avez bien ajouté l'URL, vérifiez que le lien "Site Web du développeur" s'affiche en bas de la page de votre application iOS.

Étape 2 : Créer votre fichier app-ads.txt

Si votre site ne comporte pas de fichier app-ads.txt, vous pouvez en créer un. Vous devez inclure votre référence éditeur au format correct pour que le fichier app-ads.txt soit validé. Créez un fichier texte (.txt) à l'aide d'un éditeur de texte brut tel que Bloc-notes (Windows) ou TextEdit (Mac). Vous devrez ajouter votre extrait de code personnalisé à votre fichier app-ads.txt.

Voici un exemple de fichier app-ads.txt :

# exemple de fichier app-ads.txt :

greenadexchange.com, 12345, DIRECT, d75815a79

silverssp.com, 9675, RESELLER, 496211

blueadexchange.com, XF436, DIRECT

orangeexchange.com, 45678, RESELLER

silverssp.com, ABE679, RESELLER

google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0

Dans l'exemple ci-dessus :

• google.com est une place de marché.
• pub-0000000000000000 correspond à la référence éditeur/l'ID de compte.
• DIRECT correspond au type de relation.
• f08c47fec0942fa0 correspond à l'ID de l'autorité de certification (par exemple, l'ID du Trustworthy Accountability Group).

Remarque : Pour que votre fichier app-ads.txt soit validé, son format doit être conforme aux consignes de l'IAB Tech Lab. Si vous avez besoin d'une aide supplémentaire, consultez la spécification Authorized Sellers for Apps fournie par l'IAB Tech Lab.

Étape 2a : Ajouter votre extrait de code personnalisé dans votre fichier app-ads.txt

AdMob fournit un extrait de code personnalisé qui vous permet de configurer plus facilement votre fichier app-ads.txt. Cet extrait inclut votre référence éditeur.

Remarque : votre référence éditeur doit être incluse au bon format pour que votre fichier app-ads.txt soit validé.

Pour obtenir votre extrait de code personnalisé (qui inclut votre référence éditeur), procédez comme suit :

1. Connectez-vous à votre compte AdMob sur https://admob.google.com.
2. Cliquez sur Applications dans la barre latérale.
3. Cliquez sur Afficher toutes les applications.
4. Cliquez sur l'onglet app-ads.txt.
5. Cliquez sur Configurer un fichier app-adds.txt.
6. Cliquez sur à côté de l'extrait de code à copier.
7. Collez l'extrait de code dans votre fichier app-ads.txt.

Étape 2b : (Facultatif) Ajouter d'autres ID de vendeur autorisé dans votre fichier app-ads.txt

Si vous utilisez un autre réseau publicitaire, n'oubliez pas de l'ajouter à votre fichier app-ads.txt. Cela permet à votre vendeur tiers également de rechercher et de valider votre fichier app-ads.txt. Contactez votre réseau publicitaire pour savoir comment le spécifier dans le fichier app-ads.txt. 

Étape 3 : Publier votre fichier app-ads.txt sur votre site Web version développeur

Étape 3a : Importer votre fichier app-ads.txt dans le répertoire racine de votre site Web version développeur

Le répertoire racine d'un site correspond au répertoire ou au dossier qui suit le domaine de premier niveau (example.com/ads.txt). Pour example.com/ads.txt, example.com est le répertoire ou le dossier racine dans lequel vous devez importer votre fichier apps.ads.txt.

Conseil : Si vous ne savez pas où ajouter votre fichier apps.ads.txt, accédez à votre outil de création ou éditeur de sites pour obtenir des instructions spécifiques. Vous pouvez également contacter votre service d'hébergement Web pour savoir comment effectuer une importation dans le répertoire racine de vos sites. Pour en savoir plus sur le répertoire racine, cliquez ici.

Étape 3b : Vérifier que vous avez correctement publié votre fichier

Vérifiez si le contenu de votre fichier app-ads.txt est disponible. Dans votre navigateur Web, saisissez l'URL de votre fichier app-ads.txt (par exemple, https://example.com/app-ads.txt). Si le fichier app-ads.txt s'affiche dans votre navigateur Web, AdMob le trouvera très probablement.

Robot d'exploration AdMob pour les fichiers app-ads.txt

Le robot d'exploration AdMob recherche votre fichier app-ads.txt en se basant sur le site Web version développeur indiqué dans la fiche de votre application sur la plate-forme de téléchargement. Conformément à la spécification app-ads.txt, les robots d'exploration recherchent les fichiers aux URL qui correspondent aux formats suivants :

• https://<<nom d'hôte>>/app-ads.txt
• https://<<nom d'hôte>>/app-ads.txt

Le nom d'hôte est déterminé à partir du site Web version développeur de votre application. Il s'agit du domaine du site Web ou (dans certains cas) d'un sous-domaine, comme décrit ci-dessous.

Le tableau suivant présente des exemples généraux d'URL de sites Web version développeur et les adresses où le robot d'exploration AdMob recherche les fichiers app-ads.txt.

Si le site Web version développeur est :	Le robot d'exploration recherche dans l'ordre suivant :
https://example.com/game	https://example.com/app-ads.txt http://example.com/app-ads.txt
http://help.example.com/game	https://help.example.com/app-ads.txt http://help.example.com/app-ads.txt https://example.com/app-ads.txt http://example.com/app-ads.txt

Règles concernant les sous-domaines

La spécification app-ads.txt contient des règles spécifiques concernant les sous-domaines.

• Exploration jusqu'au sous-domaine de premier niveau
• Exclusion des sous-domaines "www." et "m."
• Redirections du serveur Web

Exploration jusqu'au sous-domaine de premier niveau

Pour construire l'URL d'un fichier app-ads.txt, les robots d'exploration analysent le sous-domaine jusqu'au premier niveau à partir du site Web version développeur.

Exemple :

Si le site Web version développeur est :	Le robot d'exploration recherche dans l'ordre suivant :
http://support.help.example.com/game	https://help.example.com/app-ads.txt http://help.example.com/app-ads.txt https://example.com/app-ads.txt http://example.com/app-ads.txt Remarque : "help.example.com" est au premier niveau de sous-domaine et est utilisé pour l'exploration, tandis que "support.help.example.com" est au deuxième niveau de sous-domaine et n'est pas utilisé pour l'exploration.

Exclusion des sous-domaines "www." et "m."

La spécification exclut les sous-domaines "www." et "m.". Les robots d'exploration ne rechercheront donc pas les fichiers à ces emplacements.

Si le site Web version développeur est :	Le robot d'exploration recherche dans l'ordre suivant :
https://www.example.com/game	https://example.com/app-ads.txt http://example.com/app-ads.txt
https://m.example.com/game	https://example.com/app-ads.txt http://example.com/app-ads.txt

Redirections du serveur Web

Votre serveur Web peut rediriger le robot d'exploration vers un fichier app-ads.txt hébergé à un autre endroit (y compris un sous-domaine "www.").

Si le robot d'exploration recherche un fichier ici :	Les destinations de redirection valides peuvent inclure, entre autres :
https://example.com/app-ads.txt	Le sous-domaine "www." de votre site Web : https://www.example.com/app-ads.txt Un autre sous-domaine et sous-répertoire : https://static.example.com/files/app-ads.txt Un autre sous-domaine, sous-répertoire ou nom de fichier : https://static.example.com/files/app-ads-1.txt Un autre domaine comprenant plusieurs sous-domaines : https://www.cdn.files.example.com/app-ads.txt

Pour vous assurer que vous avez correctement publié votre fichier app-ads.txt, vérifiez que son contenu s'affiche lorsque vous accédez à son URL dans votre navigateur Web. Si le fichier s'affiche dans votre navigateur Web, les robots d'exploration seront probablement en mesure de le trouver.

Pour en savoir plus sur les tentatives d'exploration de votre fichier app-ads.txt par AdMob, consultez votre compte AdMob.

Étape 4 : Attendre qu'AdMob explore et valide votre fichier app-ads.txt

L'exploration et la validation de vos fichiers app-ads.txt par AdMob peut prendre jusqu'à 24 heures. AdMob vérifie régulièrement votre dernier fichier, mais vous pouvez également demander à AdMob d'explorer votre application pour obtenir une réponse plus rapide :

1. Connectez-vous à votre compte AdMob sur https://admob.google.com.
2. Cliquez sur Applications dans la barre latérale.
3. Cliquez sur Afficher toutes les applications.
4. Cliquez sur l'onglet app-ads.txt.

5. Sur la ligne de l'application que vous souhaitez examiner, cliquez sur  pour développer la section. Des informations supplémentaires s'affichent, ainsi qu'une option pour demander à AdMob d'explorer votre application.

   

6. Cliquez sur Rechercher des mises à jour. Lorsque vous demandez à AdMob d'explorer un fichier app-ads.txt, le système met à jour l'état de toutes les applications qui partagent le même fichier app-ads.txt.
   • Dans certains cas, le bouton "Rechercher des mises à jour" peut être indisponible. Notez qu'AdMob explore régulièrement votre dernier fichier pour rechercher des mises à jour.

Remarque : L'exploration et la validation de vos fichiers app-ads.txt par AdMob peut prendre jusqu'à 24 heures. Vous devez patienter au moins 24 heures pour que l'état du fichier app-ads.txt soit mis à jour.

Si vous avez récemment ajouté votre site Web version développeur ou mis à jour la fiche de votre application dans Google Play, patientez jusqu'à 24 heures avant qu'AdMob détecte ces modifications.

Étape 5 : Vérifier que votre fichier app-ads.txt est validé dans votre compte AdMob

Vous pouvez consulter l'état et les détails de votre fichier app-ads.txt pour toutes vos applications dans votre compte AdMob.

Si votre fichier n'a pas été trouvé ni validé, consultez les informations fournies dans votre compte AdMob ou lisez l'article expliquant comment résoudre les problèmes liés au fichier app-ads.txt.