Exportar análisis de tarjeta de canal de noticias
get
/feed/data_series
Utiliza este punto final para recuperar una serie diaria de estadísticas de interacción de una tarjeta a lo largo del tiempo.
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.
Requisitos previos
Para utilizar este punto final, necesitarás una clave de API con el permiso feed.data_series
.
Límite de velocidad
Aplicamos el límite de velocidad predeterminado de Braze de 250 000 solicitudes por hora a este punto final, como se documenta en Límites de velocidad de la API.
Parámetros de la solicitud
Parámetro | Obligatoria | Tipo de datos | Descripción |
---|---|---|---|
card_id |
Obligatoria | Cadena | Ver Identificador API de tarjeta. Puedes encontrar el card_id de una tarjeta determinada en la página Claves de API y en la página de detalles de la tarjeta dentro de tu panel, o puedes utilizar el punto final Exportar lista de tarjetas de canal de noticias. |
length |
Obligatoria | Entero | Número máximo de unidades (días u horas) antes de ending_at a incluir en la serie devuelta. Debe estar entre 1 y 100 (ambos inclusive). |
unit |
Opcional | Cadena | Unidad de tiempo entre puntos de datos. Puede ser day o hour , de forma predeterminada, day . |
ending_at |
Opcional | Fecha y hora (cadena ISO-8601) |
Fecha en la que debe finalizar la serie de datos. De forma predeterminada, la hora de la solicitud. |
Ejemplo de solicitud
1
2
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'
Respuesta
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
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:
Para obtener ayuda con las exportaciones CSV y API, visita Solución de problemas de exportación.
New Stuff!