Diccionario de campo de raw data (especificación V5.0)

De un vistazo: El diccionario de campos de datos (especificación de raw data) contiene los campos que se encuentran en los reportes de raw data.

Campos de fecha en archivos de formato CSV: los campos de fecha en los archivos en formato CSV tienen el formato aaaa-mm-dd. Cuando abres un archivo CSV en Excel, los campos de fecha se formatean según la configuración de fecha y hora de tu computadora. Asegúrate de seleccionar el formato de visualización de fecha adecuado en Excel.

Sobre el diccionario de raw data

Las columnas del diccionario son las siguientes: 

  • Nombre de la API: nombre utilizado por Push API y Data Locker.
  • Nombre para mostrar: nombre de campo utilizado en reportes, como CSV, Pull API.
  • Fuente: la ubicación de la fuente original del contenido del campo es la siguiente:
  • Descripción
    • Algunos campos tienen significados diferentes según el contexto del evento. El significado es el resultado de una campaña de UA o de retargeting.
  • Contexto: cuando un campo está disponible en reportes específicos o tiene un significado ligeramente diferente según el contexto del reporte, esto se indica aquí de la siguiente manera:
    • Retargeting: estos campos tienen un significado específico en el contexto de una campaña de retargeting.
    • Data Locker: disponible solo en Data Locker.
    • Protect360: disponible solo en reportes de Protect360.
    • Campos agregados después de diciembre de 2019, la fecha en que se agregó el campo.
  • Tipo de campo y longitud:
    • Secuencia: la longitud máxima de la secuencia. Por lo general, no aplicamos limitaciones de longitud de campo al recibir los datos, pero los datos pueden truncarse como consecuencia de ella. No excedas la especificación de longitud de campo.
    • Fecha y hora: 
      • Secuencia con formato, aaaa-mm-dd hh:mm:ss. Por ejemplo, 2019-09-17 00:09:25La zona horaria utilizada para mostrar los datos depende de la herramienta de entrega de datos, tal como se muestra a continuación:
        • Página de datos exportados: zona horaria seleccionada por la aplicación.
        • Push API: los campos de hora tienen una opción selected_time_zone que significa zona horaria específica de la aplicación, de lo contrario UTC.
        • Mater API: El valor predeterminado es la zona horaria seleccionable de la aplicación.
        • Data Locker: UTC
      • Nota: Al abrir archivos CSV con Excel, el campo se muestra con la configuración regional predeterminada. Puedes cambiar el formato de visualización en Excel. Para ver el valor sin formato, abre el archivo con un editor.
      • Push API:
        • Para campos de marca de tiempo en UTC: formato aaaa-mm-dd hh:mm:ss.sssPor ejemplo, 2019-09-17 00:09:25.123 
        • Para campos de marca de tiempo en la zona horaria seleccionada: formato yyyy-mm-dd hh:mm:ss.sss±th:tm. Por ejemplo 2019-01-20 04:51:16.000+0000
    • Enum n char: los campos Enumeración solo pueden contener valores específicos. Por ejemplo, la divisa de costo tiene 3 caracteres y solo puede contener códigos de divisa tal como se especifica.
    • Enum 5 char boolean: el valor del campo puede ser TRUE (VERDADERO) o FALSE (FALSO).
    • Ejemplo de registro de instalación con formato csv

Campos de raw data

Nombre de parámetro de API

Nombre de campo

Fuente

Descripción


Contexto

Tipo de campo

af_ad

Anuncio

Link

   

String 100

af_ad_id

ID de anuncio

Link

   

String 24

af_ad_type

Tipo de anuncio

Link

Tipo de anuncio (pancarta, pie de página, etc.)

 

String 24

af_adset

Conjunto de anuncios

Link

   

String 100

af_adset_id

ID de conjunto de anuncios

Link

 

 

String 24

af_c_id

ID de campaña

Link

    String 24

af_channel

Canal

Link

Canal de la fuente de medios, por ejemplo: YouTube para Google, Instagram para Facebook   Dynamic Enum String 20

af_cost_
moneda*

Moneda de costo

Link

Divisa de costo (lista)   Enum 3 char

af_cost_model

Modelo de costo

Link

CPC / CPI / CPM / Otro. Actualmente, todos los costos se calculan de acuerdo con el costo por instalación (CPI) independientemente del valor.

 

String 20

af_cost_value

Valor de costo

Link

Costo en divisa original. Admite hasta 4 dígitos después del separador decimal. Ejemplo: 320.5095   String 20

af_keywords

Palabras clave

Link

Recibido de la red de publicidad

 

String 100

af_attribution_
lookback

Atribución retrospectiva Link

UA: ventana retrospectiva para la atribución de clics. La duración de la ventana es el CTIT (tiempo del clic a la instalación) máximo para atribuir el nuevo usuario a la fuente que muestra el anuncio/enlace. Nota: El parámetro equivalente en el enlace de atribución es af_click_lookback.

Retargeting: ventana retrospectiva de retargeting por clics

 Retargeting

 

 

Máx. de 3 caracteres

af_prt

Partner

Link

Agencia o PMD

 

String 50

af_reengagement
_window

Ventana de recaptación

Link

La ventana de atribución de re-engagement es el período de tiempo durante el cual un evento puede atribuirse a una campaña de retargeting.

Limitación: el campo no se rellena en campañas de retargeting.

Retargeting Máx. de 3 caracteres

af_siteid

ID de sitio

Link

ID de anunciante   String 24

af_sub_siteid

ID de subsitio

Link

ID de subanunciante

 

String 50

af_sub1

Subparámetro 1

Link

Parámetro personalizado opcional definido por el anunciante   String 100

af_sub2

Subparámetro 2

Link

Parámetro personalizado opcional definido por el anunciante   String 100

af_sub3

Subparámetro 3

Link

Parámetro personalizado opcional definido por el anunciante   String 100

af_sub4

Subparámetro 4

Link

Parámetro personalizado opcional definido por el anunciante   String 100

af_sub5

Subparámetro 5

Link

Parámetro personalizado opcional definido por el anunciante   String 100

campaña

Campaña

Link

Nombre de la campaña

 

String 100

is_retargeting

Es retargeting

Link

UA: FALSO

Retargeting: VERDADERO para eventos y conversiones de retargeting

Retargeting

Enum 5 char boolean

media_source

Fuente de medios

Link

La fuente de medios atribuida a un evento o restringida

 

String 50

original_url

URL original

Link

UA: URL de clic/impresión utilizada

Si el enlace es un enlace de marca: el campo se rellena utilizando el enlace de marca.

Retargeting: contiene uno de los siguientes: enlace de retargeting, datos de enlace profundo, vacío para SRN.

Retargeting String 2083 (URL)

user_agent

Agente de usuario

Link

El agente del usuario de la URL   String 200

advertising_id

ID de publicidad

SDK

El ID de publicidad es un ID anónimo, exclusivo, que el usuario puede restablecer, para los anuncios provistos por Google Play Services (GAID).   String 40

android_id

ID de Android

SDK

ID de dispositivo de Android    String 20
app_id ID de aplicación

SDK

ID de aplicación:
  • iOS: id123456789
  • Android: com.appsflyer.referrersender
 

iOS: String 12

Android: String 100

app_name

Nombre de aplicación

SDK

Nombre de aplicación   String 100

app_version

Versión de aplicación

SDK

Versión de aplicación   Máx. de 8 caracteres

appsflyer_id

ID de AppsFlyer

SDK

UA: identificador exclusivo de instalación. Un ID exclusivo generado por AppsFlyer cuando la aplicación se inicia por primera vez. El ID es exclusivo por aplicación y por instalación. Esto significa que se asigna un ID nuevo si la aplicación se elimina y se instala nuevamente. Ver también el ID de usuario de cliente.

Retargeting:
Reatribución: se asigna un nuevo ID. Re-engagement: el ID permanece sin cambios. 

Retargeting

iOS: String 24

Android: String 33

bundle_id

ID de paquete

SDK

Identificación que coincide con una aplicación única o con un grupo de aplicaciones (para iOS)   String 100

proveedor

Carrier

SDK

El nombre del proveedor proporcionado por Android usando getSimCarrierIdName(). Ver también mapeo de proveedores .

  String 50

country_code

Código de país

SDK

Código de país con ISO 3166 (alfa-2) Ejemplo: US, CN.

El código del Reino Unido implementado es UK, no GB. 

  Enum String 2

custom_data

Datos personalizados

SDK

  • Datos que se envían mediante el SDK
  • Ver Android y iOS
  String 1024

CUSTOMER_USER_ID

ID de usuario de cliente

SDK

Un identificador único, establecido por el propietario de la aplicación.    String 100
deeplink_url

URL de enlace profundo

SDK

La ruta de una actividad interna de la aplicación con la que los usuarios estén conectados mediante enlaces profundos. Usa esto para enlaces profundos y enlaces profundos diferidos.

Disponible desde de enero de 2020

String 1024

device_category

Categoría de dispositivo

SDK

  • Entre los valores posibles, se incluyen: teléfono tableta, otros
  • Compatible con Android SDK V4.8.8 y superior
  String 20

device_type

Tipo de dispositivo

SDK

El nombre del modelo comercial del dispositivo. Ejemplo: SM-GM284 o iPhone7

 

String 100

device_download_
time

Device Download Time

SDK

Tiempo de finalización de la descarga de la aplicación utilizando el reloj del dispositivo (Android, iOS) y convertido a UTC. El valor siempre se muestra como hora UTC.

Formato: yyyy-mm-dd hh:mm:ss.sss

Disponible en Data Locker desde octubre de 2019. Disponible en general desde enero de 2020. -

event_name

eventName

SDK

Nombre del evento que tuvo lugar   String 100

event_revenue

Ingresos del evento

SDK

Monto de ingresos utilizando la Divisa de ingresos del evento.   String 20

event_revenue_

currency*

Divisa de ingresos del evento

SDK

La divisa de ingresos del evento tal como se reporta al SDK.   String 20

event_time

Hora del evento

SDK

UA: hora en la que tuvo lugar el evento.

Retargeting: es igual a la hora de instalación.

Retargeting Date Time

event_value

Valor del evento

SDK

Valor del evento

Nota: No envíes más de 1000 caracteres desde el SDK ya que, según el tipo de reporte, podemos truncarlos. 

  String 1000

idfa

Identificador de anunciante (IDFA)

SDK

iOS: ID de anunciante   Máx. de 40 caracteres

idfv

IDFV

SDK

Identificador en el nivel de la aplicación para un proveedor particular   Máx. de 40 caracteres

imei

IMEI

SDK

IMEI del dispositivo para Android y iOS   Máx. de 14 caracteres

install_app_store

Tienda de aplicaciones de la instalación

Link

Identifica la tienda de Android desde la que se descarga la aplicación (detalles)   String 50

install_time

Hora de instalación

SDK

UA: la hora del primer inicio después de la instalación.

Retargeting: el primer inicio de la aplicación después del re-engagement o la reatribución.

Retargeting

Date Time

ip

IP

SDK

Dirección IP   String 15 for IP V4

is_lat

Es LAT

SDK

Límite de rastreo de anuncios (LAT): cuando es verdadero, el usuario ha habilitado el LAT en su dispositivo y no hay ninguna identificación de anunciante disponible para AppsFlyer.  Desde enero de 2020 Enum 5 char boolean

language

language

SDK

Idioma del dispositivo   String 20

oaid

OAID

SDK

Android: ID de anunciante disponible en algunos dispositivos como alternativa o además de la ID de Android. Desde enero de 2020 Máx. de 40 caracteres

operador

Operator

SDK

El nombre del operador móvil derivado de la SIM MCCMNC disponible si el usuario está registrado en la red con Android getNetxworkOperatorName   String 50

os_version

Versión de SO

SDK

Versión del sistema operativo   String 8

platform

Plataforma

SDK

Valores posibles: iOS, Android o Windows Mobile

 

Enum string 8

sdk_version

Versión del SDK

SDK

Versión del SDK   String 8

wifi

WIFI

SDK

Verdadero/Falso

 

Enum 5 char boolean

store_reinstall

Reinstalación de la Apple Store

SDK

Para el tráfico generado por Apple Search Ads, el uso del ID de usuario de Apple determina si se trata de lo siguiente:

  • Falso: usuario nuevo
  • Verdadero: reinstalación por un usuario existente
Desde enero de 2020 Enum 5 char boolean

amazon_aid

ID de Amazon Fire.

SDK

ID de publicidad de Amazon

  String 100

CITY

CITY

AF

La ubicación más granular del usuario según el IP del dispositivo. Por lo general, el valor incluye el nombre de una ciudad, pero, además, puede incluir distritos, comunas, etc., que son más precisos.

 

String 100

attributed_touch_

time

Hora del toque atribuido

AF

UA: la hora a la cual atribuimos el toque.

Retargeting: hora de engagement de retargeting.

Retargeting

Date Time

attributed_touch_

Tipo

Tipo de toque atribuido

AF

UA: el tipo de toque atribuido por AppsFlyer. Valores posibles: clic/impresión/TV/preinstalada

Re-engagement: por clics o por impresiones (solo reatribuciones).

Retargeting

Enum 10 char max

contributor_1_

af_prt

Partner del colaborador 1

AF

Agencia o PMD,
siempre en minúscula

 

String 50

contributor_1_

campaña

Campaña del colaborador 1

AF

Campaña del colaborador   String 100

contributor_1_

match_type

Tipo de coincidencia del colaborador 1

AF

Los valores posibles incluyen:

gp_referrer, id_matching, srn

  String 50

contributor_1_

media_source

Fuente de medios del colaborador 1

AF

Fuente de medios del colaborador   String 50

contributor_1_

touch_time

Hora de toque del colaborador 1

AF

La hora del toque

 

Date Time

contributor_1_

touch_type

Tipo de toque del colaborador 1

AF

El tipo de toque

click, impression, TV

 

Enum 10 char max

contributor_2_af_
prt

Partner del colaborador 2

AF

Agencia o PMD   String 50

contributor_2_

campaña

Campaña del colaborador 2

AF

Campaña del colaborador   String 100

contributor_2_

match_type

Tipo de coincidencia del colaborador 2

AF

Los valores posibles incluyen:

gp_referrer/id_matching/srn

  String 50

contributor_2_

media_source

Fuente de medios del colaborador 2

AF

Fuente de medios del colaborador   String 50

contributor_2_

touch_time

Hora de toque del colaborador 2

AF

La hora del toque   Date Time

contributor_2_

touch_type

Tipo de toque del colaborador 2

AF

El tipo de toque

(puede ser clic/impresión/TV)

 

Enum 10 char max

contributor_3_af_
prt

Partner del colaborador 3

AF

Agencia o PMD   String 50

contributor_3_

campaña

Campaña del colaborador 3

AF

Campaña del colaborador   String 100

contributor_3_

match_type

Tipo de coincidencia del colaborador 3

AF

Los valores posibles incluyen:

gp_referrer/id_matching/srn

  String 50

contributor_3_

media_source

Fuente de medios del colaborador 3

AF

Fuente de medios del colaborador   String 50

contributor_3_

touch_time

Hora de toque del colaborador 3

AF

La hora del toque   Date Time

contributor_3_

touch_type

Tipo de toque del colaborador 3

AF

El tipo de toque

(puede ser clic/impresión/TV)

 

Enum 10 char max

dma

DMA

AF

Área de mercado designada: las regiones son áreas geográficas en los EE. UU. donde la empresa Nielsen mide los telespectadores locales.   String 10

event_revenue_usd

event_revenue_
selected_currency

 

Ingresos del evento en USD

Ingresos del evento preferida

Ingresos del evento XXX

AF

La cantidad de ingresos. La moneda dependerá de la herramienta utilizada para los reportes.

Preferida o seleccionada hacen referencia la moneda específica de la aplicación establecida en la configuración de la aplicación.

Data Locker: USD

Exportar página : moneda seleccionada 

Pull API seleccionable: USD o seleccionada usando &currency=preferred. 

Push API: siempre contiene ambos campos, USD y la moneda seleccionada

 

  String 20

event_source

Fuente del evento

AF

La fuente del evento, ya sea SDK o S2S   Enum 3 char max

http_referrer

Referente de HTTP

AF

Identifica la dirección de la página web que se enlaza a la URL de clic de AppsFlyer. Si revisa el referente, puede ver dónde se originó la solicitud.   String 2083 char max

is_primary_
attribution

Es atribución primaria

AF

UA: verdadero

Retargeting: en una ventana de re-engagement, podemos atribuir a la fuente de medios original (antes del re-engagement) o a la fuente de medios de re-engagement. Mientras el evento está dentro de la ventana de re-engagement. La fuente de medios original será FALSA (no la atribución principal). La fuente de medios de re-engagement será VERDADERA.

Retargeting

Enum 5 char max

is_receipt_
validated

Tiene validación de compras

AF

true/false/null cuando se implementa en el SDK; de lo contrario está vacío.

 

Enum 5 char max

match_type

Tipo de coincidencia

AF

Tipo de método de atribución. Los valores posibles incluyen:

gp_referrer (cadena de referente de Google Play)

id_matching

Fingerprinting

srn (red de autorreporte)

tv (atribución de TV)

preinstalación

  String 50

postal_code

Código postal

AF

Basado en el IP del SDK   Cadena: máx. de 10 caracteres

Región

Región

AF

Basado en el IP proveniente del SDK

 

String 100

retargeting_

conversion_type

Tipo de conversión de retargeting

AF

UA: N/A

Re-targeting: re-engagement, reatribución

Retargeting

 

Enum 14 char max

state

Estado

AF

Basado en el IP proveniente del SDK

 

String 100

keyword_id

ID de palabra clave

Link

ID de palabra clave devuelto por la red de publicidad. Este es el ID de af_keyword.   String 100

keyword_match_
type

Tipo de coincidencia de palabras clave

AF

El tipo de concordancia de palabra clave devuelto por API de redes de búsqueda o enlaces de atribución deberán asignarse al reporte de raw data.

Nota: Google AdWords y Apple Search Ads son las únicas redes que devuelven este parámetro para las campañas de búsqueda.

  String 100

network_
account_id

ID de cuenta de red

AF

ID de la cuenta del anunciante con el partner

 

String 100

rejected_reason_

value

Rejected Reason value

AF

En reportes de reglas de validación de targeting: ID del conjunto de reglas que causó el rechazo.

Validación de targeting

String 100

rejected_reason Rejected Reason AF En reportes de reglas de validación de targeting: el tipo de regla que causó el rechazo, p. ej., install-validation-rule Validación de targeting String 100
blocked_reason Blocked Reason AF En Protect360, la razón por la cual la instalación está bloqueada, p. ej.: install_hijacking, bots  Protect360  String 100
blocked_sub_
reason
Blocked Sub Reason AF

En Protect 360, el submotivo de una instalación bloqueada, p. ej.: Motivo: install_hijacking. Submotivo: secuestro de referente, CTCT_anomalies

Protect360  String 100

blocked_reason_

value

Blocked Reason Value AF Información adicional sobre el bloqueo, p. ej.: ID del sitio. Protect360  String 100

blocked_reason_

rule

Blocked Reason Rule AF Este campo quedará en desuso. Hasta entonces, el valor es siempre nulo.   Protect360  To be deprecated

gp_click_time

Hora de clic de Google Play

Campo de Google Play

Hora de carga de la página de la aplicación en Google Play después del clic en un anuncio.

Fuente de la hora: API de Google

Disponible con el SDK de Android versión 4.8.5

Ejemplo de caso de uso: al comparar install_time con gp_click time, puedes saber cuánto tardan los usuarios desde que comienzan a descargar la aplicación hasta que la abren. 

  Timestamp

gp_install_begin

Hora de inicio de la instalación de Google Play

Campo de Google Play

Hora a la que comienza la instalación 
Fuente de la hora: dispositivo del usuario. Significa la hora que aparece en el dispositivo. 

Nota:

Disponible con el SDK de Android versión 4.8.5

  Timestamp

gp_referrer

Google Play Referrer

Campo de Google Play

La URL del referente del paquete instalado.

Disponible con el SDK de Android versión 4.8.5

  String 1024

gp_broadcast_
referrer

Referente de transmisión de GP

Campo de Google Play

Referencia de retransmisión Google Play.

  String 1024

ad_unit

Ad unit

API de ingresos por publicidad

Tipo de anuncio

Ingresos por anuncios String 1024

segment

Segment

API de ingresos por publicidad

Nombre de ubicación del anuncio Ingresos por anuncios String 1024

monetization_network

Monetization network

API de ingresos por publicidad

Red que envía el anuncio

Ingresos por anuncios String 1024

Impresiones

Impresiones

API de ingresos por publicidad

Número de veces que el usuario vio el anuncio

Ingresos por anuncios String 1024

mediation_network

Mediation network

API de ingresos por publicidad

Red de mediación que informa el evento a AppsFlyer

Ingresos por anuncios String 1024

Ejemplo de registro de raw data de eventos in-app

Sample_v5_in_app_event.csv

Ejemplo de registro de raw data de eventos in-app
Nombre de campo value
WIFI Verdadero
Anuncio 101548
Conjunto de anuncios 18212447
ID de publicidad 452c96af-7dc8-4d4c-9579-example
ID de aplicación abc.example
Nombre de aplicación Ejemplo: La principal aplicación de compras en línea y ofertas
Versión de aplicación 4.0.11
ID de AppsFlyer 1570515992667-612279933540example
Hora del toque atribuido 2019-10-08 10:21.31
Tipo de toque atribuido Clic
Atribución retrospectiva 7d
ID de paquete abc.example
Campaña abc_ad_network_9999999
Carrier example-carrier
CITY Johannesburg
Modelo de costo CPI
Valor de costo 1900-01-00 07:12.00
Código de país ZA
ID de usuario de cliente abc123xyz
Categoría de dispositivo teléfono
Device Download Time 2019-10-07 19:52.23
Tipo de dispositivo vivo-vivo 1727
DMA Ninguna
eventName af_purchase
Ingresos del evento 100
Divisa de ingresos del evento ZAR
Ingresos del evento en USD 13
Fuente del evento SDK
Hora del evento 2020-02-23 20:40.17
Valor del evento {"af_content":"[{\"id\":\"99988089\",\"item_price\":100,\"quantity\":2}]",
"af_price":[100],"appsflyer_device_id":"99999992667-279933540example",
"af_order_id":"99998496842","af_receipt_id":"99998496842"
,"af_content_id":"99998089"],"af_content_type":"product",
"af_currency":"ZAR","af_revenue":100"af_description":["00008"],"af_quantity":[1],"af_param_1":"999963"}
Campo value
Hora de instalación 2019-10-08 13:26.41
IP 192.0.2.1.1
Es atribución primaria FALSE
Es retargeting FALSE
language English
Tipo de coincidencia id_matching
Fuente de medios abc_ad_network_int
Operator example-carrier
Versión de SO 9
Plataforma Android
Código postal 8100
Región AF 
Versión del SDK v5.1.1
ID de sitio abc.example_1099548_35281
Estado GAU
Subparámetro 1 99999
ID de subsitio 99999
Agente de usuario Dalvik/2.1.0 (Linux; U; Android 9; vivo 1727 Build/PKQ1.190118.001)
¿Fue útil este artículo?