Authorized Sellers for Apps (app-ads.txt)

Authorized Sellers for Apps, également appelé app-ads.txt, est une initiative de l'IAB qui permet de protéger l'inventaire publicitaire de votre application contre la fraude publicitaire. Vous créez des fichiers app-ads.txt pour identifier qui est autorisé à vendre votre inventaire. Identifier les vendeurs autorisés vous permet de bénéficier des dépenses publicitaires que les annonceurs auraient pu consacrer à des inventaires contrefaits d'applications usurpées.

Les fichiers app-ads.txt sont accessibles au public, et peuvent être explorés par les places de marché, les plates-formes côté offre (SSP), ainsi que d'autres acheteurs et fournisseurs tiers.

Même si vous n'êtes pas tenu d'utiliser un fichier app-ads.txt, nous vous encourageons vivement à le faire, en particulier si vous craignez que d'autres personnes n'usurpent votre application.

Un fichier app-ads.txt est un fichier texte qu'un développeur d'applications publie dans le domaine racine du site Web version développeur de son application. Il contient une liste des entités autorisées à vendre l'inventaire de cet éditeur. Pour utiliser le fichier app-ads.txt, les éditeurs doivent disposer d'un domaine Web sur lequel publier leur liste de vendeurs autorisés, afin que les différents fournisseurs de technologies publicitaires puissent l'explorer. Il existe un certain nombre de solutions d'hébergement de domaine qui permettent d'héberger des fichiers de manière arbitraire, y compris Firebase.

Prérequis

Configurer un fichier app-ads.txt pour vos applications

  1. Si vous ne l'avez pas déjà fait, créez un fichier texte et enregistrez-le sous le nom "app-ads.txt".

  2. Copiez et collez l'extrait de code suivant dans votre fichier app-ads.txt. (Remplacez pub-00000000000000 par votre référence éditeur. Vous trouverez votre référence éditeur dans la console AdMob > Paramètres.)

    google.com, pub-00000000000000, DIRECT, f08c47fec0942fa0
    
  3. Publiez votre fichier app-ads.txt à la racine de votre site Web version développeur (par exemple, https://example.com/app-ads.txt). Assurez-vous que le domaine est saisi exactement comme indiqué sur Google Play.

  4. Patientez au moins 24 heures pour qu'AdMob explore et valide votre fichier app-ads.txt.

  5. Revenez dans AdMob et vérifiez l'état de votre fichier app-ads.txt.

Publier le fichier app-ads.txt grâce à Firebase Hosting

Si votre site Web interdit l'importation de votre fichier app-ads.txt au niveau racine (par exemple, un site créé et hébergé par un service de génération de site), vous pouvez utiliser Firebase Hosting afin d'héberger ce fichier.

Firebase est une solution rapide, fiable et sans frais qui vous permet d'héberger votre fichier app-ads.txt avec votre propre domaine personnalisé ou sur les sous-domaines sans frais du projet Firebase : web.app et firebaseapp.com.

Avant de commencer

Vous devez disposer d'un projet Firebase pour publier le fichier app-ads.txt grâce à Firebase Hosting. Si vous n'avez pas de projet Firebase, créez-en un en suivant le guide du développeur.

Si vous avez déjà associé vos applications AdMob à Firebase ou si votre application utilise l'un des produits Firebase (par exemple, Google Analytics pour Firebase, Remote Config, etc.), vous pouvez utiliser le projet Firebase existant.

Installer la CLI Firebase

Vous pouvez installer la CLI Firebase à l'aide de npm (Node Package Manager). Toutefois, si vous ne connaissez pas Node.js, vous pouvez utiliser le binaire autonome à la place.

Consultez la documentation de la CLI Firebase pour savoir comment installer la CLI ou la mettre à jour vers la dernière version.

Initialiser votre projet

Pour initialiser votre projet Firebase sur votre ordinateur local, exécutez la commande suivante à partir de la racine du répertoire de votre projet.

firebase init

Lors de l'initialisation du projet, à partir des invites de la CLI Firebase :

  1. Sélectionnez cette option pour configurer l'hébergement.

  2. Sélectionnez un projet Firebase à associer à votre répertoire de projet local.

    Sélectionnez Utiliser un projet existant, puis choisissez dans la liste le projet que vous souhaitez associer.

  3. Spécifiez un répertoire à utiliser comme répertoire racine public.

    Appuyez sur Entrée pour sélectionner la valeur par défaut (public).

  4. Choisissez une configuration pour votre site.

    Étant donné que le site Web que vous allez créer n'est pas une application monopage, sélectionnez N.

À la fin de l'initialisation, Firebase crée et ajoute deux fichiers à la racine du répertoire de votre projet local :

  • Un répertoire public contenant les fichiers hébergés sur votre site Web.
  • Un fichier de configuration firebase.json qui liste la configuration de votre projet.
  • Un fichier .firebaserc qui stocke l'alias de votre projet.

Publier le fichier app-ads.txt

Pour publier le fichier app-ads.txt sur votre site :

  1. Placez le fichier app-ads.txt dans le répertoire public du répertoire de votre projet local.

  2. Exécutez la commande suivante à partir de la racine du répertoire de votre projet local :

    firebase deploy --only hosting
  3. Une fois le déploiement terminé, accédez à l'URL suivante pour vous assurer que le fichier app-ads.txt est publié. (PROJECT_ID est l'ID de votre projet Firebase.)

    https://PROJECT_ID.web.app/app-ads.txt

    Exemple : Si "awesome-project" est l'ID du projet, saisissez https://awesome-project.web.app/app-ads.txt dans la barre d'adresse de votre navigateur.

Ajoutez un domaine/sous-domaine à la fiche Play Store de votre application

Pour que votre fichier app-ads.txt soit exploré, vous devez lister le domaine ou sous-domaine que vous venez de créer dans la fiche de votre application sur Google Play.

Mettez à jour le site Web version développeur dans la fiche de l'application comme suit :

https://PROJECT_ID.web.app

Configurer les paramètres de redirection (facultatif)

Si vous possédez déjà un site Web et que vous prévoyez d'utiliser Firebase Hosting uniquement pour héberger votre fichier app-ads.txt, vous pouvez configurer Firebase Hosting pour rediriger la page de destination vers votre site Web existant.

Firebase Hosting utilisera public/index.html comme page de destination par défaut lorsqu'un utilisateur visitera votre site. Pour rediriger les utilisateurs vers le site Web de votre choix (par exemple, la page de votre application sur les réseaux sociaux) :

  1. Ouvrez le fichier firebase.json situé à la racine du répertoire de votre projet local.

  2. Sous l'objet "hosting", ajoutez l'objet "redirects" comme suit :

    "hosting": {
      ...
      "redirects": [
        {
          "source": "/",
          "destination": "URL_TO_REDIRECT",
          "type": 301
        }
      ]
    }
    

    Par exemple, si l'URL de la page de destination est https://www.example.com, la configuration de la redirection sera la suivante :

    "hosting": {
      ...
      "redirects": [
        {
          "source": "/",
          "destination": "https://www.example.com",
          "type": 301
        }
      ]
    }
    
  3. Exécutez la commande suivante pour déployer les modifications sur votre site.

    firebase deploy --only hosting
  4. Une fois le déploiement terminé, accédez à votre site (https://PROJECT_ID.web.app) pour vérifier si le paramètre de redirection est correct ou non.

Ressources