Datos agregados de Pull API

Para:
Marketers Desarrolladores
Última actualización:

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

PullAPIAverage_us-en.png

 ¿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. 

Uso de datos agregados de Pull API 

Para utilizar los datos agregados de la Pull API:

  1. AppsFlyerAdmin_us-en.pngObtén el token de API. Un administrador deberá recuperar el token.
  2. Dale a tu desarrollador el token de API que se utilizará en el encabezado de autenticación.
  3. 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.
  4. 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 fromy 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 AppsFlyerAdmin_us-en.pngToken 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

Consulta también