Show Menu
TEMAS×

Preparación de datos para su uso en Servicios inteligentes

Para que los servicios inteligentes puedan descubrir perspectivas a partir de los datos de eventos de marketing, los datos deben enriquecirse y mantenerse semánticamente en una estructura estándar. Los servicios inteligentes aprovechan los esquemas del modelo de datos de experiencia (XDM) para lograr esto. Específicamente, todos los conjuntos de datos que se utilizan en Servicios inteligentes deben cumplir el esquema XDM de Consumer ExperienceEvent (CEE) .
Este documento proporciona una guía general sobre cómo asignar los datos de eventos de marketing de varios canales a este esquema, esbozando información sobre los campos importantes dentro del esquema para ayudarle a determinar cómo asignar los datos de manera efectiva a su estructura.

Resumen de 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. En esta sección se resumen los pasos necesarios que debe seguir, en cualquier caso.

Preparación de datos externos

Si los datos se almacenan fuera de Experience Platform, siga los pasos a continuación:
  1. Póngase en contacto con los servicios de consultoría de Adobe para solicitar las credenciales de acceso para un contenedor de Almacenamiento de blob de Azure dedicado.
  2. Con las credenciales de acceso, cargue los datos en el contenedor Blob.
  3. Póngase en contacto con los servicios de consultoría de Adobe para asignar los datos al esquema Explicación del esquema de CEE Consumer ExperienceEvent e incorporarlos a los servicios inteligentes.

Experience Platform preparación de datos

Si los datos ya están almacenados en Platform, siga los pasos a continuación:
  1. Revise la estructura del esquema Explicación del esquema de CEE Consumer ExperienceEvent y determine si los datos se pueden asignar a sus campos.
  2. Póngase en contacto con los servicios de consultoría de Adobe para ayudarle a asignar los datos al esquema e incorporarlos a los servicios inteligentes, o siga los pasos de esta guía si desea asignarlos usted mismo.

Explicación del esquema de CEE

El esquema Consumer ExperienceEvent describe el comportamiento de una persona en relación con eventos de marketing digital (web o móvil), así como con la actividad comercial en línea o sin conexión. El uso de este esquema es necesario para Servicios Inteligentes debido a sus campos (columnas) semánticamente bien definidos, evitando nombres desconocidos que de otra manera harían que los datos fueran menos claros.
Los servicios inteligentes utilizan varios campos clave dentro de este esquema para generar perspectivas a partir de los datos de sus eventos de marketing, todos los cuales se pueden encontrar en el nivel raíz y se expanden para mostrar los subcampos requeridos.
Al igual que todos los esquemas XDM, la mezcla CEE es extensible. En otras palabras, se pueden agregar campos adicionales a la mezcla CEE y, si es necesario, se pueden incluir variaciones diferentes en varios esquemas.
Puede encontrarse un ejemplo completo de la mezcla en el repositorio XDM público y debe utilizarse como referencia para los campos clave descritos en la sección siguiente.

Campos clave

Las secciones siguientes destacan los campos clave dentro de la combinación de CEE que deben utilizarse para que los servicios inteligentes generen perspectivas útiles, incluyendo descripciones y vínculos a documentación de referencia para más ejemplos.
El xdm:channel campo (que se explica en la primera sección) es necesario para que la API de atribución funcione con los datos, mientras que la AI del cliente no tiene campos obligatorios. Todos los demás campos clave son muy recomendables, pero no obligatorios.

xdm:canal

Este campo representa el canal de marketing relacionado con ExperienceEvent. El campo incluye información sobre el tipo de canal, el tipo de medio y el tipo de ubicación. Este campo _debe_proporcionarse para que la API de atribución funcione con sus datos .
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 para xdm:channel , consulte las especificaciones del esquema de canal de experiencia. Para ver algunos ejemplos de asignaciones, consulte la tabla siguiente .

Asignaciones de canal de ejemplo

En la tabla siguiente se proporcionan algunos ejemplos de canales de marketing asignados al xdm:channel esquema:
Channel
@type
mediaType
mediaAction
Búsqueda de pago
https:/ /ns.adobe.com/xdm/canal-types/search
pagado
clicks
Social - Marketing
https:/ /ns.adobe.com/xdm/canal-types/social
ganado
clicks
Mostrar
https:/ /ns.adobe.com/xdm/canal-types/display
pagado
clicks
Correo electrónico
https:/ /ns.adobe.com/xdm/canal-types/email
pagado
clicks
Remitente del reenvío interno
https:/ /ns.adobe.com/xdm/canal-types/direct
propiedad
clicks
Visualización de visualizaciones
https:/ /ns.adobe.com/xdm/canal-types/display
pagado
impresiones
Redirección de código QR
https:/ /ns.adobe.com/xdm/canal-types/direct
propiedad
clicks
Dispositivo móvil
https:/ /ns.adobe.com/xdm/canal-types/mobile
propiedad
clicks

xdm:productListItems

Este campo es una matriz de artículos que representan los productos seleccionados por un cliente, incluidos 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 requeridos para xdm:productListItems , consulte las especificaciones del esquema de detalles comerciales.

xdm:commerce

Este campo contiene información específica sobre el comercio acerca de 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 requeridos para xdm:commerce , consulte las especificaciones del esquema de detalles comerciales.

xdm:web

Este campo representa los detalles web relacionados con ExperienceEvent, como la interacción, los detalles de la página y el remitente del reenvío.
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 para xdm:productListItems , consulte las especificaciones del esquema de detalles web de ExperienceEvent.

xdm:marketing

Este campo contiene información relacionada con actividades de marketing que están activas con el touchpoint.
esquema de ejemplo
{
  "xdm:trackingCode": "marketingcampaign111",
  "xdm:campaignGroup": "50%_DISCOUNT",
  "xdm:campaignName": "50%_DISCOUNT_USA"
}

Para obtener información completa acerca de cada uno de los subcampos requeridos para xdm:productListItems , consulte la especificación de chechma de mercadotecnia.

Asignación e ingesta de datos (#mapping)

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 se van a incluir en Servicios inteligentes. Todos los datos históricos utilizados en Servicios Inteligentes deben estar dentro del período mínimo de cuatro meses de datos, más el número de días previsto como 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 ayudarle a asignar los datos al esquema e incorporarlos al servicio.
Si tiene una Adobe Experience Platform suscripción y desea asignar e ingestar los datos usted mismo, siga los pasos descritos en la sección siguiente.

Uso de Adobe Experience Platform

Los pasos a continuación requieren una suscripción a la plataforma de experiencia. Si no tiene acceso a Plataforma, vaya a la sección de próximos pasos .
En esta sección se describe el flujo de trabajo para asignar e ingestar datos en la plataforma de experiencias para su uso en los servicios inteligentes, incluidos los vínculos a tutoriales para ver los pasos detallados.

Crear un esquema y un conjunto de datos de CEE

Cuando esté listo para el inicio de preparar sus datos para la ingestión, el primer paso es crear un nuevo esquema XDM que emplee la mezcla CEE. Los siguientes tutoriales explican el proceso de creación de un nuevo esquema en la interfaz de usuario o la API:
Los tutoriales anteriores siguen un flujo de trabajo genérico para crear un esquema. Al elegir una clase para el esquema, debe utilizar la clase ExperienceEvent de XDM. Una vez seleccionada esta clase, puede agregar la mezcla CEE al esquema.
Después de agregar la mezcla CEE al esquema, puede agregar otras mezclas 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 interfaz de usuario o la API:

Añadir una etiqueta de Área de nombres de identidad principal en el conjunto de datos

Si está trayendo datos desde Adobe Audience Manager, Adobe Analyticsu otra fuente externa, debe agregar una primaryIdentityNameSpace etiqueta al conjunto de datos. Esto se puede hacer haciendo una solicitud PATCH a la API del servicio de catálogo.
Si va a ingerir datos de un archivo CSV local, puede pasar a la siguiente sección sobre asignación e ingesta de datos .
Antes de seguir el ejemplo de llamada de API que se muestra a continuación, consulte la sección Guía del desarrollador del servicio de catálogo Introducción en la guía para desarrolladores de catálogos para obtener información importante sobre los encabezados necesarios.
Formato API
PATCH /dataSets/{DATASET_ID}

Parámetro
Descripción
{DATASET_ID}
ID del conjunto de datos creado anteriormente.
Solicitud
En función de la fuente desde la que ingrese datos, debe proporcionar los valores apropiados primaryIdentityNamespace y sourceConnectorId de etiqueta en la carga útil de la solicitud.
La siguiente solicitud agrega los valores de etiqueta adecuados para Audience Manager:
curl -X PATCH \
  https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
        "tags": {
          "primaryIdentityNameSpace": ["mcid"],
          "sourceConnectorId": ["audiencemanager"],
        }
      }'

La siguiente solicitud agrega los valores de etiqueta adecuados para Analytics:
curl -X PATCH \
  https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
        "tags": {
          "primaryIdentityNameSpace": ["aaid"],
          "sourceConnectorId": ["analytics"],
        }
      }'

Para obtener más información sobre cómo trabajar con Áreas de nombres de identidad en la plataforma, consulte la descripción general de la Área de nombres de identidad.
Respuesta
Una respuesta correcta devuelve una matriz que contiene el ID del conjunto de datos actualizado. Este ID debe coincidir con el enviado en la solicitud PATCH.
[
    "@/dataSets/5ba9452f7de80400007fc52a"
]

Asignar y transferir datos

Después de crear un esquema y un conjunto de datos de CEE, puede asignar inicios a las tablas de datos en el esquema e ingerirlos en la plataforma. Consulte el tutorial sobre la asignación de un archivo CSV a un esquema XDM para ver los pasos para realizar esto en la interfaz de usuario. Una vez que se ha rellenado un conjunto de datos, se puede utilizar el mismo conjunto de datos para ingestar archivos de datos adicionales.
Si los datos se almacenan en una aplicación de terceros admitida, también puede elegir crear un conector de origen para transferir los datos de eventos de marketing a Platform en tiempo real.

Pasos siguientes

Este documento proporciona una guía general sobre la preparación de los datos para su uso en Servicios inteligentes. Si necesita asesoramiento adicional en función de su caso de uso, póngase en contacto con la asistencia de consultoría de Adobe.
Una vez que haya rellenado correctamente un conjunto de datos con los datos de experiencia del cliente, puede utilizar Servicios inteligentes para generar perspectivas. Consulte los siguientes documentos para empezar: