Reportes de raw data de SKAN

En resumen: 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 daya, no es necesario tener una suscripción a Data Locker. 

Reportes de raw data de SKAN

Principios: 

  • Los datos son proporcionados por:
    • Data Locker
      • ¡Importante! 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, ve a Reportes > Data Locker. Selecciona los reportes de SKAN.  
      • Tasa de actualización de los datos: Diariamente. Los datos se incluyen en la carpeta h=23 de la fecha en que AppsFlyer recibe el postback.  
    • Push API
  • Fecha de instalación: La calcula AppsFlyer a partir de la hora de llegada del postback, de la siguiente manera:
    • Si los postbacks son SKAN V4, la fórmula de la fecha de instalación es: Fecha de instalación = hora de llegada del postback - [duración acumulada de la ventana] - [retraso medio del postback].
      • Postback 1: fecha de instalación = hora de llegada del postback - 48h - 36h
      • Postback 2: fecha de instalación = hora de llegada del postback - 168h - 84h
      • Postback 3: fecha de instalación = hora de llegada del postback - 840h - 84h
    • Si los postbacks son SKAN V3, la fórmula de la fecha de instalación es: Fecha de instalación = hora de llegada después del postback: 36 horas (promedio del último intervalo activo). 
      • 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 45 días en reportar las instalaciones. Saber más

Los tipos de reportes disponibles son:

  • Postbacks del 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, blank, o null: No se generan registros en la aplicación. 
      • 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.
        • Bajo, medio o alto: 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 informe Descripción
Postback Devoluciones de mensajes

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: 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 Re-descargas

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 dentro de la aplicación

Eventos dentro de la aplicación

A partir del 21 de julio de 2021, habrán 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 funnel
  • 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 en la aplicación, utiliza 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.
Engagement 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 Meta Ads 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 adset y anuncio no está incluida en los postbacks de SKAN de los Meta Ads. Estos datos son únicos para este reporte y no se muestran en el dashboard 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.
  • Mejores prácticas: No combines ni compares los datos de este reporte con otros reportes de SKAN, ya que puede haber discrepancias entre este, que utiliza datos decodificados por el SRN, y otros, que utilizan datos decodificados por AppsFlyer. Estas discrepancias pueden deberse a diferencias de zona horaria, diferencias en el esquema de SRN o eventos in-app mapeados incorrectamente a CV en la integración de 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
Cadena [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 ello.
Cadena temporal Cadena con el formato, yyyy-mm-dd hh:mm:ss. Por ejemplo, 2019-09-17 00:09:25 
Enum [n] Los campos de enumeración 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.
Marca de tiempo

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

4 de agosto de 2020 a las 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 del campo Fuente o versión inicial de SKAN de iOS Descripción Formato Disponible en copia de postbacks  
ad_network_campaign_id Red de anuncios ID de campaña informado por la red publicitaria a AppsFlyer Cadena No

ad_network_campaign

_nombre

Red de anuncios

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

 

Cadena No
ad_network_timestamp Red de anuncios

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.

Marca de tiempo No
app_id AppsFlyer ID de aplicación (aplicación del anunciante) con ID de prefijo. Cadena
ciudad AppsFlyer A partir del 30 de agosto de 2021, siempre nulo   Cadena No
country_code Red de anuncios   Cadena No
dma   A partir del 30 de agosto de 2021, siempre nulo   Cadena No
postal_code   A partir del 30 de agosto de 2021, siempre nulo    Cadena No
región AppsFlyer Según el country_code reportado Cadena No
skad_ad_network_id 1.0  Algunas SRN no comparten su ID y el campo se deja en blanco. Por ejemplo, X Ads.  Cadena Sí 
skad_attribution_signature 1.0   Cadena
skad_campaign_id 1.0 ID de campaña usada para publicar el anuncio. Intervalo 0-100 Cadena
skad_conversion_value 2,0 

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

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

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

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

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

Cadena
skad_transaction_id 1.0   Cadena
versión_skad 2,0   Cadena
timestamp Red de anuncios Hora en que AppsFlyer recibió el postback de SKAN.   Cadena de tiempo
ad_network_name Red de anuncios Nombre de la red publicitaria reportado por la red a AppsFlyer. 
  • Si este campo está vacío, la red publicitaria no lo ha completado.
  • Puede resolver el nombre de la red publicitaria usando skad_ad_network_id. Utiliza esta tabla para hacerlo. 
Cadena 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.

Cadena No
skad_app_id 1.0   Cadena No
ID de la aplicación de origen AppsFlyer ID del sitio. La aplicación que publica el anuncio. Este campo es idéntico a skad_source_app_id Cadena No
ad_network_adset_id Red de anuncios   Cadena No
ad_network_adset_name Red de anuncios   Cadena No
ad_network_ad_name Red de anuncios   Cadena No
ad_network_ad_id Red de anuncios   Cadena No
did_win 3.0 (iOS 14.6) Se utiliza para distinguir entre campañas que contribuyen o se les atribuye una instalación. 
  • Si es verdadero, la campaña se atribuye por haber realizado la instalación.
  • Si es falso, se reconoce que la campaña ha contribuido a la instalación, pero no se incluye en ningún panel ni informe de SKAN.
  • Si es nulo, iOS no rellenó el campo debido a una versión heredada de iOS o SKADNetwork.
Booleano
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 utilizando los valores 0 y 1 de la siguiente manera: 

  • Anuncios de visualización (0)
  • Anuncios renderizados por StoreKit (1)

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

Entero
id_app_fuente_red_publicitaria Red de anuncios ID de la aplicación del editor informado por la red publicitaria. Úselo para ayudar en la conciliación de costes; informado por la red publicitaria. La aplicación del editor proporciona la base para estos datos. Cadena No
ad_network_channel Red de anuncios   Cadena No
af_prt Red de anuncios   Cadena No
skad_postback_sequence_index 4.0 (iOS 16.2)
  • El valor representa la ventana SKAN 0, 1 o 2.
  • Para SKAN 3, el valor es 0
Entero
skad_coarse_conversion_value

4.0 (iOS 16.2)

 

  • El valor puede ser low, medium, o high.
  • Para SKAN 3, el valor es null.
Cadena
skad_source_identifier 4.0 (iOS 16.2)
  • El valor puede tener hasta 4 dígitos.
  • Para SKAN 3, el valor es null
Cadena
skad_source_domain 4.0 (iOS 16.2)
  • El valor representa la fuente de anuncios web atribuibles.
  • Para SKAN 3, el valor es null.
Cadena
ad_network_creative Red de anuncios
  • El valor se basa en el enriquecimiento de datos recibido de la red de anuncios.
  • Para SKAN 3, el valor es null.
Cadena No
** Apple determina si el campo se rellena, mediante un mecanismo de umbral de privacidad.    

Campos disponibles en los reportes de eventos decodificados

Nombre del campo Fuente Descripción Formato Incluido en el reporte de dimensiones publicitarias de SRN
ad_network_campaign_id Red de anuncios ID de campaña informado por la red publicitaria a AppsFlyer Cadena
ad_network_campaign
_nombre
Red de anuncios Nombre de la campaña informado por la red publicitaria a AppsFlyer Cadena
ad_network_timestamp Red de anuncios

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

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

Marca de tiempo

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

app_id iOS El ID de aplicación (aplicación del anunciante). Cadena
ciudad   A partir del 30 de agosto de 2021, siempre nulo   Cadena No
country_code Red de anuncios   Cadena No
dma   A partir del 30 de agosto de 2021, siempre nulo   Cadena No
nombre_del_evento AppsFlyer

Nombre del evento in-app configurado en AppsFlyer.

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

Cadena
UUID del evento AppsFlyer Un identificador único y aleatorio que permite a los socios identificar postbacks duplicados Cadena No
fecha_de_instalación iOS Estimado por AppsFlyer basándose en el momento de llegada del postback. Cadena temporal No
tipo_de_instalación iOS Nuevas instalaciones Cadena 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 no está involucrado en la obtención de la dirección. 

Cadena No
fuente_medios iOS Red de publicidad atribuida utilizando nombres de red de AppsFlyer Cadena
postal_code   A partir del 30 de agosto de 2021, siempre nulo   Cadena No
región AppsFlyer Determinada según el código del país Cadena No
skad_ad_network_id iOS ID de la red publicitaria a la que se envió el postback. Cadena No
skad_ambiguous_event (obsoleto con SKAN 4+) AppsFlyer Si es verdadero, el postback de iOS se recibió en las primeras 72 horas después de que un anunciante cambió la configuración de SKAN en el panel. Debido a los diferentes temporizadores que utiliza SKAN, AppsFlyer no puede mapear el evento con precisión.
  • No disponible en SKAN 4 y posteriores
Booleano No
skad_attribution_signature iOS   Cadena No
skad_campaign_id iOS ID de campaña usada para publicar el anuncio. Intervalo 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
modo_skad AppsFlyer El modo de medición de conversión usado para decodificar el postback de iOS. Opciones:
  • decodificación_personalizada
  • ingresos
  • eventos
  • skan4
  • codificación_personalizada
  • participación
Cadena No
skad_redownload iOS Si es verdadero, la aplicación se descargó de nuevo. Booleano No
ingresos_skad iOS Monto de ingresos del evento 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**

Cadena No
skad_transaction_id iOS - Cadena No
versión_skad iOS - Cadena No
timestamp iOS

Hora en que AppsFlyer recibió el postback de SKAN. 

Para los anuncios de Google y Meta, este es el momento en que AppsFlyer recibe los datos de la API de anuncios de Google y Meta, respectivamente.

Marca de tiempo

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

event_value S2S

Valor predeterminado: nulo

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

Este valor es utilizado por los anunciantes en sus sistemas. AppsFlyer no lo emplea. 

Cadena (JSON) No
ad_network_adset_id Red de anuncios   Cadena
ad_network_adset_name Red de anuncios   Cadena
ad_network_ad_name Red de anuncios   Cadena
ad_network_ad_id Red de anuncios   Cadena
skad_did_win (1) 3.0 (iOS 14.6) Se utiliza para distinguir entre campañas que contribuyen o se les atribuye una instalación. 
  • Si es verdadero, la campaña se atribuye por haber realizado 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 utilizando los valores 0 y 1 de la siguiente manera: 

  • Anuncios de visualización (0)
  • Anuncios renderizados por StoreKit (1)

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

Entero
ad_network_source_app_id (1) Red de anuncios ID de la aplicación del editor informado por la red publicitaria. Úselo para ayudar en la conciliación de costes; informado por la red publicitaria. La base de estos datos la proporciona la aplicación del publisher. Cadena No
ad_network_channel (1) Red de anuncios   Cadena No
af_prt (1) Red de anuncios   Cadena 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 para el evento específico en dólares americanos]/[el número de eventos que ocurrieron en un día específico] Flotante
contador_de_eventos_min AppsFlyer Se utiliza para calcular cuántas veces realiza un usuario un evento. Ver nota (3) Entero No
contador_máximo_de_eventos AppsFlyer Ver nota (3) Entero No
tiempo mín. post-instalación AppsFlyer Ver nota (5) Entero No
tiempo máx. post-instalación AppsFlyer Ver nota (5) Entero No
af_attribution_flag AppsFlyer Cuando el mecanismo de Single Source of Truth (SSOT) está activado: Si es verdadero, la instalación fue atribuida tanto por AppsFlyer como por SKAN. Si es falso, la instalación no fue atribuida por AppsFlyer. Si skad_conversion_value es nulo, el indicador es verdadero o falso (basado en el modelado). Booleano No
measurement_window AppsFlyer Duración de la ventana de actividad. Predeterminado: 24h.  Entero No
intervalo AppsFlyer Intervalos de ventanas de actividad.  Entero No
agente_usuario AppsFlyer Agente de usuario del dispositivo Cadena No
skad_postback_sequence_index 4.0 (iOS 16.2)
  • El valor representa la ventana SKAN 0, 1 o 2.
  • Para SKAN 3, el valor es 0
Entero
skad_coarse_conversion_value

 

4.0 (iOS 16.2)

  • El valor puede ser low, medium, o high.
  • Para SKAN 3, el valor es null.
Cadena
skad_source_identifier 4.0 (iOS 16.2)
  • El valor puede tener hasta 4 dígitos.
  • Para SKAN 3, el valor es null
Cadena
skad_source_domain 4.0 (iOS 16.2)
  • El valor representa la fuente de anuncios web atribuibles.
  • Para SKAN 3, el valor es null.
Cadena
ad_network_creative Red de anuncios
  • El valor se basa en el enriquecimiento de datos recibido de la red de anuncios.
  • Para SKAN 3, el valor es null.
Cadena 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á.

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

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

(5)

  • En conversión personalizada: AppsFlyer calcula el tiempo de instalación como el tiempo de llegada del postback menos 36 horas menos el promedio de (min_time_post_install + max_time_post_install). Sin embargo, si CV=0, el promedio (min_time_post_install + max_time_post_install) se considera 0. 
  • En la conversión Decode: El min_time_post_install es una hora menos que el max_time_post_install, que es igual a hours_from_install definido en tu asignación de conversión Decode. 
 

Información adicional

Características y limitaciones

Característica Observaciones 
Acceso a la red publicitaria Las redes publicitarias reciben postbacks
Acceso a la agencia No disponible
Transparencia de agencia N/A
Zona horaria UTC
Divisa  USD (Dólar estadounidense)
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: Datos de todas las instalaciones reportadas por el SDK menos las instalaciones no orgánicas reportadas por SKAdNetworks.
Datos no orgánicos Basado en postbacks de SKAN
Actualización de los datos Diariamente. La sincronización de SKAN significa que iOS informa sobre una instalación 24-48 horas después del cierre de la ventana.
Datos históricos Limitado a la ventana de disponibilidad de Data Locker.  
Acceso de usuario a la cuenta Disponible. Según los permisos de la cuenta.