Preparación de datos para su uso en Intelligent Services

Última actualización: 2023-05-24
  • Creado para:
  • Developer
    User
    Admin
    Leader

Para que Intelligent Services para descubrir información de los datos de eventos de marketing, los datos deben enriquecerse semánticamente y mantenerse en una estructura estándar. Intelligent Services uso Experience Data Model (XDM) para conseguirlo. Concretamente, todos los conjuntos de datos que se utilizan en Intelligent Services debe ajustarse al esquema XDM de Consumer ExperienceEvent (CEE) o utilizar el conector de Adobe Analytics. Además, la inteligencia artificial aplicada al cliente admite el conector de Adobe Audience Manager.

Este documento proporciona orientación general sobre la asignación de los datos de eventos de marketing de varios canales al esquema CEE, y describe información sobre campos importantes dentro del esquema para ayudarle a determinar cómo asignar de forma eficaz los datos a su estructura. Si planea utilizar los datos de Adobe Analytics, consulte la sección de Preparación de datos de Adobe Analytics. Si planea utilizar los datos de Adobe Audience Manager (solo inteligencia artificial aplicada al cliente), consulte la sección de Adobe Preparación de datos de Audience Manager.

Requisitos de datos

Intelligent Services requieren distintas cantidades de datos históricos en función del objetivo que cree. Independientemente, los datos para los que se prepare todo Intelligent Services debe incluir eventos/recorridos de clientes positivos y negativos. Tener eventos negativos y positivos mejora la precisión y la precisión del modelo.

Por ejemplo, si utiliza la inteligencia artificial aplicada al cliente para predecir la tendencia a comprar un producto, el modelo para la inteligencia artificial aplicada al cliente necesita tanto ejemplos de rutas de compra exitosas como ejemplos de rutas fallidas. Esto se debe a que durante la formación del modelo, la inteligencia artificial aplicada al cliente busca comprender qué eventos y recorridos conducen a una compra. Esto también incluye las acciones realizadas por los clientes que no realizaron ninguna compra, como por ejemplo una persona que detuvo su recorrido al agregar un artículo al carro de compras. Estos clientes pueden mostrar comportamientos similares; sin embargo, la inteligencia artificial aplicada al cliente puede proporcionar perspectivas y explorar en profundidad las principales diferencias y factores que conducen a una puntuación de tendencia más alta. Del mismo modo, Attribution AI requiere ambos tipos de eventos y recorridos para mostrar métricas como la efectividad de los puntos de contacto, las rutas de conversión principales y los desgloses por posición de punto de contacto.

Para obtener más ejemplos e información sobre los requisitos de datos históricos, visite la Inteligencia artificial aplicada al cliente o Attribution AI sección de requisitos de datos históricos en la documentación de entrada/salida.

Directrices para vincular datos

Se recomienda vincular los eventos de un usuario a un ID común siempre que sea posible. Por ejemplo: es posible que tenga datos de usuario con "id1" en 10 eventos. Posteriormente, el mismo usuario eliminó el ID de cookie y se registró como "id2" en los 20 eventos siguientes. Si sabe que id1 e id2 corresponden al mismo usuario, se recomienda unir los 30 eventos con un ID común.

Si esto no es posible, debe tratar cada conjunto de eventos como un usuario diferente al crear los datos de entrada del modelo. Esto garantiza los mejores resultados durante la formación y la puntuación del modelo.

Resumen del flujo de trabajo

El proceso de preparación varía en función de si los datos se almacenan en Adobe Experience Platform o externamente. Esta sección resume los pasos necesarios que debe seguir, en cualquiera de los casos.

Preparación de datos externos

Si los datos se almacenan fuera de Experience Platform, debe asignar los datos a los campos obligatorios y relevantes en una Esquema de Evento de experiencia del consumidor. Este esquema se puede ampliar con grupos de campos personalizados para capturar mejor los datos de los clientes. Una vez asignado, puede crear un conjunto de datos con el esquema Consumer ExperienceEvent y ingesta de datos en Platform. A continuación, se puede seleccionar el conjunto de datos de CEE al configurar una Intelligent Service.

Según la variable Intelligent Service Si desea utilizar, es posible que se requieran diferentes campos. Tenga en cuenta que es recomendable agregar datos a un campo si tiene los datos disponibles. Para obtener más información sobre los campos obligatorios, visite la Attribution AI o Inteligencia artificial aplicada al cliente guía de requisitos de datos.

Preparación de datos de Adobe Analytics

Attribution AI La inteligencia artificial aplicada al cliente y la compatibilidad nativa con datos de Adobe Analytics. Para utilizar datos de Adobe Analytics, siga los pasos descritos en la documentación para configurar un Conector de origen de Analytics.

Una vez que el conector de origen transmite los datos a Experience Platform, puede seleccionar Adobe Analytics como fuente de datos seguida de un conjunto de datos durante la configuración de la instancia. Todos los grupos de campos de esquema requeridos y los campos individuales se crean automáticamente durante la configuración de la conexión. No es necesario extraer, transformar o cargar los conjuntos de datos en el formato CEE.

Si compara los datos volados a través del conector de origen de Adobe Analytics en Adobe Experience Platform con los datos de Adobe Analytics, puede observar algunas discrepancias. El conector de origen de Analytics podría soltar filas durante la transformación a un esquema Experience Data Model (XDM). Puede haber varias razones para que toda la fila no sea apta para la transformación, como marcas de tiempo que faltan, personID que faltan, ID de persona no válidos o grandes, valores de análisis no válidos y más.

Para obtener más información y ejemplos, visite la documentación de comparación de datos de Adobe Analytics y Customer Journey Analytics. Este artículo se ha diseñado para ayudarle a diagnosticar y resolver esas diferencias, de modo que usted y su equipo puedan utilizar los datos de Adobe Experience Platform para servicios inteligentes sin impedimentos por motivos de integridad de los datos.

En Adobe Experience Platform Query Services, ejecute la siguiente consulta Registros totales entre la marca de tiempo de inicio y de fin por channel.typeAtSource para buscar el recuento por canales de marketing.

       Count(_id) AS Records
FROM  df_hotel
WHERE timestamp>=from_utc_timestamp('2021-05-15','UTC')
        AND timestamp<from_utc_timestamp('2022-01-10','UTC')
        AND timestamp IS NOT NULL
        AND enduserids._experience.aaid.id IS NOT NULL
GROUP BY channel.typeAtSource
IMPORTANTE

El conector de Adobe Analytics tarda hasta cuatro semanas en rellenar los datos. Si ha configurado recientemente una conexión, debe comprobar que el conjunto de datos tiene la longitud mínima de datos necesaria para el cliente o el Attribution AI. Revise las secciones de datos históricos en Inteligencia artificial aplicada al cliente o Attribution AIy compruebe que tiene datos suficientes para el objetivo de predicción.

Preparación de datos de Adobe Audience Manager (solo inteligencia artificial aplicada al cliente)

La inteligencia artificial aplicada al cliente admite datos de Adobe Audience Manager de forma nativa. Para utilizar datos de Audience Manager, siga los pasos descritos en la documentación para configurar un Conector de origen del Audience Manager.

Una vez que el conector de origen transmite los datos a Experience Platform, puede seleccionar Adobe Audience Manager como fuente de datos seguida de un conjunto de datos durante la configuración de la inteligencia artificial aplicada al cliente. Todos los grupos de campos de esquema y los campos individuales se crean automáticamente durante la configuración de la conexión. No es necesario extraer, transformar o cargar los conjuntos de datos en el formato CEE.

IMPORTANTE

Si ha configurado recientemente un conector, debe verificar que el conjunto de datos tenga la longitud mínima de datos requerida. Consulte la sección de datos históricos en la documentación de entrada/salida para la inteligencia artificial aplicada al cliente y compruebe que tiene datos suficientes para el objetivo de predicción.

Experience Platform preparación datos

Si los datos ya están almacenados en Platform y no transmitir a través de los conectores de origen de Adobe Analytics o Adobe Audience Manager (solo inteligencia artificial aplicada al cliente), siga los pasos a continuación. Se recomienda que entienda el esquema de CEE.

  1. Revise la estructura del Esquema de Evento de experiencia del consumidor y determinar si los datos se pueden asignar a sus campos.
  2. Póngase en contacto con los servicios de consultoría de Adobe para asignar los datos al esquema e ingerirlos en Intelligent Services, o siga los pasos de esta guía si desea asignar los datos usted mismo.

Explicación del esquema CEE

El esquema Consumer ExperienceEvent describe el comportamiento de una persona en relación con los eventos de marketing digital (web o móvil), así como la actividad de comercio en línea o sin conexión. El uso de este esquema es necesario para Intelligent Services debido a sus campos (columnas) semánticamente bien definidos, evitando nombres desconocidos que, de lo contrario, harían que los datos fueran menos claros.

El esquema CEE, como todos los esquemas XDM ExperienceEvent, captura el estado basado en series temporales del sistema cuando se produjo un evento (o conjunto de eventos), incluido el momento y la identidad del sujeto involucrado. Los eventos de experiencia son registros de hechos de lo que ha ocurrido y, por lo tanto, son inmutables y representan lo que ha sucedido sin agregación ni interpretación.

Intelligent Services utilice varios campos clave dentro de este esquema para generar perspectivas a partir de los datos de eventos de marketing, los cuales se pueden encontrar en el nivel raíz y ampliar para mostrar sus subcampos obligatorios.

Al igual que todos los esquemas XDM, el grupo de campos de esquema CEE es extensible. En otras palabras, se pueden añadir campos adicionales al grupo de campos CEE, y se pueden incluir diferentes variaciones en varios esquemas si es necesario.

Puede encontrar un ejemplo completo del grupo de campos en la repositorio XDM público. Además, puede ver y copiar lo siguiente Archivo JSON para ver un ejemplo de cómo se pueden estructurar los datos para cumplir con el esquema CEE. Consulte ambos ejemplos a medida que aprenda sobre los campos clave descritos en la sección siguiente para determinar cómo puede asignar sus propios datos al esquema.

Campos clave

Hay varios campos clave dentro del grupo de campos de Europa central y oriental que deben utilizarse para Intelligent Services para generar perspectivas útiles. En esta sección se describe el caso de uso y los datos esperados para estos campos, y se proporcionan vínculos a documentación de referencia para ver más ejemplos.

Campos obligatorios

Aunque se recomienda encarecidamente el uso de todos los campos clave, hay dos campos que obligatorio para que Intelligent Services para trabajar:

Identidad principal

Uno de los campos del esquema debe configurarse como campo de identidad principal, lo que permite Intelligent Services para vincular cada instancia de datos de series temporales a una persona individual.

Debe determinar el mejor campo para utilizarlo como identidad principal en función del origen y la naturaleza de los datos. Un campo de identidad debe incluir un área de nombres de identidad que indica el tipo de datos de identidad que el campo espera como valor. Algunos valores de área de nombres válidos incluyen:

NOTA

El ID del Experience Cloud (ECID) también se conoce como MCID y sigue utilizándose en áreas de nombres.

  • "email"
  • "phone"
  • "mcid" (para Adobe Audience Manager ID)
  • "aaid" (para Adobe Analytics ID)

Si no está seguro de qué campo debe utilizar como identidad principal, póngase en contacto con Servicios de consultoría de Adobe para determinar la mejor solución. Si no se define una identidad principal, la aplicación Servicio inteligente utilizará el siguiente comportamiento predeterminado:

Predeterminado Inteligencia artificial aplicada a la atribución Inteligencia artificial aplicada al cliente
Columna de identidad endUserIDs._experience.aaid.id endUserIDs._experience.mcid.id
Área de nombres AAID ECID

Para establecer una identidad principal, vaya al esquema desde el Esquemas y seleccione el hipervínculo del nombre del esquema para abrir Schema Editor.

Navegar al esquema

A continuación, vaya al campo que desee utilizar como identidad principal y selecciónelo. El Propiedades del campo se abre el menú para ese campo.

Seleccione el campo

En el Propiedades del campo , desplácese hacia abajo hasta que encuentre el Identidad casilla de verificación Después de marcar la casilla, seleccione la opción para establecer la identidad seleccionada como Identidad principal aparece. Seleccione también esta casilla.

Seleccionar casilla

A continuación, debe proporcionar un Área de nombres de identidad de la lista de áreas de nombres predefinidas en el menú desplegable. En este ejemplo, el área de nombres ECID está seleccionada desde un Adobe Audience Manager ID mcid.id se está utilizando. Seleccionar Aplicar para confirmar las actualizaciones, seleccione Guardar en la esquina superior derecha para guardar los cambios en el esquema.

Guarde los cambios

xdm:timestamp

Este campo representa la fecha y hora a la que se produjo el evento. Este valor debe proporcionarse como una cadena, según la norma ISO 8601.

xdm:channel

NOTA

Este campo solo es obligatorio cuando se utiliza el Attribution AI.

Este campo representa el canal de marketing relacionado con ExperienceEvent. El campo incluye información sobre el tipo de canal, el tipo de medios y el tipo de ubicación.

Esquema de ejemplo

{
  "@id": "https://ns.adobe.com/xdm/channels/facebook-feed",
  "@type": "https://ns.adobe.com/xdm/channel-types/social",
  "xdm:mediaType": "earned",
  "xdm:mediaAction": "clicks"
}

Para obtener información completa sobre cada uno de los subcampos obligatorios de xdm:channel, consulte la esquema de canal de experiencia Especificación. Para ver algunas asignaciones de ejemplo, consulte la tabla siguiente.

Ejemplo de asignaciones de canales

En la tabla siguiente se proporcionan algunos ejemplos de canales de marketing asignados al xdm:channel esquema:

Canal @type mediaType mediaAction
Búsqueda de pago https://ns.adobe.com/xdm/channel-types/search pagado clicks
Social - Marketing https://ns.adobe.com/xdm/channel-types/social merecido clicks
Mostrar https://ns.adobe.com/xdm/channel-types/display pagado clicks
Correo electrónico https://ns.adobe.com/xdm/channel-types/email pagado clicks
Referente interno https://ns.adobe.com/xdm/channel-types/direct de propiedad clicks
Mostrar vista completa https://ns.adobe.com/xdm/channel-types/display pagado impresiones
Redirección de código QR https://ns.adobe.com/xdm/channel-types/direct de propiedad clicks
Dispositivo móvil https://ns.adobe.com/xdm/channel-types/mobile de propiedad clicks

Campos recomendados

El resto de los campos clave se describen en esta sección. Aunque estos campos no son necesariamente obligatorios para Intelligent Services para funcionar, se recomienda encarecidamente que utilice tantos como sea posible para obtener perspectivas más ricas.

xdm:productListItems

Este campo es una matriz de artículos que representan los productos seleccionados por un cliente, incluido el SKU del producto, el nombre, el precio y la cantidad.

Esquema de ejemplo

[
  {
    "xdm:SKU": "1002352692",
    "xdm:name": "24-Watt 8-Light Chrome Integrated LED Bath Light",
    "xdm:currencyCode": "USD",
    "xdm:quantity": 1,
    "xdm:priceTotal": 159.45
  },
  {
    "xdm:SKU": "3398033623",
    "xdm:name": "16ft RGB LED Strips",
    "xdm:currencyCode": "USD",
    "xdm:quantity": 1,
    "xdm:priceTotal": 79.99
  }
]

Para obtener información completa sobre cada uno de los subcampos obligatorios de xdm:productListItems, consulte la esquema de detalles de commerce Especificación.

xdm:commerce

Este campo contiene información específica de comercio sobre ExperienceEvent, incluido el número de orden de compra y la información de pago.

Esquema de ejemplo

{
    "xdm:order": {
      "xdm:purchaseID": "a8g784hjq1mnp3",
      "xdm:purchaseOrderNumber": "123456",
      "xdm:payments": [
        {
          "xdm:transactionID": "transactid-a111",
          "xdm:paymentAmount": 59,
          "xdm:paymentType": "credit_card",
          "xdm:currencyCode": "USD"
        },
        {
          "xdm:transactionId": "transactid-a222",
          "xdm:paymentAmount": 100,
          "xdm:paymentType": "gift_card",
          "xdm:currencyCode": "USD"
        }
      ],
      "xdm:currencyCode": "USD",
      "xdm:priceTotal": 159
    },
    "xdm:purchases": {
      "xdm:value": 1
    }
  }

Para obtener información completa sobre cada uno de los subcampos obligatorios de xdm:commerce, consulte la esquema de detalles de commerce Especificación.

xdm:web

Este campo representa los detalles web relacionados con el ExperienceEvent, como la interacción, los detalles de página y el referente.

Esquema de ejemplo

{
  "xdm:webPageDetails": {
    "xdm:siteSection": "Shopping Cart",
    "xdm:server": "example.com",
    "xdm:name": "Purchase Confirmation",
    "xdm:URL": "https://www.example.com/orderConf",
    "xdm:errorPage": false,
    "xdm:homePage": false,
    "xdm:pageViews": {
      "xdm:value": 1
    }
  },
  "xdm:webReferrer": {
    "xdm:URL": "https://www.example.com/checkout",
    "xdm:referrerType": "internal"
  }
}

Para obtener información completa sobre cada uno de los subcampos obligatorios de xdm:productListItems, consulte la Esquema de detalles web de ExperienceEvent Especificación.

xdm:marketing

Este campo contiene información relacionada con las actividades de marketing que están activas con el punto de contacto.

Esquema de ejemplo

{
  "xdm:trackingCode": "marketingcampaign111",
  "xdm:campaignGroup": "50%_DISCOUNT",
  "xdm:campaignName": "50%_DISCOUNT_USA"
}

Para obtener información completa sobre cada uno de los subcampos obligatorios de xdm:productListItems, consulte la esquema de marketing Especificación.

Asignación e ingesta de datos

Una vez que haya determinado si los datos de eventos de marketing se pueden asignar al esquema CEE, el siguiente paso es determinar qué datos desea introducir en Intelligent Services. Todos los datos históricos utilizados en Intelligent Services debe encontrarse dentro del período mínimo de cuatro meses de datos, más el número de días que se pretende que sean como un período retroactivo.

Después de decidir el rango de datos que desea enviar, póngase en contacto con los servicios de consultoría de Adobe para que le ayuden a asignar los datos al esquema e ingerirlos en el servicio.

Si tiene un Adobe Experience Platform y desea asignar e introducir los datos usted mismo, siga los pasos descritos en la sección siguiente.

Uso de Adobe Experience Platform

NOTA

Los pasos siguientes requieren una suscripción a Experience Platform. Si no tiene acceso a Platform, vaya al pasos siguientes sección.

Esta sección describe el flujo de trabajo para asignar e ingerir datos en Experience Platform para su uso en Intelligent Services, incluidos vínculos a tutoriales para ver los pasos detallados.

Crear un esquema y un conjunto de datos de CEE

Cuando esté listo para empezar a preparar los datos para la ingesta, el primer paso es crear un nuevo esquema XDM que emplee el grupo de campos CEE. Los siguientes tutoriales explican el proceso de creación de un nuevo esquema en la IU o API de:

IMPORTANTE

Los tutoriales anteriores siguen un flujo de trabajo genérico para crear un esquema. Al elegir una clase para el esquema, debe utilizar la variable clase XDM ExperienceEvent. Una vez elegida esta clase, puede añadir el grupo de campos CEE al esquema.

Después de agregar el grupo de campos CEE al esquema, puede agregar otros grupos de campos según sea necesario para campos adicionales dentro de los datos.

Una vez creado y guardado el esquema, puede crear un nuevo conjunto de datos basado en ese esquema. Los siguientes tutoriales explican el proceso de creación de un nuevo conjunto de datos en la IU o API de:

Una vez creado el conjunto de datos, puede encontrarlo en la interfaz de usuario de Platform dentro de la variable Conjuntos de datos workspace.

Añadir campos de identidad al conjunto de datos

Si va a traer datos de Adobe Audience Manager, Adobe Analytics, u otra fuente externa, tiene la opción de establecer un campo de esquema como campo de identidad. Para establecer un campo de esquema como campo de identidad, consulte la sección sobre la configuración de campos de identidad dentro del Tutorial de IU o Tutorial de API para crear un esquema.

Si está introduciendo datos desde un archivo CSV local, puede pasar a la siguiente sección sobre asignación e ingesta de datos.

Asignación e ingesta de datos

Después de crear un esquema y un conjunto de datos de CEE, puede empezar a asignar las tablas de datos al esquema e introducir esos datos en Platform. Consulte el tutorial sobre asignación de un archivo CSV a un esquema XDM para obtener información sobre cómo realizar esto en la interfaz de usuario. Puede utilizar lo siguiente archivo JSON de muestra para probar el proceso de ingesta antes de utilizar sus propios datos.

Una vez que se ha rellenado un conjunto de datos, se puede utilizar el mismo conjunto de datos para introducir archivos de datos adicionales.

Si los datos se almacenan en una aplicación de terceros compatible, también puede optar por crear una conector de origen para introducir los datos de eventos de marketing en Platform en tiempo real.

Pasos siguientes

Este documento proporciona instrucciones generales para preparar los datos para su uso en Intelligent Services. Si necesita asesoramiento adicional basado en su caso de uso, póngase en contacto con el servicio de asistencia de Adobe.

Una vez que haya rellenado correctamente un conjunto de datos con los datos de experiencia del cliente, puede utilizar Intelligent Services para generar perspectivas. Consulte los siguientes documentos para empezar:

En esta página