How can we help?

Plataforma de colaboración de datos (DCP) - Prepara la medición de la colaboració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 No string
campaign_name Nombre de la campaña No No string
tipo_de_engagement Diferencia entre clics e impresiones No string
fuente_de_medios Fuente de medios atribuida a un evento o restringida (ver má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 string El nombre del colaborador con el que trabajas.
collaborator_id string Un identificador único para el colaborador.
id_campaña string El identificador único de la campaña.
conversion_targets 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:

This article was translated automatically and may contain errors. The English version is the most accurate - use the language selector below to switch.