API del reporte de rendimiento agregado de SKAN

En resumen: Rendimiento de SKAN enriquecido con puntos de datos adicionales. Similar a los datos en el dashboard de SKAdNetwork. Agrega utilizando la fecha de instalación o la fecha de llegada del postback.

API del reporte de rendimiento agregado de SKAN

La API devuelve métricas de atribución informadas por el SKAdNetwork de Apple (datos reales) y otros puntos de datos utilizando la fecha de llegada de instalación o postbacks. El reporte es similar en estructura a los datos presentados en eldashboard SKAN.

API del reporte de rendimiento agregado de SKAN

Para utilizar la API del reporte de rendimiento agregado de SKAN:

  1. Obtén el token de API. Un administrador necesita recuperar el token.
  2. Entrega a tu desarrollador el token API que se utilizará en el encabezado de autenticación.
  3. Proporciona a tus desarrolladores los parámetros que deben ingresar cuando realicen la llamada a la API, como se describe en la sección siguiente. Los parámetros determinan en qué se enfoca el reporte, cómo se organiza y proporcionan un marco de tiempo para la presentación de reportes.
  4. Dile a tu desarrollador que siga su API de reporte de rendimiento agregado de SKAN en el centro de desarrolladores.

Parámetros

Nombre de parámetro Formato Obligatorio

date_type

El tipo de fecha utilizado en el rango de fechas delimitado por start_date y end_date

Opciones: 

  • [Predeterminado] install: La fecha de instalación obtenida por AppsFlyer utilizando la hora de llegada del postback y después de considerar el período de medición.
  • arrival: La hora de llegada del postback. Nota: Las métricas de instalación orgánica tienen el valor N/A. 

Datos de Google Ads: Las fechas de instalación y llegada son las mismas debido a la metodología de reportes de Google Ads. 

No

start_date

 

El intervalo de fechas de instalación está limitado por la fecha de inicio y la fecha de finalización. Nota: La fecha de instalación difiere de la fecha de llegada del postback. 

  • Fecha de instalación más temprana con formato AAAA-MM-DD 
  • Fecha más temprana permitida: 2020-11-01
    Ejemplo: 2020-11-05
end_date
  • Fecha de instalación más reciente con formato AAAA-MM-DD
  • Número máximo de días por llamada de reporte: 90 días 
  • Ejemplo: 2020-11-12
view_type

Filtra las instalaciones por tipo de la siguiente manera: 

  • acquisition: Instalaciones 
  • retargeting: [PLEASE TRANSLATE]
  • unified: Adquisición y redescargas combinadas.
  • [Predeterminado] unified
  • Las métricas de costos, clics e impresiones regresan cuando view_type=unified

No

modeled_conversion_values
  • Sólo disponible a partir de V2
  • El valor puede ser true o false
  • Si es verdadero, el postback incluye los datos modelados al completar las columnas de métricas decodificadas. Ver campos disponibles
  • Si false, el postback presenta datos decodificados tal como se recibieron mediante postbacks SKAN sin procesar, sin datos modelados.
  • El valor predeterminado es false.

No

Estructura del informe y ejemplo.

La API devuelve un archivo CSV.

  • Los campos y métricas disponibles en el reporte se enumeran en la siguiente tabla. 
  • Algunas métricas (ingresos, engagement, conversión) dependen de la configuración de medición del desempeño de SKAN.
  • El reporte incluye solo los eventos in-app que realizaron los usuarios durante el período del reporte. Como tal, el número y la secuencia de las columnas de eventos in-app pueden cambiar de un reporte a otro. No confíes en la secuencia de columnas al diseñar tu proceso de importación de datos.
  • Ejemplos: V1 | V2

Campos de reporte

Nombre de campo Dimensión o métrica Disponible con token API V1  Disponible con token API V2

Disponible con token API V2 (para SKAN 4)

Disponible con filtro solo de datos modelados

Fecha 

Los datos son según el data_type seleccionado.

Dimensión N Y Y Y
Fuente de medios (pid) Dimensión Y Y Y Y
Campaña (c)

Dimensión

Y

Y

Y

Y

ID de campaña Dimensión Y Y Y Y
ID de sitio Dimensión Y Y Y N
Conjunto de anuncios Dimensión N Y Y Y
ID de conjunto de anuncios Dimensión N Y Y Y
Anuncio Dimensión N Y Y N
ID de anuncio Dimensión N Y Y N
País Dimensión Y Y N

Bandera de atribución de AF

Consulta: guía SSOT

Dimensión N Y Y Y

Índice de secuencia de postback

Dimensión N N Y Y

Creatividad

Dimensión N N Y N

Canal

Dimensión N N Y N
Impresiones Métrica Y Y Y Y
Clics Métrica Y Y Y Y
CTR Métrica Y Y Y Y
Instalaciones Métrica Y Y Y Y

Click Through Installs (fidelity_type = 1)

Métrica Y Y Y Y

View Through Installs

(fidelity_type = 0)

Métrica Y Y Y Y

Tasa de valor de conversión nulo

[Disponible a partir del 23 de enero de 2022] 

Métrica N Y Y Y
Tasa de Conversión Métrica Y Y Y Y
Usuarios convertidos Métrica Y Y Y Y
Usuarios convertidos/instalaciones Métrica Y Y Y Y
Ingresos totales Métrica de ingresos Y Y Y Y
Costo total Métrica Y Y Y Y
ROI Métrica de ingresos Y Y Y Y
ARPU Métrica de ingresos Y Y Y Y
eCPI promedio Métrica Y Y Y Y
{af_skad_revenue} (Unique users) Métrica de ingresos Y Y Y Y
{af_skad_revenue} (Contador de eventos) Métrica de ingresos Y Y Y Y

{nombre de tu evento in-app} (usuarios únicos) 

Métrica Y Y Y Y
{el nombre de tu evento in-app} (contador de eventos)  Métrica Y Y Y Y

Especificaciones y limitaciones

Espec Observaciones 
Calidad de los datos La disponibilidad de datos depende de la tasa de actualización de datos SKAN.
Rango de fechas
  • Al configurar el rango de fechas, la fecha más reciente debe ser la fecha actual, zona horaria UTC menos 3 días. Es decir, el 31 de marzo, utiliza el 28 de marzo. 
  • Fecha más temprana admitida: 1 de noviembre de 2020
  • Rango máximo de consulta: 90 días
Límites de tasas
  • Las queries devuelven hasta 250.000 filas
  • 10 llamadas por minuto
SRN
  • Meta ads: los datos están disponibles. 
  • Google Ads: Las instalaciones se pueden registrar hasta 45 días después de la instalación debido a la metodología de tiempo de clic de Google. Siconsultas los datos de Google de los últimos 45 días todos los días, esto proporciona la cobertura necesaria para los datos de Google SKAN.
Acceso a la red publicitaria  Si es un partner de análisis, solicita permiso al anunciante.
Acceso de agencias No disponible
Zona horaria específica de la aplicación Solo UTC
Divisa específica de la aplicación  Siempre USD
Datos orgánicos Calculado como la diferencia entre todos los datos reportados por el SDK directamente a AppsFlyer menos los datos no orgánicos reportados por los postbacks de SKAN.
Datos no orgánicos Calculado utilizando los postbacks SKAN recibidos por AppsFlyer
Historial de datos Datos de conversión más antiguos (instalación o retarget) admitidos: 1 de noviembre de 2020
Acceso de usuario a la cuenta El token de autorización está disponible para un usuario administrador en el dashboard.
Costo total Es posible que la API de SKAN no incluya la métrica de costo total si la atribución regular (descripción general regular) contiene campañas de SKAN que en el nivel de granularidad más bajo (por ejemplo: anuncio, país o ID de sitio) tienen más de 50.000 filas.