L'API AdSense Management comporte des appels permettant de générer de nouveaux rapports et des rapports enregistrés. Ils peuvent contenir des données analytiques simples, telles que les revenus par jour, ou des tableaux très complexes de taux de clics par critère personnalisé et par pays. Ce guide présente une liste de cas particuliers à gérer correctement pour une intégration robuste avec les API.
Structure du rapport
Les résultats du rapport sont renvoyés sous la forme d'un objet ReportResult. Consultez la documentation de référence sur les réponses du rapport pour obtenir les détails complets.
Utilisation de dimensions chronologiques: DATE, SEMAINE et MOIS
Les rapports peuvent être vides ou incomplets
En l'absence d'activité pendant la période spécifiée dans la requête, aucune demande d'annonce n'est générée et le service de rapport n'affiche pas de lignes pour ces périodes. C'est important si vous tracez un graphique, par exemple.
Pour en savoir plus, consultez le guide Remplir les dates.
Demander des dimensions MONTH et WEEK dans le même rapport
Ce rapport peut avoir des conséquences négatives ou inattendues. Si une semaine appartient à deux mois différents, elle affiche deux lignes pour la même semaine, une pour chaque mois.
Exemple
| Dimensions | Métriques | Date de début | Date de fin |
|---|---|---|---|
WEEKMONTH |
CLICKS | 2014-04-28 | 2014-05-03 |
Renvoie :
MONTH | WEEK* | CLICKS |
|---|---|---|
| 2014-04 | 2014-04-27 | 50 |
| 2014-05 | 2014-04-27 | 43 |
* premier jour de la semaine
Solution
Supprimez MONTH du rapport.
WEEK | CLICKS |
|---|---|
| 2014-04-27 | 93 |
Assembler des valeurs de dimension
Lorsque vous demandez des dimensions telles que celles associées aux plates-formes (ordinateurs, téléphones multimédias, etc.), seules les plates-formes avec une activité sont affichées. Si aucune visite depuis un smartphone n'a été enregistrée pour un jour, une semaine ou un mois donné, aucune information ne sera disponible pour cette catégorie.
Exemple
| Dimensions | Métriques | Date de début | Date de fin |
|---|---|---|---|
PLATFORM_TYPE_NAMEMONTH |
AD_REQUESTS |
2014-02-01 | 2014-03-31 |
Renvoie :
| MONTH | PLATFORM_TYPE_NAME | AD_REQUESTS |
|---|---|---|
| 2014-03 | Ordinateur | 100 |
| 2014-03 | Smartphones | 5 |
| 2014-04 | Ordinateur | 75 |
Solution
Lors du traitement des résultats du rapport, supposons une valeur de zéro pour toutes les valeurs de dimension qui n'apparaissent pas dans les résultats:
| MONTH | PLATFORM_TYPE_NAME | AD_REQUESTS |
|---|---|---|
| 2014-03 | Ordinateur | 100 |
| 2014-03 | Smartphones | 5 |
| 2014-04 | Ordinateur | 75 |
| 2014-04 | Smartphones | 0 |
Combiner plusieurs rapports contigus
Parfois, un rapport est trop volumineux pour être généré en une seule fois et doit être traité par lot. Si c'est le cas, tenez compte des cas suivants:
- Si vous utilisez des dimensions
WEEKouMONTHet que vous divisez le rapport au milieu d'une semaine ou d'un mois, chaque rapport comportera des entrées en double avec des données différentes. - Assurez-vous que tous les rapports présentent les mêmes métriques et dimensions, car il est possible que les données ne puissent pas être combinées en utilisant des dimensions différentes.
Comptes spéciaux
Certains de vos utilisateurs possèdent peut-être des comptes AdSense dont les attributs sont inattendus ou inconnus. Tenez compte des éléments suivants:
- Éditeurs possédant des milliers de domaines ou de sites
- Éditeurs disposant de milliers de blocs d'annonces ou de critères personnalisés
- Les éditeurs qui souhaitent créer des rapports sur plusieurs clients publicitaires (AdSense pour les recherches, AdSense pour les vidéos, etc.)
Plusieurs comptes
Les utilisateurs peuvent avoir accès à plusieurs comptes AdSense. Pour cette raison, un ID de compte doit être spécifié pour chaque appel à l'API. Un appel à accounts.list récupère la liste des comptes, et une boîte de dialogue de sélection de compte doit s'afficher à l'utilisateur. Il peut être contourné si le nombre de comptes récupérés est égal à un.
Changements de fuseau horaire
Les éditeurs AdSense peuvent modifier leur fuseau horaire à tout moment, ce qui peut entraîner des pics ou des baisses dans les rapports. Pour en savoir plus, consultez le guide Créer des rapports en fonction du fuseau horaire local.