Obtener raw data desde la Pull API

Premium

Para:

Marketers

Última actualización: 6 de agosto de 2025 15:51

Resumen: Utiliza esta API para obtener reportes de raw data en archivos CSV.

altPullAPIRaw_us-es.pngalt

Obtener raw data desde la Pull API

La Pull API permite obtener reportes de raw data en archivos CSV. Saber más sobre los reportes de raw data
Filtrar según las opciones disponibles: Fuente de medios, rango de fechas, nombre del evento in-app y geolocalización.
Otras funciones adicionales de Pull API son:
- Seleccionar moneda
- Seleccionar zona horaria

Reportes de raw data disponibles a través de la Pull API

Reporte	Descripción	Frecuencia de actualización
Reportes de raw data (no orgánicos)
Instalaciones	Registra instalaciones no orgánicas. El registro se genera cuando un usuario abre la aplicación por primera vez.	En tiempo real
Eventos in-app	Registra los eventos realizados por los usuarios.	En tiempo real
Desinstalaciones	Registra cuándo un usuario desinstala la aplicación.	A diario
Reinstalaciones	Registra a los usuarios que, después de desinstalar la aplicación, interactúan con una fuente de medios de UA y reinstalan la aplicación durante la ventana de reatribución.	En tiempo real
Reportes de raw data (orgánicos)
Instalaciones orgánicas	Registra cuándo un usuario abre la aplicación por primera vez.	Continuo
Eventos orgánicos in-app	Registra detalles sobre los eventos realizados por los usuarios.	Continuo
Desinstalaciones orgánicas	Registra a los usuarios que desinstalan la aplicación.	A diario
Reinstalaciones orgánicas	Registra los ingresos por publicidad de los usuarios atribuidos a una fuente de medios de redireccionamiento durante la ventana de reactivación.	A diario
Retargeting
Conversiones	Registro de un usuario que abre la aplicación después de participar en una campaña de retargeting.	En tiempo real
Eventos in-app	Eventos in-app realizados por el usuario durante la ventana de reactivación.	En tiempo real
Raw data de ingresos por publicidad
Ingresos por publicidad atribuida	Registra los ingresos por publicidad de los usuarios atribuidos a una fuente de medios.	A diario
Ingresos por publicidad orgánica	Registra los ingresos por publicidad de los usuarios no atribuidos a una fuente de medios.	A diario
Fraude en Protect360
Instalaciones	Registra las instalaciones que se identificaron como fraudulentas y, por lo tanto, no se atribuyeron a ninguna fuente de medios.	En tiempo real
Instalaciones posteriores a la atribución	Registra eventos in-app provenientes de instalaciones fraudulentas y, por lo tanto, no se atribuyen en absoluto.	En tiempo real
Eventos in-app	Registra eventos in-app identificados como fraudulentos por Protect360.	A diario
Eventos in-app posteriores a la atribución	Registra eventos in-app para instalaciones identificadas como fraudulentas después de ser atribuidas a una fuente de medios o juzgadas como fraudulentas sin tomar en cuenta la instalación en sí.	A diario
Clics	Registra los clics realizados por usuarios bloqueados por Protect360.	A diario
Postbacks de instalación bloqueados	Registra copias de postbacks enviados a una fuente de medios que resultaron en una instalación bloqueada.	En tiempo real
Postbacks
Postbacks de instalaciones	Registra los eventos de instalación generados cuando un usuario abre la aplicación por primera vez.	A diario
Postbacks de eventos in-app	Registra los postbacks de eventos in-app enviados a la fuente de medios.	A diario
Redireccionamiento de postbacks de eventos in-app	Registra los eventos in-app que los usuarios realizaron durante la ventana de reactivación.	En tiempo real
Postbacks de conversiones de redireccionamiento	Registra los eventos in-app que los usuarios realizaron durante la ventana de reactivación.	En tiempo real

Uso de raw data de la Pull API

Para utilizar los raw data de Pull API:

Consigue el token de la API. Un administrador necesita recuperar el token.
Proporciona a tu desarrollador el token de la API que se usará en el encabezado de autenticación.
Proporciona a tus desarrolladores los parámetros que deben introducir al hacer la llamada a la API, como se describe en las secciones a seguir. Los parámetros determinan en qué se centra el reporte, cómo se organiza y proporcionan un marco temporal para el reporte.
Dile a tu desarrollador que siga las instrucciones de los raw data de la API en el centro para desarrolladores.

Parámetros

Parámetro	Descripción
desde	El rango de fechas consta de parámetros `from`y `to`. Las fechas se relacionan con la fecha de la actividad. Formato: `yyyy-mm-dd`, `yyyy-mm-dd hh:mm`, o `yyyy-mm-dd hh:mm:ss` Nota: El espacio debe codificarse como se muestra aquí `from=2020-04-01%2001:00:00`. Generalmente, los navegadores lo codificarán. Ejemplo: 01-01-2010 o 01-01-2010 20:15 (Parámetros de horas y minutos disponibles para reportes de raw data).
a	Fecha de finalización. En cuanto a `from`
media_source	`media_source`: Para limitar (filtrar) la llamada a una fuente de medios específica. Establece los parámetros `media_source` y `category` de la siguiente manera: Para Meta Ads, configura la categoría y la fuente de medios en facebook Para X Ads, configura la categoría y la fuente de medios en twitter Para todas las demás fuentes de medios, establece la categoría en estándar y la fuente de medios en el nombre de la fuente de medios. Ejemplos `media_source=facebook&category=facebook` `media_source=abc_example&category=standard`
maximum_rows	Número máximo de filas devueltas por una única llamada a la API. [Predeterminado] si no se envía ningún valor, hasta 200K filas 200000: Se devuelven hasta 200K filas 1000000: Se devuelven hasta 1 millón de filas Ejemplo: habilita hasta 1 millón de filas.
event_name	Filtrar eventos in-app por eventos específicos. Selecciona múltiples eventos utilizando una lista separada por comas. Ejemplo: `event_name=af_purchase,ftd`
reattr	Establecer datos de atribución de retargeting. [Predeterminado] Si es falso, se devuelven las campañas de adquisición de usuarios (UA). Si es verdadero, se devuelven los datos de atribución de retargeting. Ejemplo:`reattr=true`
additional_fields	Para obtener campos adicionales además de los campos predeterminados. Ejemplo:
currency	Moneda de los ingresos y los costos [Predeterminado] Si no se envía el parámetro, los datos se devuelven como USD. Es decir, no hacer nada y los resultados se muestran en USD. Si la envías, `currency=preferred`la moneda específica de la aplicación se usará. Es decir, la moneda establecida en la configuración de la aplicación. Ejemplo: Si la moneda específica de la aplicación es EUR, al enviar `currency=preferred` los valores se devuelven en EUR.
timezone	[Predeterminado] Los datos se devuelven utilizando UTC. Para obtener datos en la zona horaria específica de la aplicación, agrega `timezone`como se muestra en esta sección a la llamada: `timezone=[Numerical value]` Ejemplo: Para la zona horaria UTC+10:00 utiliza`timezone=+10:00` Nota: Es necesario codificar `+`, `-`, y `:`. Ejemplo: +10:00 codifica a `%2B10%3A00`
geo	Filtrar los datos por código de país. Limitación: Solo puedes configurar un filtro de código de país por llamada a la API. Ejemplo: `geo=ZA`
from_install time	El rango de fechas consta de parámetros `from`y `to`. Las fechas se relacionan con la fecha de la actividad. Formato: Ejemplo: 01-01-2010
to_install_time	Fecha de finalización. En cuanto a `from_install time`
agency	Para limitar (filtrar) la llamada a una agencia específica.

Campos de Protect360

Consulta la guía de raw data de Protect360

Campos de marco temporal

Si los resultados de la API superan el máximo, divide el reporte utilizando horas y minutos. Aplica lo siguiente:

desde/hasta: aaaa-mm-dd hh:mm
de:
- Solo fecha = desde el inicio (00:00) de la fecha elegida
- Fecha y hora = desde las 00:00
Parámetro a:
- Solo fecha = hasta el final (24:00) del día elegido
- Fecha y hora = hasta, pero sin incluir, la hora mostrada

Ejemplo: El propietario de una aplicación alcanza 1.300K instalaciones diarias de todas las fuentes. Para superar el límite de 1 millón de filas, el propietario de la aplicación divide el día en dos llamadas URI de 12 horas. Consulta la tabla a continuación para ver las opciones.

Llamada a la API De A

Primera llamada a la API

desde=aaaa-mm-dd

Ejemplo:

de=2019-12-29
Comienza en esta fecha al comienzo del día a las 00:00

a=aaaa-mm-dd 12:00

Ejemplo:

a=2019-12-29 12:00
Continúa hasta las 11:59:59, no hasta las 12:00

Opción A: Segunda llamada a la API

Ejemplo:

&from=2019-12-29 12:00&to=2019-12-29

Comienza el mediodía del 29 de diciembre de 2019
Finaliza a medianoche el 29 de diciembre de 2019

desde=aaaa-mm-dd 12:00

Ejemplo:

de=2019-12-29 12:00
Comienza desde las 12:00 e incluye las 12:00

a=aaaa-mm-dd

Ejemplo:

a=2019-12-29
Termina a medianoche

Opción B: Segunda llamada a la API

desde=aaaa-mm-dd 12:00

Ejemplo:

de=2019-12-29 12:00
Comienza desde las 12:00 e incluye las 12:00

a=aaaa-mm-dd+1 00:00

+1 = día siguiente a las 00:00

Ejemplo:

a=2019-12-30 00:00
Es decir, antes de que haya transcurrido cualquier tiempo el 30 de diciembre.

Nota: Utiliza la opción A o B ya que tienen los mismos resultados.

Campos adicionales

Los campos adicionales del reporte no se añaden a la lista predeterminada para que los nuevos campos no afecten tus procesos de importación y adquisición existentes. Utiliza el parámetro additional_fields para obtener campos no predeterminados.

Enumera un campo solo una vez.
Consulta la lista de campos disponibles.
Ejemplo:

Campos predeterminados

Campos predeterminados de la Pull API
Tipo de toque atribuido
Tiempo de toque atribuido
Tiempo de instalación
Hora del evento
Nombre del evento
Valor del evento
Ingresos del evento
Moneda de ingresos del evento
Ingresos del eventos en USD
Fuente del evento
Recibo validado
Partner
Fuente de medios
Canal
Palabras clave
Campaña
ID de campaña
Adset
Adset ID
Anuncio
ID del anuncio
Tipo de anuncio
ID del sitio
ID del subsitio
Subparámetro 1
Subparámetro 2
Subparámetro 3
Subparámetro 4
Subparámetro 5
Modelo de costos
Valor del costo
Moneda de costo
Partner del Colaborador 1
Fuente de medios del Colaborador 1
Campaña del Colaborador 1
Tipo de toque del Colaborador 1
Tiempo de toque del Colaborador 1
Partner del Colaborador 2
Fuente de medios del Colaborador 2
Campaña del Colaborador 2
Tipo de toque del Colaborador 2
Tiempo de toque del Colaborador 2
Partner del Colaborador 3
Fuente de medios del Colaborador 3
Campaña del Colaborador 3
Tipo de toque del Colaborador 3
Tiempo de toque del Colaborador 3
Región
Código del país
Estado
Ciudad
Código Postal
DMA
IP
WIFI
Operador
Carrier
Idioma
ID de AppsFlyer
ID de publicidad
IDFA
ID de Android
ID de usuario del cliente
IMEI
IDFV
Plataforma
Tipo de dispositivo
Versión del sistema operativo
Versión de la aplicación
Versión del SDK
ID de la aplicación
Nombre de la aplicación
ID del paquete
Es retargeting
Tipo de conversión de retargeting
Periodo de atribución
Ventana de re-engagement
Es atribución primaria
Agente de usuario
HTTP Referrer
URL original

Información adicional

Características y limitaciones

Rasgo	Comentarios
Tipo de token API requerido	Token V2.0
Acceso a la ad network	No
Acceso a la agencia	Sí
Transparencia de la agencia	Sí. No obstante, ten en cuenta que si utilizas filtros de agencia junto con los de fuente de medios, estos últimos no se aplican a agencias no transparentes. Esto implica que para agencias no transparentes se incluyen todos los datos, y no solo los de las fuentes de medios filtradas.
Moneda específica de la aplicación	Sí
Zona horaria específica de la aplicación	Sí
Datos actualizados	Equivalente a la disponibilidad de datos en el dashboard general. Reportes actualizados con un retraso de algunas horas: Eventos orgánicos in-app Reportes actualizados diariamente: Desinstalaciones Eventos in-app posteriores a la atribución Ingresos por publicidad
Datos históricos	Sí. De acuerdo con las políticas de retención y limitación de tasa.
Datos no orgánicos	Sí
Datos orgánicos	Sí
Limitación de tasa	Limitaciones de la API para raw data.
Limitaciones de tamaño	Las llamadas a la API devuelven un máximo de 200K/1M filas. Si un reporte tiene exactamente 200K/1M filas, entonces es probable que falten filas. Utiliza el parámetro maximum_rows para seleccionar el número máximo de filas. Realiza múltiples llamadas a la API, utilizando los parámetros desde/hasta que incluyan la hora del día.
Install_date_from and install_date_to	El rango de fechas de instalación debe ser anterior al rango de fechas de la actividad.

Resolución de problemas

Síntoma/mensaje	Solución
El reporte no contiene los datos esperados según el rango de tiempo seleccionado o hay una discrepancia entre el reporte de raw data y el reporte de datos agregados.	Verifica que hayas configurado el parámetro `timezone`. De no hacerlo, los datos se envían utilizando UTC en lugar de la zona horaria de tu aplicación.