Premiers pas

Ce document s'adresse aux développeurs qui souhaitent utiliser l'API AdSense Management pour obtenir des informations sur leur compte AdSense. Il suppose que vous connaissez les concepts de programmation Web ainsi que les formats de données Web.

Contenu

Avant de commencer...

Créer un compte AdSense

Vous avez besoin d'un compte AdSense à des fins de test. Si vous possédez déjà un compte test, vous êtes prêt. Vous pouvez visiter l'interface utilisateur AdSense afin de configurer, d'éditer ou d'afficher vos données de test.

Se familiariser avec AdSense

Si vous ne connaissez pas les concepts d'AdSense, lisez l'introduction à AdSense et testez l'interface utilisateur avant de commencer à rédiger votre code.

Choisir sa bibliothèque cliente

La page Exemples de code et bibliothèques clientes vous fournira des informations sur les bibliothèques et exemples de code à votre disposition. Cliquez sur l'onglet correspondant à votre langue et suivez les liens pour télécharger la source. La bibliothèque cliente effectuera les actions suivantes à votre place :

  • authentification
  • découverte de services
  • élaboration des demandes à l'API
  • analyse des réponses

Pour installer et configurer la bibliothèque cliente de votre choix, lisez les instructions qui figurent généralement dans le fichier README à la racine du référentiel.

Si votre mise en œuvre doit satisfaire des besoins spécifiques, comme l'utilisation d'une langue non prise en charge, vous pouvez effectuer des demandes directes à l'API au lieu d'utiliser une bibliothèque cliente.

Enregistrer son application

Pour pouvoir utiliser l'API AdSense Management, vous devez enregistrer l'application que vous développez auprès de Google :

  1. Accédez au tableau de bord des API.
  2. Connectez-vous à votre compte Google ou créez un compte.
  3. Créez un projet.
  4. Dans le projet que vous venez de créer, cliquez sur le bouton "Activate" (Activer) sous l'API AdSense Management.
  5. Accédez à la section "API Access" (Accès API).
  6. Créez un numéro client :
    1. Application Web, si votre mise en œuvre est hébergée sur un serveur Web.
    2. Application installée, pour tout le reste.

    Remarque : Les comptes de service ne sont pas acceptés, étant donné qu'ils ont accès à des données protégées.

  7. Modifiez les fichiers de configuration de votre projet de bibliothèque cliente en utilisant les informations d'identification que vous venez de créer. Pour en savoir plus, consultez la documentation relative à la bibliothèque cliente.

Remarque : Le compte Google utilisé pour l'inscription doit être votre compte développeur, c'est-à-dire le compte qui sera présenté comme le développeur de l'application aux yeux des utilisateurs de celle-ci. Ce compte ne doit pas nécessairement être associé à un identifiant AdSense, du fait que les utilisateurs autoriseront l'accès à leur propre compte lorsqu'ils utiliseront l'application.

Didacticiel de démarrage rapide

Suivez les instructions ci-dessous pour envoyer vos premières demandes. Sachez que ces étapes peuvent sensiblement varier en fonction de la bibliothèque ou de la langue que vous utilisez.

  1. Utilisez l'exemple de code qui convient pour récupérer la liste des clients publicitaires d'un compte AdSense. Cette demande lance un traitement 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 et celles du Réseau Display. Un compte AdSense peut disposer d'un ou de plusieurs clients publicitaires.

    1. Pour les applications Web, les utilisateurs seront redirigés vers un site où ils pourront choisir d'autoriser l'accès. Une fois l'autorisation donnée, ils seront redirigés vers l'URL de rappel définie dans le tableau de bord des API.
    2. Les applications installées fonctionnent de façon analogue. 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 dépend de la plate-forme.
  2. Utilisez l'explorateur des API de reports.generate pour demander le rapport suivant :
    • startDate: today-1m
    • endDate: today
    • dimensions: DATE
    • metrics: EARNINGS

    Les rapports vous permettent d'évaluer vos revenus, ainsi que les éléments qui affectent ces revenus. Il est possible de les générer pour l'intégralité d'un compte ou pour un sous-ensemble de blocs d'annonces par le biais de critères.

  3. Essayez de demander le même rapport depuis votre application.
  4. Vous pouvez filtrer les rapports par blocs d'annonces. Extrayez la liste des blocs d'annonces à l'aide de adunits.list. Sachez qu'un numéro client publicitaire est requis (pour l'obtenir, voir étape 1). Une fois que vous avez sélectionné un bloc d'annonces, utilisez son identifiant dans le paramètre 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 des propriétés des annonces diffusées (notamment la taille et le format).

    • startDate: today-1m
    • endDate: today
    • dimensions: DATE
    • metrics: EARNINGS
    • filter: AD_UNIT_ID==ca-pub-123456789:987654321
  5. Filtrez par critères personnalisés ou d'URL, ou associez plusieurs filtres.

    Les critères sont des outils qui vous permettent d'évaluer les performances d'un sous-ensemble de vos blocs d'annonces. Il en existe deux types : les critères d'URL et les critères personnalisés. Les premiers vous donnent la possibilité de suivre les performances d'une page ou d'un domaine en particulier, tandis que les seconds vous aident à évaluer les performances au niveau de groupes spécifiques de blocs d'annonces sélectionnés par l'utilisateur.

  6. Si vous le souhaitez, rejoignez le groupe des annonces de l'API AdSense.

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

Envoyer des commentaires concernant…

AdSense Management API
AdSense Management API