¿Cómo podemos ayudar?

Plataforma de colaboración de datos (DCP) - Prepara la medición de la colaboración

  • Actualización

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: