Échantillon global

Principes de base

Nous avons développé un échantillon global de l'API AdSense Host pour illustrer chaque étape du processus d'inscription des éditeurs, du lancement de l'association d'un compte à la génération du code d'annonce.

Le processus d'inscription se compose de quatre étapes :

  1. L'hôte demande une nouvelle session d'association en appelant associationsessions.start.
  2. L'hôte redirige l'éditeur vers l'URL du site Web AdSense fournie dans la session d'association affichée. L'éditeur remplit ensuite le formulaire sur cette page.
  3. L'éditeur est redirigé vers le site Web de l'hôte avec un paramètre de jeton inclus dans la requête HTTP.
  4. L'hôte vérifie le jeton en appelant associationsessions.verify. Si l'association a bien été créée, la réponse inclut l'identifiant de compte de l'éditeur, que l'hôte doit stocker localement pour pouvoir l'utiliser avec tous les appels API ultérieurs concernant cet éditeur.

Après avoir récupéré la référence de l'éditeur, l'hôte doit effectuer deux actions supplémentaires :

  1. Créer des blocs d'annonces sur le compte de l'éditeur en appelant accounts.adunits.insert
  2. Générer un code d'annonce pour les nouveaux blocs d'annonces en appelant accounts.adunits.getAdCode

Installation de l'échantillon global

  1. Commencez par télécharger et installer la version la plus récente de la bibliothèque cliente Python pour les API Google. Vous trouverez des packages à télécharger dans la section des téléchargements de la page du projet, mais nous vous recommandons de la télécharger et de l'installer via pip.
  2. Téléchargez et installez Django, en vérifiant que vous disposez bien de la version 1.5.x (une version antérieure ou ultérieure peut poser des problèmes de compatibilité). Nous vous recommandons là encore d'utiliser pip.
  3. Téléchargez et installez l'échantillon global :
  4. git clone https://code.google.com/p/adsense-apis-showcase
  5. Modifiez samplehost/settings.py pour ajouter des informations de base de données, en définissant les champs relatifs au moteur et au nom. Voici quelques exemples de paramètres pour sqlite3 :
  6. DATABASES = {
        'default': {
            'ENGINE': 'django.db.backends.sqlite3',
            'NAME': '/path/to/your_db.db',
            'USER': '',
            'PASSWORD': '',
            'HOST': '',
            'PORT': '',
        }
    }
    
  7. Dans le même fichier, pour TEMPLATE_DIRS, indiquez le chemin d'accès absolu au répertoire de votre fichier de modèle. Il s'agit du sous-répertoire templates/ dans votre installation d'échantillon global.
  8. Une fois que vous avez totalement configuré le projet Django, vous devez initialiser la base de données. Exécutez la commande suivante à partir de la racine de votre installation d'échantillon global :
  9. python manage.py syncdb
  10. Ajoutez ensuite votre certificat de développeur à client_secrets.json. Vous le trouverez dans la console des API, une fois que vous aurez créé un identifiant client d'application Web.
  11. Enfin, exécutez l'authentification initiale sur l'API pour créer adsensehost.dat (vous pourrez ainsi stocker les données du certificat qui vous ont été envoyées par le service d'autorisation de Google). Pour cela, n'oubliez pas d'utiliser votre compte AdSense Host. Exécutez la commande suivante à partir de la racine de votre installation d'échantillon global :
    python api_utils.py

La vidéo ci-dessous illustre le processus d'installation complet de l'échantillon.

Exécution de l'échantillon global

  1. Démarrez un serveur Django local afin d'exécuter l'application. Exécutez la commande suivante à partir de la racine de votre installation d'échantillon global :
    python manage.py runserver
  2. Veillez à copier l'URL du service. Il s'agit généralement de http://localhost:8000 (ou http://127.0.0.1:8000 si vous utilisez l'adresse IPv4), mais elle peut varier en fonction de vos paramètres.
  3. Ouvrez l'URL du service dans votre navigateur, puis cliquez sur le seul blog disponible. Vous accédez à un exemple de blog, sans annonce. Vous tenez maintenant le rôle d'un éditeur qui possède un blog et souhaite le monétiser.
  4. Ouvrez la page d'administration de ce blog. Le lien "Monetize your blog with AdSense" s'affiche. Cliquez dessus.
  5. Vous êtes redirigé vers une page d'inscription à AdSense, où vous pouvez choisir de créer un compte ou de vous connecter à un compte existant.
  6. Une fois que vous avez suivi la procédure d'inscription, vous êtes redirigé vers l'URL de rappel, sur votre installation d'échantillon global (http://localhost:8000/callback pour les paramètres par défaut).
  7. L'échantillon valide le jeton reçu, crée un bloc d'annonces, génère le code d'annonce pour ce dernier et vous redirige vers votre blog, sur lequel une annonce est désormais diffusée, en haut de la page. Si vous accédez à la page d'administration, vous verrez la référence éditeur correspondant au compte d'éditeur nouvellement créé (ou associé).

La vidéo ci-dessous illustre comment exécuter l'échantillon global.

Envoyer des commentaires concernant…