Pour vous aider, les paramètres startDate et endDate peuvent être remplacés par les mots clés spéciaux suivants au lieu du format AAAA-MM-JJ standard :
todaystartOfMonthstartOfYearlatest
Ceci permet de générer des rapports en fonction de la date du jour. En outre, il est possible de les modifier :
| Rapports | Date de début | Date de fin |
|---|---|---|
| Performances des sept derniers jours | today-6d | today |
| Performances du mois dernier | startOfMonth-1m | startOfMonth-1d |
| Six derniers mois | startOfMonth-6m | startOfMonth-1d |
Vous avez la possibilité d'ajouter (+) et de soustraire (-). Par ailleurs, les périodes disponibles sont années (y), mois (m), semaines (w) et jours (d).
Mot clé latest
Le fonctionnement du mot clé latest est sensiblement différent. Vous pouvez vous en servir à la place de AAAA ou MM dans le format de date AAAA-MM-JJ. Par exemple, le dernier 14 mars serait latest-03-14, tandis que le dernier 14 du mois serait latest-latest-14. Les dates renvoyées seront toujours passées.
Pour vous permettre d'y voir plus clair, voici quelques exemples :
| Demandé | Date du jour | Résultat |
|---|---|---|
latest-03-14 | 2014-03-15 | 2014-03-14 |
latest-03-14 | 2014-03-14 | 2014-03-14 |
latest-03-14 | 2014-03-13 | 2013-03-14 |
latest-latest-14 | 2014-03-15 | 2014-03-14 |
latest-latest-14 | 2014-03-14 | 2014-03-14 |
latest-latest-14 | 2014-03-13 | 2013-02-14 |
Et voici quelques exemples de périodes utilisant des dates relatives :
| Rapports | Date de début | Date de fin |
|---|---|---|
| Le dernier 14 mars | latest-03-14 | latest-03-14 |
| L'année fiscale américaine en cours jusqu'à ce jour (l'année fiscale américaine commence le 1er octobre et s'achève le 30 septembre) | latest-10-01 | today |
| Période depuis le dernier versement de salaire, pour une personne payée le 25 de chaque mois | latest-latest-25 | today |
Exemple de rapport
Vous trouverez ci-dessous un exemple de rapport indiquant les performances mensuelles d'un compte au cours des six derniers mois.
| Exemple de rapport : Revenus et clics mensuels, six derniers mois, afficher le dernier mois en premier | |
|---|---|
| Date de début : | startOfMonth-6m |
| Date de fin : | startOfMonth-1d |
| Variables : | MONTH |
| Statistiques : | EARNINGS, CLICKS |
| Tri : | -MONTH |
Résultat :
{
"kind": "adsense#report",
"totalMatchedRows": "6",
"headers": [
{"name": "MONTH", "type": "DIMENSION" }
{"name": "EARNINGS", "type": "METRIC_CURRENCY", "currency": "USD"}
{"name": "PAGE_VIEWS", "type": "METRIC_TALLY"}
],
"rows": [
["2013-03", "285", "46320"],
...
["2012-10", "298", "49201"]
],
"totals": ["", "1841", "300278"],
"averages": ["", "288", "47501", ]
}
