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.

General

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 Requerido Disponible en el esquema de eventos in-app Tipo
campaign_id ID de campaña No string
campaign_name Nombre de la campaña No No string
engagement_type Diferencia entre clics e impresiones No string
media_source Fuente de medios atribuida a un evento o restringida (ver más) No string
ad_id 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
adset_id 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.

El esquema de fuentes de conversión

Utiliza el esquema de la tabla a seguir para crear un archivo fuente personalizado de conversión:

Campo Descripción Obligatorio en la fuente de datos personalizada Tipo de valor esperado Validaciones de datos
appsflyer_id Un ID único generado por el SDK cuando se instala la aplicación. Se utiliza para atribuir eventos in-app, obtener datos de conversión y afiliar eventos in-app. Se genera un nuevo ID si la aplicación se elimina y se reinstala. Restaurar la aplicación desde una copia de seguridad de iCloud no se considera una instalación. Para CTV, este campo se completa con el custom_device_id gestionado por el anunciante. Campo PII opcional. Uno de los campos PII es obligatorio. string Ninguno
advertising_id ID de dispositivo reajustable por el usuario, también conocido como GAID. Para CTV, este es el ID de CTV, por ejemplo, RIDA o VIDA. Campo PII opcional. Uno de los campos PII es obligatorio. string Ninguno
cuid Un ID de usuario de aplicación único establecido por el propietario de la aplicación. Campo PII opcional. Uno de los campos PII es obligatorio. string Ninguno
android_id ID permanente del dispositivo Campo PII opcional. Uno de los campos PII es obligatorio. string Ninguno
idfa ID de publicidad que el usuario puede restablecer en dispositivos iOS. Si idfa no está disponible, normalmente se rellena con ceros. Campo PII opcional. Uno de los campos PII es obligatorio. string Ninguno
idfv ID de proveedor proporcionado por iOS Campo PII opcional. Uno de los campos PII es obligatorio. string Ninguno
event_name El tipo de evento de atribución o el nombre del evento in-app enviado por la aplicación. Ejemplos de tipos de eventos: instalación, reengagement, etc. Para Data Locker en los reportes de retargeting: retargeting significa reengagement, e instalación significa reatribución. Para SKAN, el nombre del evento in-app está configurado en AppsFlyer o Meta Ads. Obligatorio string Ninguno
event_time Hora del evento, redondeada hacia abajo a la hora más cercana. Obligatorio datetime Ninguno
sku El ID del SKU de uno de los artículos incluidos en el evento de conversión. Obligatorio string Ninguno
sku_quantity Número de unidades SKU incluidas en el evento de conversión. Obligatorio entero Ninguno
app_id Identificador único de la aplicación en AppsFlyer. Ejemplo: iOS: id123456789, Android: com.appsflyer.referrersender Opcional string Ninguno
app_name Establecido por el anunciante Opcional string Ninguno
app_version Establecido por el anunciante Opcional string Ninguno
city La ubicación más detallada del usuario basada en la IP del dispositivo. Suele contener el nombre de una ciudad, pero también puede incluir distritos o barrios. Opcional string Ninguno
country_code Código de país utilizando ISO 3166 (alpha-2). Ejemplo: US, CN. Nota: El Reino Unido se muestra como UK (no GB).  Opcional string Ninguno
device_category Los valores posibles incluyen: phone, tablet u other. Opcional string Ninguno
event_currency El código de moneda de los ingresos del evento reportado al SDK. Opcional string estructura datetime conforme a los requisitos del formato DCR
event_revenue Valor de ingresos utilizando la moneda de ingresos del evento. Las cantidades fuera del rango de $-10.000 a $+10.000 (o equivalente) aparecen en los datos en bruto pero no en los reportes agregados. Opcional decimal Ninguno
platform Plataforma del dispositivo: iOS, Android o Windows Mobile Opcional string Ninguno
region Basado en la dirección IP del dispositivo reportada por el SDK. Para SKAN, determinado de acuerdo con el country_code. Opcional string Ninguno
sku_revenue Ingresos asociados al SKU en la moneda indicada en el campo event_revenue_currency. Opcional decimal Ninguno
state Basado en la dirección IP del dispositivo reportada por el SDK. Opcional string Ninguno

El esquema de fuentes de engagement

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 Requerido 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
app_id Identificador único de la aplicación en AppsFlyer. Ejemplo: iOS: id123456789 Android: com.appsflyer.referrersender Opcional string
campaign_id ID de campaña Obligatorio string
campaign_name Nombre de la campaña Opcional string
media_source Fuente de medios atribuida a un evento o restringida (ver más) Obligatorio string
engagement_type Diferencia entre clics e impresiones Obligatorio string
event_name Establecido por el anunciante Obligatorio string
event_time Hora del evento redondeada a la hora más cercana Obligatorio datetime
app_name Establecido por el anunciante Opcional string
app_version Establecido por el anunciante Opcional string
ad_id ID del anuncio Opcional string
ad_name Nombre del anuncio Opcional string
ad_type Ejemplo: banner, pie de página Opcional string
adset_id 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
platform 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 ¿Requerido? Valor esperado Descripción
collaborator_name string El nombre del colaborador con el que trabajas.
collaborator_id string Un identificador único para el colaborador.
campaign_id 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.

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: