En resumen: AppsFlyer decodifica y transforma el valor de conversión establecido por ti en eventos. Los eventos se utilizan para rellenar el panel de SKAN, los raw data y los postbacks a los partners.
Decodificar el valor de conversión de SKAN
Los anunciantes utilizan la decodificación del valor de conversión como alternativa a las opciones disponibles en Conversion Studio. Si usas Decodificar, significa que eres responsable de configurar updatePostbackConversionValue de acuerdo con la lógica de tu aplicación.
Además de establecer el valor de conversión (CV) en la aplicación, el resto del flujo, las funciones y las opciones de reportes son los mismos que los descritos en la guía de soluciones de SKAN. Esto significa que, al expirar el período de actividad (controlado por ti), iOS envía el postback a la red de publicidad que la reenvía a AppsFlyer. AppsFlyer decodifica el CV de acuerdo con tu asignación en eventos procesados de la misma manera que los CV decodificados establecidos por el SDK.
Valor de conversión personalizado: decodificar
La implementación de la decodificación de CV personalizada requiere subir un archivo CSV que contenga tu asignación de CV a la plataforma AppsFlyer.
Decodificar los principios de asignación
- Proporciona una asignación de decodificación para valores de conversión precisos (1 - 63) y valores de conversión aproximados (bajo, medio y alto) para las ventanas 1 - 3. No es obligatorio asignar todo el rango de valores. Por ejemplo, puedes asignar los valores 1, 2, 10 y 43.
- El CV 0 siempre está asignado para instalarse. No puedes configurarlo.
- La tabla de asignación se carga en AppsFlyer en un archivo CSV. Puedes cargar una tabla de asignación actualizada según sea necesario.
- Al recibir un postback de iOS, el CV se decodifica en eventos, como se ilustra en los ejemplos.
- La hora de instalación se calcula en función de la hora de llegada del postbacks.
- Los eventos tienen la misma hora que la hora de instalación.
- Para entender mejor cómo preparar el esquema, revisa los escenarios de asignación que aparecen a continuación.
-
Se permiten nombres de eventos in-app personalizados.
- Lo que significa que envías nuevos nombres de eventos, incluso si el SDK nunca los ha enviado.
- Puedes asignar los eventos in-app a los eventos in-app de la red publicitaria.
- Esto también se aplica a la integración de Anuncios de Meta, sujeta a las reglas específicas de Meta que se detallan en la siguiente sección.
Decodificar las reglas de los escenarios de asignación
Ten en cuenta lo siguiente:
- Intervalo de valores de conversión precisos: de 1 a 63
- Rango de valores de conversión aproximado: Bajo, medio y alto
- Un valor de conversión determinado se asigna a uno o más eventos in-app que hayas especificado. Los eventos in-app tienen parámetros opcionales.
- Para ver los ejemplos: supongamos que la fecha de instalación es el 1 de febrero a las 08:00.
- La tabla que sigue es un ejemplo de tabla de asignación de decodificación. Su estructura es similar a la del archivo CSV requerido. A continuación de la tabla se muestran los eventos generados como resultado del proceso de decodificación.
- Siempre se genera un evento de instalación, independientemente de tu asignación.
- Medición de ingresos:
- Los ingresos están en USD.
- Un valor de conversión determinado tiene un rango de ingresos limitado por min_revenue y max_revenue.
- En los reportes y paneles de control agregados, los ingresos se calculan como el promedio del rango. Ejemplo: min_revenue=4 y max_revenue=10. Los ingresos calculados son 7.
- Los reportes de raw data incluyen los ingresos calculados (skad_revenue), min_revenue y max_revenue.
Reglas específicas de Meta
Si te integras con Anuncios de Meta, sigue las siguientes reglas:
- Los valores de ingresos mínimos y máximos de un valor de conversión determinado deben ser diferentes. Lo que significa que no es igual.
- Los valores no deben superponerse y deben estar en orden consecutivo, como se muestra para los valores de conversión del 1 al 2 y 62 en la tabla siguiente.
- event_counter: Los Anuncios de Meta no tienen en cuenta este valor. [Práctica recomendada] Llénalo con un valor de 1.
Ejemplo: Decodificar la asignación
| conversion_ value |
event_ name |
event_ value |
min_revenue (no incluido) |
max_revenue (inclusive) | event_ counter |
hours_from_ install |
|---|---|---|---|---|---|---|
| 1 | af_purchase | {abc} | 0 | 3 | 1 | 24 |
| 2 | af_purchase | {def} | 3 | 10 | 3 | 36 |
| 21 | event_a | 1 | 24 | |||
| 21 | event_b | 3 | 24 | |||
| 21 | event_c | {xyz} | 2 | 24 | ||
| 21 | event_d | 1 | 24 | |||
| 21 | event_e | 1 | 24 | |||
| 21 | event_f | 1 | 24 | |||
| 21 | event_g | 1 | 24 | |||
| 62 | af_purchase | {fgh) | 10 | 17 | 2 | 72 |
| 62 | event_a | {klm} | 3 | 72 |
Ejemplo A : Valor de conversión preciso 1
| event_name | skad_revenue |
min_revenue |
max_revenue |
event_value |
|---|---|---|---|---|
| install | ||||
| af_purchase | 1,5 | 0 | 3 | {abc} |
Ejemplo B: Valor de conversión preciso
| event_name | skad_revenue | min_revenue | max_revenue | event_value |
|---|---|---|---|---|
| install | ||||
| af_purchase | 6.5 | 3 | 10 | {def} |
| af_purchase | 6.5 | 3 | 10 | {def} |
| af_purchase | 6.5 | 3 | 10 | {def} |
Ejemplo C: Valor de conversión preciso 21
| event_name | skad_revenue | min_revenue | max_revenue | event_value |
|---|---|---|---|---|
| install | ||||
| event_a | ||||
| event_b | ||||
| event_b | ||||
| event_b | ||||
| event_c | {xyz} | |||
| event_c | {xyz} | |||
| event_d | ||||
| event_e | ||||
| event_f | ||||
| event_g |
Ejemplo D: Valor de conversión preciso 62
| event_name | skad_revenue | min_revenue | max_revenue | event_value |
|---|---|---|---|---|
| install | ||||
| af_purchase | 13,5 | 10 | 17 | {fgh} |
| af_purchase | 13,5 | 10 | 17 | {fgh} |
| event_a | {klm} | |||
| event_a | {klm} | |||
| event_a | {klm} |
Decodificar la especificación del archivo csv
Los valores de conversión se asignan a uno o más eventos in-app.
Reglas de archivos
- Formato: Archivo CSV
- Número máximo de filas: 640 + header row; total 641.
- La fila de encabezado debe incluir todos los nombres de las columnas tal y como aparecen aquí. Práctica recomendada: Utiliza el archivo de ejemplo adjunto como plantilla. Consulta ejemplos de archivos CSV de decodificación para SKAN 3 y SKAN 4.
- No utilices los siguientes caracteres como primer carácter de una columna:
=,+-, y@(editado).
Decodificar la especificación del archivo csv
| Columna | Valor obligatorio | Contenido | Detalles |
|---|---|---|---|
| conversion_value |
Sí, para:
|
Valor entero 1—63 |
El mismo valor de conversión fina puede aparecer más de una vez. Consulta los ejemplos para obtener una explicación más detallada. |
| coarse_conversion_value |
Relevante solo para SKAN 4 |
String:
|
El mismo valor de conversión aproximado se puede mostrar más de una vez. |
| event_name | Sí | Cadena |
Evento in-app. No tiene que ser un evento que ya exista en AppsFlyer. Nota: Los nombres de los eventos in-app son sensible a las mayúsculas y minúsculas. [Práctica recomendada]: Nombre del evento para los ingresos af_skad_revenue. |
| event_value | No | Cadena | Cadena establecida por el desarrollador que contiene los datos que el anunciante debe decodificar en sus sistemas. Por lo general, tiene el formato de un JSON. |
| min_revenue |
No
|
Entero o flotante |
Usa min_revenue y max_revenue para establecer un rango de ingresos en USD.
Nota: Si generas el archivo con Excel, antes de guardarlo, cambia el formato de la columna a coma y no a moneda para evitar que Excel incruste el símbolo $ en el archivo CSV. |
| max_revenue | No |
Si completas min_revenue: max_revenue debe tener un valor superior a 0. Consulta min_revenue para obtener la explicación. |
|
| No |
En desuso desde el 7 de julio de 2021. Usa min_revenue y max_revenue
|
||
| Contador de eventos | Sí |
Entero
|
Ejemplo: Si el usuario realizó un evento determinado 5 veces, se generan 5 eventos. Consideraciones: Si envías ingresos, el importe total en USD declarado se multiplica por el valor de event_counter. Es decir, si min_revenue = 0, max_revenue = 3 y event_counter = 4, los ingresos totales declarados son 1,5 X 4 = 6. Vea los ejemplos. |
| hours_from_install | Sí | Entero |
AppsFlyer usa esto para derivar y establecer la fecha de instalación de la siguiente manera:
|
| postback_sequence_index |
Sí, pero solo es relevante para SKAN 4 |
Entero:
|
Para un valor fino, solo se puede recibir el valor 0. |
Cargar archivo de esquema de valores de conversión
Antes de comenzar:
- Prepare el archivo CSV del esquema de valores de conversión.
- Si te integras con los Anuncios de Meta y mides los ingresos, verifica que tu esquema cumpla con las reglas relacionadas con Meta. Si no lo haces, los Anuncios de Meta no podrán interpretar el esquema.
Para habilitar la medición SKAN mediante la medición de decodificación:
- En AppsFlyer, ve a Ajustes > SKAN Conversion Studio.
- Haz clic en Opciones () y selecciona Cargar archivo de asignación de decodificación.
- Si aún no te has actualizado a SKAN 4, elige subir un archivo para SKAN 4 o antes de SKAN 4. Una vez que actualices a SKAN 4, la opción para otras versiones no estará disponible.
- Realiza una de las siguientes acciones:
- Haz clic en Arrastrar y soltar archivo.
- Carga archivo de asignación actualizado.
- Sigue las instrucciones de la interfaz de usuario para cargar el archivo.
- Activa la medición de SKAN
- Haz clic en Guardar cambios.
Nota: Durante las próximas 48 a 72 horas, los datos sel panel de control son ambiguos. Es decir, debido a problemas con el temporizador de iOS, no podemos estar seguros de si la asignación de decodificación coincide con la asignación de codificación que utilizas. - Asegúrate de haber asignado los eventos in-app a los utilizados por los partners para que puedan consumir los postbacks de datos correctamente.
Solución de problemas del archivo de errores de carga de CSV
Cargar mensajes de error
Uno o más valores del archivo no coinciden con el formato requerido: El formato del archivo se modificó a partir del 7 de junio de 2021. Compruebe que el formato del archivo coincide con el ejemplo de este artículo.
Uso de Excel para formatear la columna event_revenue_usd
Al usar hojas de cálculo de Excel/Google para crear un archivo CSV, la columna event_revenue_usd debe tener el formato correcto antes de guardar el archivo como archivo CSV.
Después de guardar el archivo CSV, comprueba que el contenido tenga el formato correcto. Nota: No utilices Excel para hacer la verificación, utiliza un editor.
Formatear celdas event_revenue_usd en Excel
Excel suele dar formato a las celdas de valor con una coma para separar los miles, como se muestra en la figura. Este formato no es adecuado para cargar archivos CSV. También debes eliminar el símbolo $.
Puedes corregir esto formateando las celdas en Excel.
Para formatear los importes gastados sin la coma de 1000 ni el símbolo $:
- Selecciona las celdas que se van a formatear.
- Haz clic con el botón derecho y selecciona Formato de celda.
Se abre la ventana de formato de celda. - Selecciona Número.
- Borra Usar separador de 1000 (,).
- (Opcional) Establece el número de decimales. El valor predeterminado es 2. El máximo permitido es 5.
- Haz clic en Aceptar.
Las celdas se formatean correctamente.
Inspección visual del archivo CSV sin Excel
Para examinar el contenido del archivo CSV, usa un editor.
- Windows: Notepad, Notepad++
- macOS: TextEdit
A continuación se incluye una captura de pantalla del archivo CSV de ejemplo mostrado en un editor.
Vista del editor
Usando un editor, examina el archivo CSV. Presta especial atención a lo siguiente:
- Espacios en blanco: Asegúrate de que no haya espacios en blanco al principio o al final antes o después de las comas que separan los campos. En Excel, usa el comando @trim para eliminar los espacios en blanco.
-
event_revenue_usd: Asegúrate de que no haya ni una coma ni un símbolo $ en la columna event_revenue_usd.
Los archivos CSV generados por Excel no tienen comas como delimitadores
Si Excel crea un archivo CSV con un punto y coma ";" u otro carácter como delimitador, pero no una coma:
- Esto ocurre cuando la configuración regional de tu computadora se establece en un idioma/región que no es el inglés.
- Este tema es particularmente frecuente cuando se selecciona alemán en la configuración regional.
- La solución difiere según el sistema operativo de tu computadora (macOS o Windows).
- Para resolver este problema, busca la guía más reciente de Microsoft u otros foros para encontrar una solución. Utiliza los siguientes términos de búsqueda: Sistema operativo (macOS o Windows) Delimitador de cambios de Excel para archivos CSV.