Datos agregados de Pull API

Para:

Marketers Desarrolladores

Última actualización: 29 de mayo de 2023 08:38

De un vistazo: Usa esta Pull API para obtener tus reportes de estadísticas agregadas de AppsFlyer en archivos CSV.

¿Buscas el raw data de Pull API?

Puedes obtener más información al respecto aquí.

Datos agregados de Pull API

La Pull API te permite obtener reportes de datos agregados para la adquisición de usuarios (UA) y el retargeting en archivos CSV.
Las tasas de actualización de datos son las mismas que las del reporte equivalente en la página Datos exportados y la página del panel de control general. Ten en cuenta que el costo puede actualizarse con un retraso de varias horas, en función del partner que proporcione los datos de costos.
Filtrar por opciones disponibles: fuente de medios e intervalo de fechas.
Las capacidades adicionales en la Pull API son las siguientes:
- Agregar tipo de toque de atribución
- Seleccionar la zona horaria

Reportes agregados de rendimiento disponibles a través de Pull API

Categoría	UA	Retargeting*
Partners (fuente de medios)	✓	✓
Partners por fecha	✓	✓
Diario	✓	✓
Geolocalización	✓	✓
Reporte de Geolocalización por Fecha	✓	✓
* Para los reportes de retargeting, agrega `&reattr=true` al URI.

Lectura relacionada:

Uso de datos agregados de Pull API

Para utilizar los datos agregados de la Pull API:

Obtén el token de API. Un administrador deberá recuperar el token.
Dale a tu desarrollador el token de API que se utilizará en el encabezado de autenticación.
Proporciona a tus desarrolladores los parámetros que deben introducir cuando realicen la llamada a la API, como se describe en la sección que sigue. 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.
Dile a tu desarrollador que siga sus instrucciones de datos agregados de Pull API en el centro de desarrolladores.

Parámetros

Parámetro	Descripción
app_id	ID de aplicación
desde	El rango de fechas consiste en los parámetros `from`y `to`. El rango es el rango de valor de vida útil (LTV), que es la fecha de instalación. Formato: `yyyy-mm-dd`, Ejemplo: 2010-01-01
hasta	Fecha de finalización. Igual que para `from`
media_source	Usar para limitar (filtrar) a una fuente de medios específica. Ejemplo: `media_source=facebook`
attribution_touch_type	Configura este parámetro tal como se muestra en el ejemplo para obtener KPI de atribución por impresiones (VTA). Ejemplo: `attribution_touch_type=impression` Algunos KPI de VTA, como los clics, las impresiones y las API de costos, no tienen valores asociados y, en cambio, muestran el valor N/A.
moneda	Divisa de ingresos y costos. Los reportes agregados de la Pull API siempre usan la divisa específica de la aplicación.
reattr	Obtener datos de conversión de retargeting. [Predeterminado] Si es falso, las campañas de datos de adquisición de usuarios (UA) vuelven. Si es "true", la conversión de retargeting regresa. Ejemplo:`reattr=true`
Zona horaria	[Predeterminado] Los datos se devuelven utilizando UTC. Las plantillas de URI se rellenan con el parámetro de zona horaria establecido en la zona horaria específica de la aplicación. [Predeterminado] Si el parámetro no se envía, los datos regresan usando UTC. Si envías `timezone=[Joda-Time]`, los datos se devuelven utilizando la zona horaria específica de la aplicación. Notas sobre la selección de zonas horarias El formato de zona horaria Joda-Time tiene en cuenta el horario de verano. El valor de Joda-Time debe ser idéntico al valor definido en la página de configuración de la aplicación. Por ejemplo, si la zona horaria seleccionada en la configuración es París, el valor de la zona horaria de la URL de la Pull API debe ser `timezone=Europe%2fParis`. La extracción de datos en la zona horaria seleccionada solo está disponible a partir de la fecha en la que se configuró la zona horaria. Cualquier dato anterior a la fecha del cambio usa UTC como la zona horaria.

Rasgos y limitaciones

Característica	Comentarios
Se requiere el tipo de token de la API	Token V2.0
Acceso a la red de publicidad	N
Acceso de agencias	Y
Transparencia de Agencias	Y
Divisa específica de la aplicación	Y
Zona horaria específica de la aplicación	Y
Costo	Los datos de costos son solo para campañas de UA; no son para retargeting o campañas inactivas (campañas sin instalaciones).
Actualización de los datos	Continua
Historial de datos	5 años
Datos no orgánicos	Y
datos orgánicos	Y
Limitaciones de velocidad	Limitación
Limitaciones de tamaño	Las llamadas de la API devuelven un máximo de 200 000 filas. Si un reporte tiene exactamente 200 000 filas, entonces asume que faltan filas. Realiza múltiples llamadas a la API, utilizando los parámetros from/to que incluyan la hora del día. ¡Nota! Pull API para soporte de datos sin procesar 1 millón de filas. Los reportes de datos agregados están limitados a 200 000 filas.
Cambios del nombre de campaña	Los reportes de la Pull API no admiten cambios del nombre de campaña