En resumen: Aprende a crear fuentes de datos de medición y a proporcionar acceso a ellas de forma que puedan ser digeridas por el trabajo de atribución.
Nota
El primer paso para establecer el proceso de medición es preparar las tres entradas que lo alimentan: conversiones, engagements y mapeo de campaña. Estas entradas deben prepararse basándose en el esquema predefinido o en la estructura de eventos, dependiendo del modo de suministro de datos: eventos in-app o archivos fuente personalizados.
Cuando el modo de provisión es archivos de origen personalizados, el trabajo de atribución se activa automáticamente cuando se suben a la nube las carpetas de conversión y registro de engagement necesarias. En el modo de eventos in-app, el trabajo se activa cuando se seleccionan los eventos in-app relevantes.
Preparar eventos in-app
Puedes enviar datos de conversión y engagement a través de eventos in-app enviados por el SDK de AppsFlyer integrado en tu aplicación.
Nota:
Si ya estás pasando eventos in-app de AppsFlyer a través del SDK o a través de solicitudes server-to-server, esta opción podría ser más fácil de implementar que la opción de archivo de origen personalizado.
Preparar eventos in-app de conversión
El evento in-app de conversión debe incluir la información SKU. En el siguiente ejemplo, la clave af_order_info identifica la información SKU:
"event_value": {
"af_currency": "EUR",
"af_content": "retail",
"af_order_id": "637f7c400f0e3fddd9e5bcbc",
"af_order_info": [
{
"sku": "a",
"revenue": 1.1,
"qty": 2
},
{
"sku": "b",
"revenue": 100.5,
"qty": 1
}
]
}
Para obtener información sobre cómo preparar eventos in-app, consulta la sección Crear eventos in-app.
Preparar eventos in-app de engagement
Las campañas on-site pueden recibir engagements a través de eventos in-app. El evento in-app de engagement debe incluir los datos de atribución en la clave event_value. Mira, como ejemplo, la siguiente estructura JSON event_value:
"event_value": {
"media_source": "onsite",
"campaign_name": "winter_bags",
"campaign_id": "637f7c400f0e3fddsdfaafe33",
"engagement_type": "click"
}
Puedes utilizar los siguientes campos en tu clave JSON evant_value:
| Campo | Descripción | Obligatorio | Disponible en el esquema de eventos in-app | Tipo |
|---|---|---|---|---|
id_campaña |
ID de campaña | Sí | No | string |
campaign_name |
Nombre de la campaña | No | No | string |
tipo_de_engagement |
Diferencia entre clics e impresiones | Sí | No | string |
fuente_de_medios |
Fuente de medios atribuida a un evento o restringida (ver más) | Sí | No | string |
id_adset |
ID del anuncio | No | No | string |
ad_name |
Nombre del anuncio | No | No | string |
ad_type |
Ejemplo: banner, pie de página | No | No | string |
id_anuncio |
ID del conjunto de anuncios, identificando un grupo que contiene uno o más anuncios | No | No | string |
adset_name |
Nombre del conjunto de anuncios, identificando un grupo que contiene uno o más anuncios | No | No | string |
channel |
Canal de fuente de medios. Ejemplo: YouTube para Google, Instagram para Meta Ads | No | No | string |
Para más información sobre cómo preparar eventos in-app, consulte la sección Crear eventos in-app.
Crear eventos in-app
Para proporcionar datos de conversión y engagement a través de eventos in-app, configura el SDK de AppsFlyer integrado en tu aplicación. Para más información sobre la creación de eventos in-app, consulta:
Preparar archivos fuente personalizados
Si está realizando una campaña on-site, puedes utilizar archivos de origen personalizados como fuente de tus conversiones y engagement con el esquema que se indica en las tablas a seguir.
Utiliza el esquema de la tabla a seguir para crear un archivo fuente personalizado de conversión:
Utiliza el esquema de la tabla a seguir para crear un archivo fuente personalizado de conversión.
El esquema de conversión es único para los tipos de campaña off-site y on-site, y para los distintos Partners de medios.
Partners de medios seleccionados:
G: Google
M: Meta
Colores de fondo:
Campos obligatorios
Campos recomendados
Se requiere cualquiera de los campos seleccionados
Los campos se someten a Hashing según las reglas especificadas por SRN.
| Categoría | Parámetro | Descripción | Tipo de valor esperado | CMN | Socios de medios | |||
|---|---|---|---|---|---|---|---|---|
| Submotivo de bloqueo | Web | |||||||
| G | M | G | M | |||||
| Requerido | Ingresos asociados al SKU en la moneda indicada en el campo event_revenue_currency. |
Identificador único del evento. | string | ✓ | ✓ | ✓ | ✓ | ✓ |
| nombre_del_evento | Nombre o tipo del evento (por ejemplo, "purchase", "clic"). | string | ✓ | ✓ | ✓ | ✓ | ✓ | |
| event_time | Marca de tiempo de cuándo ocurrió el evento. | datetime | ✓ | ✓ | ✓ | ✓ | ✓ | |
| Información de la app | id_aplicación | Un ID de usuario de aplicación único establecido por el propietario de la aplicación. | string | ✓ | ✓ | ✓ | ||
| nombre_aplicación | Nombre de la aplicación. | string | ✓ | ✓ | ||||
| version_app | Número de versión de la aplicación. | string | ✓ | ✓ | ||||
| Validaciones de datos | facebook_browser_id | Identificador único para el tracking del navegador de Facebook. | string | ✓ | ✓ | |||
| facebook_cookie | Identificador de clic para la atribución de anuncios de Facebook. | string | ✓ | ✓ | ||||
| gbraid | Identificador de atribución de anuncios de Google. | string | ✓ | |||||
| google_click_id | ID único para el tracking de clics de anuncios de Google. | string | ✓ | ✓ | ||||
| wbraid | Identificador de atribución web de Google. | string | ✓ | |||||
| tiktok_id | Identificador único para el tracking de TikTok. | string | ||||||
| Datos de la campaña | id_campaña | Identificador único de la campaña de marketing. | string | ✓ | ||||
| install_id | Identificador del evento de instalación de la app. | string | ✓ | |||||
| Datos de conversión | sku | SKUs de los productos implicados en la conversión. | string | ✓ | ||||
| sku_quantity | Identificador único de un producto (SKU). | General | ✓ | |||||
| sku_revenue | Cantidad del SKU comprado o implicado. | decimal | ✓ | |||||
| ingresos_evento | Valor de ingresos utilizando la moneda de ingresos del evento. | decimal | ✓ | ✓ | ✓ | ✓ | ✓ | |
| event_currency | Moneda del importe de los ingresos. | decimal | ✓ | ✓ | ✓ | ✓ | ✓ | |
| Cadena | client_ip | Dirección IP del usuario o del dispositivo. | string | ✓ | ✓ | |||
| agente_de_usuario_del_cliente | Cadena de agente de usuario del dispositivo o navegador del usuario. | string | ✓ | ✓ | ✓ | |||
| categoría_del_dispositivo | Categoría del dispositivo del usuario (por ejemplo, móvil, escritorio). | string | ✓ | |||||
| platform (os?) | Sistema operativo del dispositivo del usuario (por ejemplo, iOS, Android). | string | ✓ | ✓ | ||||
| versión_sistema_operativo | Versión del sistema operativo del dispositivo. | string | ✓ | |||||
| ID de usuario | advertising_id | Identificador único para fines publicitarios (por ejemplo, IDFA). | string | ✓ | ||||
| appsflyer_id | Identificador único de la aplicación en AppsFlyer. | string | ✓ | |||||
| android_id | Identificador único del dispositivo Android. | string | ✓ | ✓ | ||||
| idfa | Establecido por el anunciante | string | ✓ | ✓ | ||||
| idfv | ID de proveedor proporcionado por iOS | string | ✓ | ✓ | ||||
| client_id | Identificador único de cliente (p. ej., generado por el sistema). | string | ✓ | ✓ | ✓ | |||
| facebook_hashed_client_id | no se han especificado reglas | string | ✓ | ✓ | ||||
| tiktok_hashed_client_id | recortar espacios, convertir a minúsculas | string | ||||||
| cookie | Datos de cookies del navegador para el tracking de usuario/sesión. | string | ||||||
| first_name | Nombre del usuario. | string | ✓ | ✓ | ✓ | |||
| last_name | Apellido del Usuario. | string | ✓ | ✓ | ✓ | |||
| phone_number | Número de teléfono del Usuario. | entero | ✓ | ✓ | ✓ | ✓ | ||
| date_of_birth | Fecha de nacimiento del Usuario. | datetime | ✓ | ✓ | ||||
| género | Sexo del Usuario. | string | ✓ | ✓ | ||||
| Indicador de atribución AF | Idioma o configuración regional preferidos del Usuario. | string | ✓ | |||||
| correo electrónico | Dirección de correo electrónico del Usuario. | string | ✓ | ✓ | ✓ | ✓ | ||
| tiktok_hashed_email | recortar, convertir a minúsculas, eliminar puntos de las direcciones de correo electrónico de Google | string | ||||||
| teléfono_con_hash_de_tiktok | E164 | string | ||||||
| correo_electrónico_con_hash_de_google | recortar, convertir a minúsculas, eliminar puntos de las direcciones de correo electrónico de Google | string | ✓ | ✓ | ||||
| teléfono_con_hash_de_google | E164 | string | ✓ | ✓ | ||||
| nombre_con_hash_de_google | recortar, en minúsculas | string | ✓ | |||||
| apellido_con_hash_de_google | recortar, en minúsculas | string | ✓ | |||||
| correo_electrónico_con_hash_de_facebook | recortar, en minúsculas | string | ✓ | ✓ | ||||
| teléfono_con_hash_de_facebook | formato personalizado (¿sin +?) | string | ✓ | ✓ | ||||
| facebook_hashed_first_name | todo en minúsculas, sin puntuación | string | ✓ | ✓ | ||||
| facebook_hashed_last_name | todo en minúsculas, sin puntuación | string | ✓ | ✓ | ||||
| facebook_hashed_date_of_birth | AAAAMMDD | string | ✓ | ✓ | ||||
| facebook_hashed_gender | se recomienda f/m, pero cualquier valor con Hashing es válido | string | ✓ | ✓ | ||||
| Atributos de usuario | att_status | Estado de App Tracking Transparency (ATT) para el consentimiento del usuario. | string | ✓ | ✓ | |||
| Cadena | Información del dispositivo | Región geográfica del usuario. | string | ✓ | ||||
| Ingresos por eventos en USD | Ciudad asociada al usuario. | string | ✓ | ✓ | ✓ | ✓ | ||
| state | Estado o provincia del Usuario. | string | ✓ | ✓ | ✓ | ✓ | ||
| código_de_país | Código ISO del país del Usuario. | string | ✓ | ✓ | ✓ | ✓ | ||
| zip_code | Código postal/ZIP del Usuario. | string | ✓ | ✓ | ✓ | |||
| calle | Dirección postal del Usuario (si está disponible). | string | ✓ | |||||
| google_hashed_street | recortar, en minúsculas | string | ✓ | |||||
| facebook_hashed_city | en minúsculas, sin signos de puntuación, sin espacios | string | ✓ | ✓ | ||||
| facebook_hashed_state | ANSI para EE. UU., en minúsculas, sin puntuación y sin espacios | string | ✓ | ✓ | ||||
| facebook_hashed_zip_code | reglas especiales para EE. UU./Reino Unido, en minúsculas, sin puntuación y sin espacios | string | ✓ | ✓ | ||||
| facebook_hashed_country_code | Código de país utilizando ISO 3166 (alpha-2). | string | ✓ | ✓ | ||||
| Datos de referencia/tráfico | referrer_url | URL del sitio que remitió al usuario a la página actual. | string | ✓ | ||||
| source_url | URL de la fuente donde el usuario interactuó por primera vez con la campaña. | string | ✓ | |||||
Obligatorio en la fuente de datos personalizada
Utiliza el siguiente esquema para crear la fuente de datos de engagement.
Nota:
Los campos de información personal identificable (PII) asignados en el esquema de fuentes de engagement deben tener una intersección no vacía con los PIIs asignados en el esquema de fuentes de conversión anterior.
| Campo | Descripción | Obligatorio | Tipo de valor esperado |
|---|---|---|---|
appsflyer_id |
ID único generado por el SDK cuando se instala la aplicación | Campo PII opcional. Uno de los campos PII es obligatorio. | string |
cuid |
ID de usuario único de la aplicación establecido por el propietario de la aplicación | Campo PII opcional. Uno de los campos PII es obligatorio. | string |
idfa |
ID de publicidad que el usuario puede restablecer en dispositivos iOS. Si no está disponible, se rellena con ceros | Campo PII opcional. Uno de los campos PII es obligatorio. | string |
idfv |
ID de proveedor proporcionado por iOS | Campo PII opcional. Uno de los campos PII es obligatorio. | string |
id_aplicación |
Identificador único de la aplicación en AppsFlyer. Ejemplo: iOS: id123456789 Android: com.appsflyer.referrersender
|
Opcional | string |
id_campaña |
ID de campaña | Obligatorio | string |
campaign_name |
Nombre de la campaña | Opcional | string |
fuente_de_medios |
Fuente de medios atribuida a un evento o restringida (ver más) | Obligatorio | string |
tipo_de_engagement |
Diferencia entre clics e impresiones | Obligatorio | string |
nombre_del_evento |
Establecido por el anunciante | Obligatorio | string |
event_time |
Hora del evento redondeada a la hora más cercana | Obligatorio | datetime |
nombre_aplicación |
Establecido por el anunciante | Opcional | string |
version_app |
Establecido por el anunciante | Opcional | string |
id_adset |
ID del anuncio | Opcional | string |
ad_name |
Nombre del anuncio | Opcional | string |
ad_type |
Ejemplo: banner, pie de página | Opcional | string |
id_anuncio |
ID del conjunto de anuncios, identificando un grupo que contiene uno o más anuncios | Opcional | string |
adset_name |
Nombre del conjunto de anuncios, identificando un grupo que contiene uno o más anuncios | Opcional | string |
channel |
Canal de fuente de medios. Ejemplo: YouTube para Google, Instagram para Meta Ads | Opcional | string |
Identificador de origen |
Plataforma del dispositivo: iOS, Android o Windows Mobile | Opcional | string |
Para más información sobre cómo preparar fuentes y cargarlas en tu servicio en la nube, consulta la sección Crear y conectar fuentes de datos personalizadas de este documento.
Preparar la fuente de mapeo de la campaña
La fuente de tus datos de mapeo de campaña es un archivo de fuente de datos personalizado con el esquema descrito en la tabla a seguir.
Nota:
Recomendamos utilizar un único archivo de asignación para todas las colaboraciones, ya que es más fácil de mantener y actualizar.
El esquema de mapeo de la campaña
Utiliza el siguiente esquema para crear la fuente de mapeo de campañas.
| Tipo de dato | Obligatorio | Valor esperado | Descripción |
|---|---|---|---|
| collaborator_name | Sí | string | El nombre del colaborador con el que trabajas. |
| collaborator_id | Sí | string | Un identificador único para el colaborador. |
| id_campaña | Sí | string | El identificador único de la campaña. |
| conversion_targets | Sí | cadena de caracteres | Un parámetro que espera una lista separada por comas de las SKUs de destino de la campaña, por ejemplo, sku1, sku2, etc. |
| campaign_name | No | string | El nombre de la campaña. |
Para más información sobre cómo crear archivos fuente y subirlos a tu servicio en la nube, consulta la sección Crear y conectar fuentes de datos personalizadas de este documento.
Flujo de ingestión de trabajos de atribución
Cada trabajo de atribución se dedica a un solo día y se ejecuta una vez finalizado. Al principio de este proceso, la tarea ingiere las conversiones, las interacciones y los datos de mapeo de campaña relevantes del servicio en la nube o de los eventos in-app.
Introducción de fuentes de mapeo de campañas
Antes de cada ejecución de atribución, DCP carga los registros de asignación de campaña de las fuentes personalizadas. Puedes elegir entre dos modos para cargar estos registros:
-
Estrategia del último día: DCP toma los registros más recientes en función de la fecha de carga de los registros.
Por ejemplo, si la fuente contiene registros con fechas de carga del 18 de enero, 17 de enero o 29 de diciembre, el sistema seleccionará los registros con la fecha del 18 de enero.
- Estrategia diaria: DCP sólo toma los registros cuya fecha de carga coincide con el día de la ejecución de la atribución. Por ejemplo, si la ejecución se produce a medianoche del 19 de enero, el sistema sólo seleccionará los registros de campaña con la fecha de carga del 19 de enero.
Introducción de fuentes de conversión
Al final de cada día, DCP ejecuta el trabajo de atribución de ese día sólo si puede acceder a la carpeta dedicada a ese día y a los registros de conversión que contiene. Sin embargo, puede cargar la carpeta de un día determinado más adelante. Por ejemplo, puede cargar la carpeta del 17 de enero el 22 de enero.
- Al final de cada día, DCP ejecuta el trabajo de atribución de ese día. El trabajo se ejecutará sólo si DCP puede encontrar la carpeta para ese día. El nombre de la carpeta es idéntico al nombre del día.
- La carpeta del día puede incluir registros de eventos que se remontan a 30 días desde el día de la carpeta. Por ejemplo, en la carpeta Ene 17, el trabajo procesa los registros del 18 de diciembre al 17 de enero.
- Si omites subir la carpeta de un día determinado, dispones de 30 días para subirla. Por ejemplo, si te saltaste subir la carpeta del 17 de enero, puedes subirla hasta el 17 de febrero. No obstante, recomendamos subirla lo más cerca posible de la fecha de la carpeta.
- Si DCP no encuentra la carpeta del día actual, continuará buscando la carpeta cada 10 minutos durante los 7 días siguientes.
Introducción de fuentes de engagement
Para cada registro de conversión, DCP busca los eventos de engagement que la desencadenaron.
- Los registros de engagement se incluyen en carpetas fechadas. Sin embargo, no tienes que cargar una carpeta de engagement para cada día. Por ejemplo, puedes cargar las carpetas Ene 13 y Ene 15 sin cargar la carpeta Ene 14. En este ejemplo, los registros de Ene 14 se tomarán de la carpeta Ene 15.
- El trabajo de atribución para una carpeta de conversión determinada sólo se iniciará si existe una carpeta de engagement con la misma fecha que la carpeta de conversión o una fecha posterior. Por ejemplo, el trabajo de atribución para la carpeta de conversión del 17 de enero sólo se iniciará si existe la carpeta de engagement Ene 17 o carpetas con fechas posteriores, como Ene 18.
- El trabajo de atribución recopila todos los eventos de engagement que caen dentro de la ventana de lookback del engagement.
Introducción de datos in-app
Los datos de conversión y engagement pueden proceder de eventos in-app, fuentes personalizadas o una combinación de ambas. DCP te permite elegir entre utilizar un único modo o mezclarlos, permitiendo que las conversiones procedan de eventos in-app mientras que los engagements se obtengan de archivos personalizados, o viceversa.
Al configurar eventos in-app para conversiones, engagements o ambos, debes especificar el ID de la aplicación y el nombre del evento de conversión o engagement. Al final del día, el trabajo de atribución selecciona todos los eventos con el nombre y el ID de aplicación especificados que tengan la misma fecha de evento que el día de conversión.
Crear y conectar fuentes de datos personalizadas
Para conectar datos a través de fuentes personalizadas, el cliente deberá seguir primero las instrucciones de los siguientes artículos de la base de conocimientos de DCP:
- Plataforma de colaboración de datos - Configura tus servicios en la nube
- Plataforma de colaboración de datos - Añadir conexiones
- Plataforma de colaboración de datos: crea y gestiona fuentes
This article was translated automatically and may contain errors. The English version is the most accurate - use the language selector below to switch.