Commencer

Ce document s'adresse aux développeurs qui souhaitent utiliser l'API AdSense Management pour obtenir des informations sur leur compte AdSense. Dans ce document, nous partons du principe que vous connaissez les concepts de programmation Web et les formats de données Web.

Avant de commencer

Obtenir un compte AdSense

Inscrivez-vous ou connectez-vous à votre compte AdSense pour commencer.

Se familiariser avec AdSense

Si vous ne connaissez pas les concepts d'AdSense, lisez l'introduction à AdSense et testez l'interface utilisateur d'AdSense avant de commencer à coder.

Choisir votre bibliothèque cliente

Sur la page Exemples de code et bibliothèques clientes, vous trouverez des informations sur les bibliothèques et les exemples disponibles. Cliquez sur l'onglet correspondant à la langue de votre choix, puis suivez les liens pour télécharger la source. Les bibliothèques clientes gèrent les opérations suivantes à votre place:

  • authentification
  • découverte de services
  • les requêtes adressées à l'API
  • analyse des réponses

Lisez les instructions pour installer et configurer la bibliothèque cliente de votre choix, généralement disponible dans le fichier README du répertoire racine du dépôt.

Si votre mise en œuvre a des besoins particuliers, comme l'utilisation d'un langage non compatible, vous pouvez envoyer des requêtes directes à l'API au lieu d'utiliser une bibliothèque cliente.

Enregistrer votre application

Pour utiliser l'API AdSense Management, vous devez enregistrer l'application que vous développez en créant un projet et en générant un ID client.

Enregistrer votre application

Modifiez les fichiers de configuration de votre projet de bibliothèque cliente avec les identifiants que vous venez de créer. Pour en savoir plus, consultez la documentation de la bibliothèque cliente.

Remarque:Le compte Google utilisé pour l'inscription doit être votre compte de développeur, c'est-à-dire le compte que vous souhaitez que les utilisateurs de votre application voient en tant que développeur de l'application. Ce compte n'a pas besoin d'être associé à un identifiant AdSense, car les utilisateurs accorderont l'accès à leur propre compte lorsqu'ils utiliseront l'application.

Tutoriel de démarrage rapide

Suivez les étapes ci-dessous pour envoyer vos premières requêtes. Notez que ces étapes peuvent varier légèrement en fonction de la bibliothèque ou du langage que vous utilisez:

  1. Utilisez l'exemple approprié pour récupérer une liste de clients publicitaires à partir d'un compte AdSense. Cette demande lance un processus unique au cours duquel l'utilisateur AdSense authentifie et autorise votre projet.

    Les clients publicitaires représentent une association entre un compte AdSense et un produit AdSense, comme les annonces du Réseau de Recherche ou celles du réseau de contenu. Un compte AdSense peut être associé à un ou plusieurs clients publicitaires.

    1. Pour les applications Web, les utilisateurs seront redirigés vers un site sur lequel ils peuvent choisir d'accorder l'accès. Une fois autorisé, il sera redirigé vers l'URL de rappel définie dans la console Google APIs.
    2. Les applications installées fonctionnent de la même manière. La bibliothèque cliente essaie d'ouvrir une fenêtre de navigateur et d'utiliser un code d'autorisation. Pour les applications Android, Chrome et iOS, cette méthode est spécifique à la plate-forme.
  2. Utilisez l'explorateur d'API Google pour reports.generate pour demander le rapport suivant :
    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS

    Les rapports vous donnent un aperçu de vos revenus, ainsi que des facteurs qui ont un impact sur ces revenus. Elles peuvent être générées pour l'intégralité d'un compte ou pour un sous-ensemble de blocs d'annonces, à l'aide de critères.

  3. Essayez de demander le même rapport à partir de votre application.
  4. Vous pouvez filtrer les rapports par blocs d'annonces. Récupérez la liste des blocs d'annonces à l'aide de adunits.list. Notez qu'un ID de client publicitaire est nécessaire (obtenez-le à l'étape 1). Après avoir choisi un bloc d'annonces, utilisez son ID dans le paramètre filter pour reports.generate:

    Les blocs d'annonces sont des espaces réservés configurés par l'utilisateur pour les annonces. Ils définissent certaines propriétés des annonces diffusées (comme la taille et la forme).

    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS
    • filter: AD_UNIT_ID==ca-pub-123456789:987654321
  5. Filtrez par critères personnalisés ou d'URL, ou combinez plusieurs filtres.

    Les critères sont des outils permettant d'effectuer le suivi des performances d'un sous-ensemble de vos blocs d'annonces. Il existe deux types de critères : les critères d'URL et les critères personnalisés. Le premier vous permet de suivre les performances sur une page ou un domaine spécifique, tandis que le second vous permet de suivre les performances sur des groupes de blocs d'annonces spécifiques sélectionnés par l'utilisateur.

Vous êtes prêt à commencer votre implémentation en explorant les autres appels et ressources disponibles dans la documentation de référence.