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 maîtrisez les concepts de programmation Web et les formats de données Web.

Avant de commencer

Obtenir un compte AdSense

Pour commencer, inscrivez-vous ou connectez-vous à votre compte AdSense.

Se familiariser avec AdSense

Si vous ne maîtrisez pas les concepts d'AdSense, lisez l'introduction à AdSense et testez l'interface utilisateur 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 exemples disponibles. Cliquez sur l'onglet de 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
  • la découverte de services
  • créer les requêtes à l'API
  • analyse des réponses

Lisez les instructions d'installation et de configuration de la bibliothèque cliente choisie, qui se trouvent généralement dans le fichier README du répertoire racine du dépôt.

Si votre mise en œuvre présente des besoins particuliers, tels que 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 nouveaux 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'enregistrement doit être votre compte de développeur, c'est-à-dire le compte que les utilisateurs de votre application doivent voir comme le développeur de l'application. Il n'est pas nécessaire que ce compte soit 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 l'association entre un compte AdSense et un produit AdSense, comme les annonces du Réseau de Recherche ou celles du Réseau Display. Un compte AdSense peut être associé à un ou plusieurs clients publicitaires.

    1. Pour les applications Web, les utilisateurs seront redirigés vers un site où ils pourront choisir d'accorder l'accès. Une fois l'autorisation accordée, elle sera redirigée vers l'URL de rappel définie dans la console des API.
    2. Les applications installées fonctionnent de manière similaire. La bibliothèque cliente essaiera 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 pour reports.generate pour demander le rapport suivant :
    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS

    Les rapports vous renseignent sur vos revenus, ainsi que sur les facteurs qui les influencent. Elles peuvent être diffusées sur l'ensemble d'un compte ou sur un sous-ensemble de blocs d'annonces, à l'aide de critères.

  3. Essayez de demander le même rapport depuis votre application.
  4. Vous pouvez filtrer les rapports par bloc d'annonces. Extrayez la liste des blocs d'annonces en utilisant adunits.list. Notez que vous devez indiquer un ID de client publicitaire (obtenu à l'étape 1). Après avoir choisi un bloc d'annonces, utilisez son ID dans le paramètre de filtre 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. Essayez de filtrer par critères personnalisés ou d'URL, ou de combiner plusieurs filtres.

    Les canaux sont des outils qui vous permettent 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 d'une page ou d'un domaine spécifique, tandis que le second vous permet de suivre les performances de groupes de blocs d'annonces spécifiques sélectionnés par l'utilisateur.

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