Exporter l’analyse des cartes de fil d’actualité

get

/feed/data_series

Utilisez cet endpoint pour récupérer quotidiennement une série de statistiques d’engagement pour une carte au fil du temps.

important:

News Feed is being deprecated. We recommend migrating to our Content Cards messaging channel instead—it’s more flexible, customizable, and reliable. To get started, check out Migrating from News Feed.

See me in Postman

Conditions préalables

Pour utiliser cet endpoint, vous aurez besoin d’une clé API avec l’autorisation feed.data_series.

Limite de débit

We apply the default Braze rate limit of 250,000 requests per hour to this endpoint, as documented in API rate limits.

Paramètres de demande

Paramètre Requis Type de données Description

card_id Requis Chaîne de caractères Voir l’identifiant API de la carte.

Vous trouverez le site card_id pour une carte donnée sur la page des clés API et sur la page des détails de la carte dans votre tableau de bord, ou vous pouvez utiliser le point de terminaison Exporter la liste des cartes du fil d’actualité.

length Requis Entier Nombre maximum d’unités (jours ou heures) avant ending_at à inclure dans la série renvoyée. Doit être compris entre 1 et 100 (inclus).

unit Facultatif Chaîne de caractères Unité de temps entre les points de données. Peut être day ou hour, valeur par défaut day.

ending_at Facultatif DateTime
chaîne (ISO-8601) Date à laquelle la série de données doit se terminer. Par défaut, l’heure de la demande.

Exemple de demande

curl --location -g --request GET 'https://rest.iad-01.braze.com/feed/data_series?card_id={{card_identifier}}&length=14&unit=day&ending_at=2018-06-28T23:59:59-5:00' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'

Réponse

Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
    "message": (required, string) the status of the export, returns 'success' when completed without errors,
    "data" : [
        {
            "time" : (string) the point in time - as ISO 8601 extended when unit is "hour" and as ISO 8601 date when unit is "day",
            "clicks" : (int) the number of clicks,
            "impressions" : (int) the number of impressions,
            "unique_clicks" : (int) the number of unique clicks,
            "unique_impressions" : (int) the number of unique impressions
        },
        ...
    ]
}

tip:

Pour obtenir de l’aide sur les exportations CSV et de l’API, consultez la section Résolution des problèmes d’exportation.

Modifier cette page sur GitHub

CETTE PAGE A-T-ELLE ÉTÉ UTILE?

Modifier cette page sur GitHub

New Stuff!