Fuseaux horaires

​

Fuseaux horaires, comptes et facturation

Les valeurs de date-heure (datetime) sont toujours renvoyées en heure UTC (comme l’indique le Z à la fin de la valeur datetime). Les datetimes peuvent être spécifiés dans n’importe quel fuseau horaire dans une commande POST ou PUT en utilisant le format standard ISO 8601 pour les fuseaux horaires. L’heure est représentée à l’aide d’un sous-ensemble de la norme ISO 8601. Plus précisément, la chaîne strptime pour notre format de date est %Y-%m-%dT%l:%M:%S%z. Le fuseau horaire du compte de l’annonceur détermine l’heure exacte à laquelle les chiffres de facturation officiels sont arrêtés.

Lors de l’interrogation de l’API au niveau du compte (GET accounts), vous obtenez des informations de fuseau horaire qui ressemblent à ceci :

    {
      "request": {
        "params": {
          "account_id": "18ce54d4x5t"
        }
      },
      "data": {
        "name": "API McTestface",
        "business_name": null,
        "timezone": "America/Los_Angeles",
        "timezone_switch_at": "2016-07-21T07:00:00Z",
        "id": "18ce54d4x5t",
        "created_at": "2016-07-21T22:42:09Z",
        "salt": "54cb7b5a34183f77d82dd6d0f4329691",
        "updated_at": "2017-09-09T06:42:14Z",
        "business_id": null,
        "approval_status": "ACCEPTED",
        "deleted": false
      }
    }

Cela inclut deux valeurs de fuseau horaire : timezone (voir timezones sur Wikipedia pour une vue d’ensemble) et timezone_switch_at. Notez que timezone_switch_at est fourni dans le fuseau horaire UTC (+00:00), mais représentera toujours minuit dans le fuseau horaire indiqué.

Le fuseau horaire de l’annonceur n’est pas modifiable via l’API. Cet attribut est défini au niveau contractuel/de facturation par le gestionnaire de compte X de l’annonceur.

Veuillez tenir compte de la valeur timezone_switch_at lors de la création de rapports et de l’interrogation de nos endpoints d’analytics, car il y aura une discontinuité dans les données le jour où le compte passera du fuseau horaire America/Los_Angeles à la nouvelle valeur locale.

​

Spécifier les valeurs de date-heure avec fuseau horaire

Les valeurs de date-heure sont toujours renvoyées en heure UTC (comme indiqué par le Z à la fin de la valeur de date-heure). Les dates-heure peuvent être spécifiées dans n’importe quel fuseau horaire dans une commande POST ou PUT en utilisant le format de fuseau horaire de la norme ISO 8601. Par exemple, 2017-07-10T08:00:00-0800 est une valeur d’entrée acceptable et sera automatiquement convertie en valeur UTC 2017-07-10T16:00:00Z.

Lorsque vous utilisez les endpoints analytics avec une granularity de DAY ou TOTAL, la valeur start_time doit être spécifiée à minuit du jour souhaité dans le fuseau horaire local du titulaire du compte. Le décalage de fuseau horaire à utiliser sera celui du jour actuel, et non celui du jour en question. Par exemple, pour un compte publicitaire situé en America/Los_Angeles pendant l’heure d’été du Pacifique, le décalage UTC est -0700. Ainsi, dans une requête analytics, l’heure doit être spécifiée comme suit : start_time=2017-05-21T07:00:00Z ou start_time=2017-05-21T00:00:00-0700. Si le compte publicitaire se trouvait en Asia/Tokyo, où le décalage est toujours +09:00, les valeurs seraient spécifiées comme suit : start_time=2017-05-20T15:00:00Z ou start_time=2017-05-21T00:00:00+0900.

​

Formats de décalage UTC acceptés

Voir désignations de fuseaux horaires ISO 8601.

Formats pris en charge : Z, -HHMM, +HHMM, -HH:MM, +HH:MM, -HH, +HH