Reportes de raw data de SKAN

Para:
Marketers
Última actualización:

De un vistazo: Los reportes de raw data de SKAN contienen datos a nivel de fila, generados después de traducir y decodificar los postbacks recibidos por AppsFlyer desde iOS, así como los postbacks de raw data de SKAN. Los datos están disponibles a través de Data Locker y Push API. Si tu plan de suscripción incluye raw data, no hay necesidad de una suscripción a Data Locker. 

Reportes de raw data de SKAN

Principios: 

  • Los datos son proporcionados por:
    • Data Locker
      • Nota: Disponible para cuentas que tengan una suscripción de raw data. Es decir, no hay necesidad de una suscripción a Data Locker. Si actualmente no estás usando Data Locker, un usuario administrador debe configurar Data Locker y habilitar los reportes de SKAN. Para ello, dirígete a Integración > Data Locker. Selecciona los reportes de SKAN. 
      • Tasa de actualización de datos: diaria. Los datos se incluyen en la carpeta h=23 de la fecha en que AppsFlyer recibe el postback. Ejemplo: si el postback se recibió el lunes, se procesa después del final del día. El procesamiento se completa antes de las 12:00 UTC del martes, y los datos se guardan en la carpeta h=23 del lunes. 
    • API push
  • Fecha de instalación: la calcula AppsFlyer a partir de la hora de llegada del postback, de la siguiente manera:
    • Si los postbacks son de SKAN V4, la fórmula para la fecha de instalación es: fecha de instalación = hora de llegada del postback - [duración de ventana acumulada] - [retraso promedio del postback].
      • Postback 1: fecha de instalación = hora de llegada del postback - 48 h - 36 h
      • Postback 2: fecha de instalación = hora de llegada del postback - 168 h - 84 h
      • Postback 3: fecha de instalación = hora de llegada del postback - 840 h - 84 h
    • Si los postbacks son de SKAN V3, la fórmula para la fecha de instalación es: fecha de instalación = hora de llegada del postback - 36 horas - [rango promedio de última actividad]. 
      • El [promedio del último rango activo] predeterminado es de 12 horas.
      • Para un valor de conversión de 0, el rango promedio de última actividad se establece en 0.
    • Google estima la hora de instalación por su cuenta y AppsFlyer utiliza esa hora de instalación. Nota: Google puede tardar hasta 13 días en reportar las instalaciones. Aprender más

Los tipos de reportes disponibles son:

  • Postback de dispositivo: 1 postback de dispositivo por cada instalación o redescarga recibida desde el dispositivo iOS.
  • Raw data de SKAN:
    • AppsFlyer decodifica y traduce el postback del dispositivo en registros de raw data.
    • Cada postback genera un registro de instalación o redescarga y registros de eventos in-app.
    • El número de registros de eventos in-app depende del valor de conversión (CV), de la siguiente manera:
      • CV = 0, en blanco o nulo: no se generan registros in-app. 
      • Rango de CV:
        • 1-63: para SKAN 3, y el valor preciso de la ventana 1 de SKAN 4, este es el número de registros in-app, en función de tus ajustes de medición.
        • Low, medium o high: para los valores aproximados de SKAN 4, este es el número de registros in-app, en función de tus ajustes de medición.

¿Por qué algunos campos están vacíos? Esto ocurre por cualquiera de las siguientes razones:

  • Campos de enriquecimiento no obligatorios como campaign_name, ad_network_campaign_id, ip que la red de publicidad no proporcionó.
  • Apple retuvo los datos debido a las políticas de umbral de Apple. Campos como source_app_id, skad_campaign_id, skad_conversion_value. 

Formato y contenido de los reportes de raw data de SKAN

Tipos de reportes de raw data

Tipo de reporte Nombre del reporte Descripción
Postback Postbacks

Postbacks enviados por iOS a la red de publicidad. El postback, después del enriquecimiento por parte de la red de publicidad, se reenvía a AppsFlyer. Descargar ejemplo de postbacks (CSV).

Nota: Los postbacks no se incluyen cuando did_win=false.

Nombre del tema en Data Locker: skad_postbacks
Postback Copia de postbacks (directa de Apple)

Postbacks enviados directamente por iOS a AppsFlyer.

Está disponible a partir de iOS 15+ y requiere que el anunciante configure la aplicación para enviar el postback ganador a AppsFlyer. Descargar ejemplo de copia de postbacks (CSV).

Nota: Este tema contiene solo postbacks ganadores. 

Nombre del tema en Data Locker: skad_postbacks_copy
Evento decodificado Instalaciones

Primeras instalaciones de aplicaciones

SKAN reportó redownload=false. Es decir que esta es la primera vez que el usuario, representado por el ID de Apple, descargó la aplicación.
Descargar ejemplo de instalaciones (CSV).

Nombre del tema en Data Locker: skad_installs
Evento decodificado [PLEASE TRANSLATE]

Instalaciones de aplicaciones que no son primeras instalaciones

SKAN reportó redownload=true. Es decir que esta no es la primera vez que el usuario, representado por el ID de Apple, descargó la aplicación. Este reporte tiene la misma estructura que las instalaciones.

Nombre del tema en Data Locker: skad_redownloads
Evento decodificado Eventos in-app

Eventos in-app

A partir del 21 de julio de 2021, hay cambios en la forma en que proporcionamos el raw data de los eventos in-app, como se detalla en las tablas. 

El número de registros de eventos in-app depende de tu configuración de la medición. 

Descargar ejemplo de eventos in-app (CSV).

Nombre del tema en Data Locker: skad_inapps

Válido para postbacks de iOS recibidos a partir del 21 de julio de 2021:

Tipo de medición Descripción
Ingresos
  • Ingresos de un usuario determinado. Si los ingresos son > 0, un registro contiene los campos skad_revenue y event_name.
  • Los campos min_revenue y max_revenue se rellenan con tus valores de rango de conversión personalizados.  
Eventos de conversión in-app y de embudo
  • Un registro para cada evento de conversión único realizado. El campo event_name se rellena en consecuencia. Si no se realizan eventos, no hay ningún registro.
  • Los eventos de conversión tienen min_event_counter = 0 y max_event_counter = 1. 
Engagement in-app  Para determinar el número de veces que un usuario realizó un evento in-app determinado, usa la fórmula [round up (min_event_counter + max_event_counter) / 2]

Válido para postbacks de iOS recibidos hasta el 20 de julio de 2021:

Tipo de medición Número de registros Descripción
Ingresos 0-1 Si los ingresos son > 0, un registro contiene los campos skad_revenue y event_name.
Conversión 

0-6

 Un registro para cada evento de conversión único realizado. El campo event_name se rellena en consecuencia. Si no se realizan eventos, no hay ningún registro.
continuo

0-63

 El número de registros representa el número de veces que el usuario realizó el evento de engagement. Si el usuario no se involucra, no hay registros de engagement.
Personalizado 0-ilimitado De acuerdo con tu esquema de conversión personalizado. 
Evento decodificado Dimensiones publicitarias de SRN 
  • El reporte contiene eventos de Anuncios de Meta con granularidad de campaña, conjunto de anuncios y anuncio. Cada fila del reporte puede ser una instalación o un evento in-app.
  • La granularidad de conjunto de anuncios y anuncio no se incluye en los postbacks de SKAN de Anuncios de Meta. Estos datos son exclusivos de este reporte y no se muestran en el panel de control de SKAN, la API de rendimiento y otros reportes de SKAN Data Locker.
  • El reporte es sin esquema. Las opciones de selección de campo de Data Locker no se aplican.
  • Práctica recomendada: No combines ni compares datos de este reporte con los de otros reportes de SKAN, ya que puede haber discrepancias entre este reporte, que utiliza datos decodificados por la SRN, y otros reportes, que utilizan datos decodificados por AppsFlyer. Estas discrepancias pueden deberse a diferencias de zona horaria, diferencias de esquema de la SRN o eventos in-app incorrectamente asignados a CV en la integración de la SRN.
  • Descargar ejemplo de dimensiones publicitarias de SRN (CSV).

Nombre del tema en Data Locker: skad_srn_advertising_dimensions

Tipos de formato de los campos de raw data

Formatos de campo

Nombre del formato Descripción
String [n]

La longitud máxima de la cadena. Por lo general, no aplicamos limitaciones de longitud de campo al recibir los datos, pero los datos pueden truncarse como consecuencia de ella.
Cadena de tiempo

Cadena que tiene el formato yyyy-mm-dd hh:mm:ss. Por ejemplo, 2019-09-17 00:09:25 
Enum [n] Los campos Enum solo pueden contener valores específicos. Por ejemplo, la divisa de costo tiene 3 caracteres y puede contener solo códigos de divisa según lo especificado.
Timestamp

Marca de tiempo UNIX de 10 dígitos. Ejemplo:

4 de agosto de 2020, 07:25 UTC se traduce como "timestamp": "1596525944"
Booleano

El valor del campo puede ser TRUE o FALSE
Entero

Entero
Flotante

Número flotante real que puede tener un punto decimal y valores después del punto decimal.

Campos disponibles en reportes de postback y de copia de postback

Nombre de campo Fuente o versión inicial de SKAN de iOS Descripción Formato Disponible en copia de postbacks 

ad_network_campaign_id

 Red de publicidad ID de la campaña reportada por la red de publicidad a AppsFlyer String No

ad_network_campaign

_name

 Red de publicidad

Nombre de la campaña reportado por la red de publicidad a AppsFlyer.

 

 String No

ad_network_timestamp

 Red de publicidad

Hora en que la red de publicidad recibió el postback.

En el caso de Google Ads, la hora se deriva del último clic reportado por Google.

 Timestamp No

app_id

 AppsFlyer ID de aplicación (aplicación del anunciante) con ID de prefijo. String Sí

city

 AppsFlyer A partir del 30 de agosto de 2021, siempre nulo  String No

country_code

 Red de publicidad   String No
dma   A partir del 30 de agosto de 2021, siempre nulo  String No

postal_code

   A partir del 30 de agosto de 2021, siempre nulo.   String No

region

 AppsFlyer Según el country_code reportado String No

skad_ad_network_id

 1.0 

Algunas SRN no comparten su ID y el campo se deja en blanco. Por ejemplo, Twitter. 

 String

Sí 

skad_attribution_signature

 1.0   String Sí
skad_campaign_id 1.0 ID de campaña usado para publicar el anuncio. Rango 0-100 String Sí
skad_conversion_value 2.0 

Valor de conversión reportado por iOS. Rango 0-63.

Si es nulo, iOS no rellenó el campo** 

 Entero Sí
skad_redownload 2,0 Si es true, la aplicación se volvió a descargar

Booleano

Sí
skad_source_app_id 2,0

ID del sitio. La app que publica el anuncio. Este campo es idéntico a source_app_id.

El relleno del campo depende de los umbrales de privacidad**

 String Sí
skad_transaction_id 1.0   String Sí
skad_version 2,0   String Sí
timestamp Red de publicidad

Hora en que AppsFlyer recibió el postback de SKAN. 

 Cadena de tiempo Sí
ad_network_name Red de publicidad

Nombre de la red de publicidad reportada por la red de publicidad a AppsFlyer. 

  • Si este campo está en blanco, la red de publicidad no lo rellenó (no pudo rellenarlo).
  • Puedes resolver el nombre de la red de publicidad usando skad_ad_network_id. Usa esta tabla para hacerlo. 
 String No
ip  

Dirección IP en el mensaje HTTP del dispositivo iOS que envía el postback.

Este campo se rellena si la red de publicidad nos proporciona la dirección.

Nota: El SDK no está involucrado en la obtención de la dirección.

 String No

skad_app_id

 1.0   String No

source_app_id

 AppsFlyer ID del sitio. La app que publica el anuncio. Este campo es idéntico a skad_source_app_id String No

ad_network_adset_id

 Red de publicidad   String No

ad_network_adset_name

 Red de publicidad   String No

ad_network_ad_name

 Red de publicidad   String No

ad_network_ad_id

 Red de publicidad   String No

did_win

 3.0 (iOS 14.6)

Se utiliza para distinguir entre las campañas que contribuyen o se atribuyen con la instalación. 

  • Si es true, se atribuye a la campaña por traer la instalación.
  • Si es false, se reconoce que la campaña contribuye a la instalación, pero no se incluye en ningún panel de control o reporte de SKAN.
  • Si es nulo, iOS no rellenó el campo debido a una versión heredada de iOS o SKADNetwork.
 Booleano Sí

fidelity_type

 2.2 (iOS 14.5)

Permite diferenciar entre las opciones de presentación de anuncios que afectan a la atribución. Se indica con los valores 0 y 1 de la siguiente manera: 

  • Anuncios por impresiones (0)
  • Anuncios renderizados por StoreKit (1)

Ignora el valor del campo si la versión de SKAN es anterior a la 2.2.

 Entero Sí

ad_network_source_app_id

 Red de publicidad ID de aplicación del publisher reportado por la red de publicidad. Se utiliza para ayudar a conciliar el costo; reportado por la red de publicidad. La aplicación del publisher proporciona la base de estos datos.  String No

ad_network_channel

 Red de publicidad   String No

af_prt

 Red de publicidad   String No

skad_postback_sequence_index

 4.0 (iOS 16.2)
  • Este valor representa la ventana de SKAN, ya sea0,1 o 2.
  • Para SKAN 3, el valor es 0.
 Entero Sí
skad_coarse_conversion_value

4.0 (iOS 16.2)

 
  • El valor puede ser low, medium o high.
  • Para SKAN 3, el valor es null.
 String Sí
skad_source_identifier 4.0 (iOS 16.2)
  • El valor puede ser de hasta 4 dígitos.
  • Para SKAN 3, el valor es null. 
 String Sí
skad_source_domain 4.0 (iOS 16.2)
  • El valor representa la fuente de los anuncios web atribuibles.
  • Para SKAN 3, el valor es null.
 String Sí
ad_network_creative Red de publicidad
  • El valor se basa en el enriquecimiento de los datos recibidos de la red de publicidad.
  • Para SKAN 3, el valor es null.
 String No

** Apple determina si el campo se rellena, mediante un mecanismo de umbral de privacidad. 

 

Campos disponibles en los reportes de eventos decodificados

Nombre de campo Fuente Descripción Formato Incluido en el reporte de dimensiones publicitarias de SRN
ad_network_campaign_id Red de publicidad ID de la campaña reportada por la red de publicidad a AppsFlyer String Sí
ad_network_campaign
_name		 Red de publicidad Nombre de la campaña reportado por la red de publicidad a AppsFlyer String Sí
ad_network_timestamp Red de publicidad

Hora en que la red de publicidad recibió el postback.

En el caso de Google Ads, este campo no se rellena. 

Timestamp

(cadena de tiempo para el reporte de dimensiones publicitarias SRN)

 Sí
app_id iOS El ID de aplicación (aplicación del anunciante). String Sí
city   A partir del 30 de agosto de 2021, siempre nulo  String No
country_code Red de publicidad   String No
dma   A partir del 30 de agosto de 2021, siempre nulo  String No
event_name AppsFlyer

Nombre del evento in-app configurado en AppsFlyer.

Para SRN ___report, es el nombre del evento in-app configurado en Anuncios de Meta.

 String Sí
event_uuid AppsFlyer Un identificador aleatorio exclusivo que permite a los partners identificar los postbacks duplicados. String No
install_date iOS Estimado por AppsFlyer, en función de la hora de llegada del postback. Cadena de tiempo No
install_type iOS Nuevas instalaciones String No
ip iOS

La dirección IP en el mensaje HTTP del dispositivo iOS que envía el postback.

Este campo se rellena si la red de publicidad nos proporciona la dirección.

Nota: El SDK de AppsFlyer no está involucrado en la obtención de la dirección. 

 String No
media_source iOS Red de publicidad atribuida utilizando nombres de red de AppsFlyer String Sí
postal_code   A partir del 30 de agosto de 2021, siempre nulo  String No
region AppsFlyer Determinada según el código del país String No
skad_ad_network_id iOS ID de la red de publicidad a la que se envió el postback. String No
skad_ambiguous_event AppsFlyer Si es true, el postback de iOS se recibió durante las primeras 72 horas después de que un anunciante cambiara la configuración de SKAN en el panel de control. Debido a los distintos temporizadores usados por SKAN, AppsFlyer no puede asignar el evento con precisión. Booleano No
skad_attribution_signature iOS   String No
skad_campaign_id iOS ID de campaña usado para publicar el anuncio. Rango 0-100 Entero No
skad_conversion_value iOS

Valor de conversión reportado por iOS. Rango 0-63.

Si es nulo, iOS no rellenó el campo.**

 Entero No
skad_mode AppsFlyer

El modo de medición de la conversión usado para decodificar el postback de iOS. Opciones:

  • custom_decode
  • ingresos
  • eventos
  • skan4
  • custom_encode
  • continuo
 String No
skad_redownload iOS Si es true, la aplicación se volvió a descargar. Booleano No
skad_revenue iOS Monto de ingresos por eventos en USD. Flotante No
skad_source_app_id iOS

ID del sitio - la aplicación que publica el anuncio.

El relleno del campo depende de los umbrales de privacidad**

 String No
skad_transaction_id iOS - String No
skad_version iOS - String No
timestamp iOS

Hora en que AppsFlyer recibió el postback de SKAN.

Para Google Ads y Anuncios de Meta, este es el momento en que AppsFlyer obtiene los datos de la API de Google y Anuncios de Meta, respectivamente.

Timestamp

(cadena de tiempo para el reporte de dimensiones publicitarias SRN)

 Sí
event_value S2S

Valor por defecto: null

Contiene una cadena establecida por aplicaciones que implementan decodificación personalizada.

Los anunciantes consumen esto en sus sistemas. AppsFlyer no hace uso del mismo. 

 String (JSON) No

ad_network_adset_id

 Red de publicidad   String Sí

ad_network_adset_name

 Red de publicidad   String Sí

ad_network_ad_name

 Red de publicidad   String Sí

ad_network_ad_id

 Red de publicidad

 

 String Sí

skad_did_win (1)

 3.0 (iOS 14.6)

Se utiliza para distinguir entre las campañas que contribuyen o se atribuyen con la instalación. 

  • Si es true, se atribuye a la campaña por traer la instalación.
  • Si es false, se reconoce que la campaña contribuye a la instalación, pero no se incluye en ningún panel de control o reporte de SKAN.
  • Si es nulo, iOS no rellenó el campo debido a una versión heredada de iOS o SKADNetwork.
 Booleano No

skad_fidelity_type (1)

 2.2 (iOS 14.5)

Permite diferenciar entre las opciones de presentación de anuncios que afectan a la atribución. Se indica con los valores 0 y 1 de la siguiente manera: 

  • Anuncios por impresiones (0)
  • Anuncios renderizados por StoreKit (1)

Ignora el valor del campo si la versión de SKAN es anterior a la 2.2.

 Entero Sí

ad_network_source_app_id (1)

 Red de publicidad ID de aplicación del publisher reportado por la red de publicidad. Se utiliza para ayudar a conciliar el costo; reportado por la red de publicidad. La base de estos datos es proporcionada por la aplicación del publisher. String No

ad_network_channel (1)

 Red de publicidad   String No

af_prt (1)

 Red de publicidad   String No

min_revenue 

 AppsFlyer Ver nota (4) Número real No

max_revenue 

 AppsFlyer Ver nota (4) Número real No

event_revenue

 AppsFlyer

Fórmula: [suma de valores del evento específico en USD]/[El número de eventos que ocurrieron en un día específico]

 Flotante Sí

min_event_counter

 AppsFlyer Se utiliza para calcular el número de veces que un usuario realiza un evento. Ver nota (3) Entero No

max_event_counter

 AppsFlyer Ver nota (3) Entero No

min_time_post_install

 AppsFlyer Ver nota (5) Entero No

max_time_post_install

 AppsFlyer Ver nota (5) Entero No

af_attribution_flag

 AppsFlyer

Cuando el mecanismo de Única fuente de verdad (SSOT) está activado: si es true, la instalación fue atribuida tanto por AppsFlyer como por SKAN. Si es false, la instalación no fue atribuida por AppsFlyer. Si el skad_conversion_value es nulo, el indicador es true o false (en función del modelado).

 Booleano No

measurement_window

 AppsFlyer Duración de la ventana de actividad. Por defecto 24 h.  Entero No

Intervalo

 AppsFlyer Intervalos de ventana de actividad.  Entero No

user_agent

 AppsFlyer Agente de usuario del dispositivo String No

skad_postback_sequence_index

 4.0 (iOS 16.2)
  • Este valor representa la ventana de SKAN, ya sea0,1 o 2.
  • Para SKAN 3, el valor es 0.
 Entero Sí
skad_coarse_conversion_value

 

4.0 (iOS 16.2)
  • El valor puede ser low, medium o high.
  • Para SKAN 3, el valor es null.
 String Sí
skad_source_identifier 4.0 (iOS 16.2)
  • El valor puede ser de hasta 4 dígitos.
  • Para SKAN 3, el valor es null. 
 String Sí
skad_source_domain 4.0 (iOS 16.2)
  • El valor representa la fuente de los anuncios web atribuibles.
  • Para SKAN 3, el valor es null.
 String Sí
ad_network_creative Red de publicidad
  • El valor se basa en el enriquecimiento de los datos recibidos de la red de publicidad.
  • Para SKAN 3, el valor es null.
 String No

** Apple determina si el campo se rellena, mediante un mecanismo de umbral de privacidad.

(1) A partir del 2 de junio de 2021, el campo se agrega a los reportes, pero no necesariamente se rellenará.

(3) Para determinar el número de veces que un usuario realiza un evento in-app determinado, usa la fórmula: [round up (min_event_counter + max_event_counter) / 2]. Nota: Debes redondear al entero más cercano.
Ejemplo:
A. Si min = 0 y max = 1, el promedio es 0.5; redondear hacia arriba devuelve un resultado de 1.
B. Si min = 5 y max = 10, el promedio es 7.5; redondear hacia arriba devuelve un resultado de 8.

(4) Los ingresos siempre se proporcionan en el campo skad_revenue. Si usas SKAN 4 o el modo personalizado, el rango de bucket asociado con el evento y utilizado para calcular skad_revenue se describe por min_revenue y max_revenue.

(5)

  • En la conversión personalizada: AppsFlyer calcula el tiempo de instalación como la hora de llegada del postback - 36 h - promedio (min_time_post_install + max_time_post_install). Sin embargo, si CV=0, entonces el promedio (min_time_post_install + max_time_post_install) se considera como 0. 
  • En la conversion de decodificación: min_time_post_install es una hora menos que la establecido en max_time_post_install, que es igual al hours_from_install que estableciste en la asignación de la conversión de decodificación. 

 

Información adicional

Rasgos y limitaciones

Característica Observaciones 
Acceso a la red de publicidad Las redes de publicidad se proporcionan con postbacks
Acceso de agencias No disponible
Transparencia de Agencias N/A
Zona horaria UTC
Divisa  USD
datos orgánicos Basado en datos de eventos del SDK. Por ejemplo, las métricas de instalación orgánica se calculan de la siguiente manera: los datos de todas las instalaciones reportadas por el SDK menos las instalaciones no orgánicas reportadas por SKAN.
Datos no orgánicos Basado en postbacks de SKAN
Actualización de los datos

Diaria. La sincronización de SKAN significa que iOS informa sobre una instalación 24-48 horas después del cierre de la ventana.
Historial de datos

Limitado a la ventana de disponibilidad de Data Locker. 
Acceso de usuario a la cuenta Disponible. Según los permisos de la cuenta.

 Consulta también