Utiliser des mots clés de date relatifs

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 :

  • today
  • startOfMonth
  • startOfYear
  • latest

Ceci permet de générer des rapports en fonction de la date du jour. En outre, il est possible de les modifier :

RapportsDate de débutDate de fin
Performances des sept derniers jourstoday-6dtoday
Performances du mois dernierstartOfMonth-1mstartOfMonth-1d
Six derniers moisstartOfMonth-6mstartOfMonth-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 jourRésultat
latest-03-142014-03-152014-03-14
latest-03-142014-03-142014-03-14
latest-03-142014-03-132013-03-14
latest-latest-142014-03-152014-03-14
latest-latest-142014-03-142014-03-14
latest-latest-142014-03-132013-02-14

Et voici quelques exemples de périodes utilisant des dates relatives :

RapportsDate de débutDate de fin
Le dernier 14 marslatest-03-14latest-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-01today
Période depuis le dernier versement de salaire, pour une personne payée le 25 de chaque moislatest-latest-25today

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", ]
}
    

Exemple de rapport
Figure 3 : Exemple de rapport

Étapes suivantes