Obtener datos sin procesar desde la API

Premium
Para:
Marketers
Última actualización:

Resumen: Utilice esta API para obtener informes de datos sin procesar en archivos CSV.

altPullAPIRaw_us-es.pngalt

Obtener datos sin procesar desde la API

  • Pull API permite obtener informes de datos sin procesar en archivos CSV. Más información sobre los informes de datos sin procesar
  • Filtrar según las opciones disponibles: Fuente de medios, rango de fechas, nombre del evento dentro de la aplicación y geografía. 
  • Otras funciones adicionales de Pull API son:
    • Seleccionar moneda
    • Seleccionar zona horaria

Informes de datos sin procesar disponibles a través de Pull API

Informe Descripción Frecuencia de actualización
Informes de datos sin procesar (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 dentro de la aplicación Registra los eventos realizados por los usuarios.
 En tiempo real
Desinstalaciones Registra cuándo un usuario desinstala la aplicación.
 Diariamente
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
Informes de datos brutos (orgánicos)
Instalaciones orgánicas
 Registra cuándo un usuario abre la aplicación por primera vez.
 Continuo
Eventos orgánicos dentro de la aplicación
 Registra detalles sobre los eventos realizados por los usuarios.
 Continuo
Desinstalaciones orgánicas
 Registra a los usuarios que desinstalan la aplicación.
 Diariamente
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.
 Diariamente
Reorientación
Conversiones Registro de un usuario que abre la aplicación después de participar en una campaña de retargeting. En tiempo real
Eventos dentro de la aplicación Eventos dentro de la aplicación realizados por el usuario durante la ventana de reactivación. En tiempo real
Datos brutos 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
Protect360 contra el fraude
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 dentro de la aplicación provenientes de instalaciones fraudulentas y, por lo tanto, no se atribuyen en absoluto. En tiempo real
Eventos dentro de la aplicación Registra eventos dentro de la aplicación identificados como fraudulentos por Protect360. A diario
Eventos en la aplicación posteriores a la atribución Registra eventos dentro de la aplicación 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
Devoluciones de mensajes
Instalar postbacks Registra los eventos de instalación generados cuando un usuario abre la aplicación por primera vez. A diario
Devoluciones de eventos en la aplicación Registra las devoluciones de eventos dentro de la aplicación enviadas a la fuente de medios. A diario
Redireccionamiento de postbacks de eventos dentro de la aplicación Registra los eventos dentro de la aplicación que los usuarios realizaron durante la ventana de reactivación. En tiempo real
Postbacks de conversiones de redireccionamiento Registra los eventos dentro de la aplicación que los usuarios realizaron durante la ventana de reactivación. En tiempo real

Uso de datos sin procesar de Pull API

Para utilizar los datos sin procesar de Pull API:

  1. AppsFlyerAdmin_us-en.pngConsiga el token de API. Un administrador necesita recuperar el token.
  2. Suministre a su desarrollador el token de API que se usará en el encabezado de autenticación.
  3. Proporcione a sus desarrolladores los parámetros que deben introducir al hacer la llamada API, como se describe en las secciones que siguen. Los parámetros determinan en qué se centra el informe, cómo se organiza y proporcionan un marco temporal para el informe.
  4. Indique a su desarrollador que siga las instrucciones de los datos sin procesar de la API en el centro para desarrolladores.

Parámetros

Parámetro Descripción
desde
  • El rango de fechas consta de parámetros y . Las fechas se relacionan con la fecha de la actividad.
  • Formato: , o 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 informes de datos sin procesar).
a Fecha de finalización. En cuanto a fromfrom

fuente de medios

media_source: Para limitar (filtrar) la llamada a una fuente de medios específica.

Establezca los parámetros y de la siguiente manera:

  • Para los anuncios de Meta, configure la categoría y la fuente de medios en facebook
  • Para los anuncios X, configure la categoría y la fuente de medios en twitter
  • Para todas las demás fuentes de medios, establezca la categoría en estándar y la fuente de medios en el nombre de la fuente de medios.
  • Ejemplos
máximo de filas

Número máximo de filas devueltas por una única llamada 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.
nombre_del_evento

Filtrar eventos dentro de la aplicación por eventos específicos. Seleccione múltiples eventos utilizando una lista separada por comas.

Ejemplo:  
reasignación

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:
campos adicionales

Para obtener campos adicionales además de los campos predeterminados.

Ejemplo:

moneda

Moneda de los ingresos y los costes

Ejemplo: Si la moneda específica de la aplicación es EUR, al enviar currency=preferred los valores se devuelven en EUR.
zona horaria

[Predeterminado] Los datos se devuelven utilizando UTC.

  •  timezone=[Numerical value]
  • Ejemplo: Para la zona horaria UTC+10:00 utilice 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 API.

Ejemplo:

desde el momento de la instalación
  • El rango de fechas consta de parámetros y . Las fechas se relacionan con la fecha de la actividad.
  • Formato:
  • Ejemplo: 1 de enero de 2010
hasta_la_hora_de_instalación

Fecha de finalización. En cuanto a

agencia

Para limitar (filtrar) la llamada a una agencia específica.

Campos Protect360

Consulte la guía de datos sin procesar de Protect360

Campos de marco temporal

Si los resultados de la API superan el máximo, divida el informe 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 inclusive
  • 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 300 000 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. Consulte la tabla a continuación para ver las opciones. 

Llamada API De  A 
Primera llamada a la API

desde=aaaa-mm-dd

Ejemplo:

  • de=
  • Comienza en esta fecha al comienzo del día a las 00:00

a=aaaa-mm-dd 12:00

Ejemplo:

  • a=
  • Continúa hasta las 11:59:59, no hasta las 12:00

Opción A: Segunda llamada a la API 

 

Ejemplo:

  • 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=
  • Comienza desde las 12:00 e incluye las 12:00

a=aaaa-mm-dd

Ejemplo:

  • a=
  • Termina a medianoche
Opción B: Segunda llamada a la API

desde=aaaa-mm-dd 12:00

Ejemplo:

  • de=
  • 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=
  • 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 informe no se añaden a la lista predeterminada para que los nuevos campos no afecten tus procesos de importación e ingesta existentes. Utiliza el parámetro additional_fields para obtener campos no predeterminados.

Campos predeterminados

Campos predeterminados de la API de extracción
Tipo de toque atribuido
Tiempo de toque atribuido
Tiempo de instalación
Hora del evento
Nombre del evento
Valor del evento
Ingresos por eventos
Moneda de ingresos por eventos
Ingresos por eventos en USD
Fuente del evento
¿Está validado el recibo?
Socio
Fuente de medios
Canal
Palabras clave
Campaña
ID de campaña
Conjunto de anuncios
ID del conjunto de anuncios
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
Colaborador 1 Socio
Colaborador 1 Fuente de medios
Campaña del colaborador 1
Colaborador 1 Tipo táctil
Colaborador 1 Touch Time
Colaborador 2 Socio
Colaborador 2 Fuente de medios
Campaña del colaborador 2
Colaborador 2 Tipo táctil
Colaborador 2 Touch Time
Colaborador 3 Socio
Colaborador 3 Fuente de medios
Campaña del colaborador 3
Colaborador 3 Tipo táctil
Colaborador 3 Touch Time
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 reenganche
¿Es atribución primaria?
Agente de usuario
Referrer HTTP
URL original

Información adicional

Rasgos y limitaciones

Rasgo Comentarios 
Tipo de token API requerido AppsFlyerAdmin_us-en.pngToken V2.0
Acceso a la red publicitaria No
Acceso a la agencia Sí
Transparencia de la agencia Sí. No obstante, tenga en cuenta que si utiliza 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í
Actualidad de los datos
  • Equivalente a la disponibilidad de datos en el panel de resumen.
  • Informes actualizados con un retraso de algunas horas:
    • Eventos orgánicos dentro de la aplicación
  • Informes actualizados diariamente:
    • Desinstalaciones
    • Eventos en la aplicación 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 datos en bruto. 
Limitaciones de tamaño
  • Las llamadas a la API devuelven un máximo de 200K/1M filas.
  • Si un informe tiene exactamente 200K/1M filas, entonces es probable que falten filas.
  • Utilice el parámetro maximum_rows para seleccionar el número máximo de filas.
  • Realice múltiples llamadas a la API, utilizando los parámetros desde/hasta que incluyan la hora del día.
Fecha de instalación desde y fecha de instalación hasta 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 informe no contiene los datos esperados según el rango de tiempo seleccionado o hay una discrepancia entre el informe de datos en bruto y el informe de datos agregados. 

Verifique que haya configurado el parámetro timezone. De no hacerlo, los datos se envían utilizando UTC en lugar de la zona horaria de su aplicación. 

Véase también