API de fecha de llegada de postbacks agregados de SKAN

Para:

Marketers

Última actualización: 19 de septiembre de 2024 12:51

A simple vista: Postbacks agregados de SKAdNetwork vía API. Los datos se agregan utilizando la fecha de llegada del postback.

La API devuelve postbacks agregados de SKAdNetwork, utilizando el intervalo de fechas de llegada del postback.

¡Nota! La fecha de llegada del postback difiere de la fecha de instalación usada en el panel de control y los informes de SKAdNetwork.

Para usar la API de informe de rendimiento agregado deSKAN:

Obtén el token de la API. Un administrador necesita recuperar el token.
Proporciónale a tu desarrollador el token de la API para que lo use en el encabezado de autenticación.
Proporciónales a tus desarrolladores los parámetros a introducir cuando hagan la llamada a la API, tal como se describe en la sección que sigue. Los parámetros determinan en qué se enfoca el informe, cómo está organizado y proveen un marco temporal para el reporte.
Indica a tu desarrollador que siga su API de informe de rendimiento agregado de SKAN en el centro de desarrolladores.

Nombre del parámetro	Detalles	Obligatorio
`start_date`	El intervalo de fechas de llegada del postback está delimitado por start_date y end_date. ¡Nota! La fecha de llegada difiere de la fecha de instalación utilizada en el panel de control y los informes de SKAdNetwork. AAAA-MM-DD Fecha más temprana permitida: 2020-11-01 Ejemplo: `2020-11-05`	Sí
`end_date`	AAAA-MM-DD Número máximo de días por llamada de informe: 60 días Ejemplo: `2020-11-12`	Sí
`ad_network_name`	Filtrar por fuente de medios	No
`geo`	Filtrar por código de país usando ISO 3166 (alfa-2). Ejemplo: `US`, `CN`	No
`skad_redownload`	Filtrar por `true` o `false`	No
`skad_source_app_id`	Filtrar por ID de la aplicación fuente	No
`ad_network_campaign_id`	Filtrar por ID de campaña de red publicitaria. Nota: Este no es el ID de campaña informado por SKAdNetwork.	No
`modeled_conversion_values`	Solo compatible desde V2 El valor puede ser o Si `true`, el postback llena la columna “count” con datos de valor de conversión modelado. Ver campo disponible para datos modelados Si , el postback presenta el conteo del valor de conversión y con todos los campos disponibles como se recibe y se lista en la estructura del informe, sin datos modelados. El valor predeterminado es .	No

La API devuelve un archivo CSV.

Las columnas y métricas disponibles se enumeran en la tabla que sigue.

Ejemplos: V1| V2

Estructura del informe agregado de SKAdNetwork
Nombre de columna	Dimensión o medida	Disponible con el token API V1	Disponible con el token API V2	Disponible con el token API V2 (para SKAN 4)	Solo disponible con filtro de datos modelados
skad_postback_sequence_index	Agrupar por	N	N	S	S
skad_conversion_value	Agrupar por	S	S	S	S
skad_coarse_conversion_value	Agrupar por	N	N	S	S
skad_ad_network_id Algunas SRNs no comparten su ID con nosotros. En ese caso, el campo está en blanco y se rellena ad_network_name.	Agrupar por	S	S	S	S
ad_network_name Actualmente, en la mayoría de los casos, este campo está en blanco. Lo llenamos en el caso de SRNs que no comparten su skad_ad_network_id	Agrupar por	S	S	S	S
skad_source_identifier	Agrupar por	N	N	S	S
skad_campaign_id	Agrupar por	S	S	S	S
ad_network_campaign_id	Agrupar por	S	S	S	S
ad_network_campaign_name	Agrupar por	S	S	S	S
ad_network_adset_id	Agrupar por	N	S	S	S
ad_network_adset_name	Agrupar por	N	S	S	S
ad_network_ad_id	Agrupar por	N	S	S	N
ad_network_ad_name	Agrupar por	N	S	S	N
ad_network_creative	Agrupar por	N	N	S	N
ad_network_channel	Agrupar por	N	N	S	N
skad_version	Agrupar por	S	S	S	N
skad_redownload	Agrupar por	S	S	S	N
skad_source_app_id	Agrupar por	S	S	S	N
skad_source_domain	Agrupar por	N	N	S	S
skad_fidelity_type	Agrupar por	N	S	S	N
geo	Agrupar por	S	S	S	N
arrival_date	Agrupar por	S	S	S	S
count	Medida	S	S	S	S

Especificación	Observaciones
Actualización de datos	El informe se actualiza diariamente. La disponibilidad de datos es conforme a la tasa de actualización de datos de SKAdNetwork.
Rango de fechas	Primera fecha soportada: 1 de noviembre de 2020 Rango máximo de consulta: 60 días
Límite de tasa	Las consultas devuelven hasta 200K filas 60 llamadas por minuto
SRNs	Google Ads: La fecha de llegada del postback se deriva del tiempo del último clic informado por Google.
Acceso a red de anuncios	Disponible para socios de análisis si el anunciante otorga permiso.
Acceso a la agencia	No disponible
Zona horaria específica de la aplicación	Solo UTC
Moneda específica de la aplicación	Siempre en USD
Datos orgánicos	No disponible con esta API
Datos no orgánicos	Calculados usando los postbacks de SKAdNetwork recibidos por AppsFlyer
Datos históricos	La primera conversión soportada (instalación o redirección): 1 de noviembre de 2020
Acceso de usuario a la cuenta	El token de autorización está disponible para un usuario administrador en el panel de control.