DocumentaciónExperience PlatformDatos de modelo en esquemas

Datos de modelo en esquemas

Last update: Thu May 30 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Principiante
  • Intermedio
  • Desarrollador

En esta lección, modelará los datos de Luma en esquemas. Esta es una de las lecciones más largas del tutorial, ¡así que toma un vaso de agua y abróchate!

La estandarización y la interoperabilidad son conceptos clave detrás de Adobe Experience Platform. El modelo de datos de experiencia (XDM) es un esfuerzo para estandarizar los datos de experiencia del cliente y definir esquemas para la administración de experiencias del cliente.

XDM es una especificación documentada públicamente y diseñada para mejorar la potencia de las experiencias digitales. Proporciona estructuras y definiciones comunes para cualquier aplicación que se utilice para comunicarse con los servicios de Platform. Al adherirse a los estándares XDM, todos los datos de experiencia del cliente se pueden incorporar en una representación común que puede ofrecer perspectivas de una manera más rápida e integrada. Puede obtener información valiosa de las acciones de los clientes, definir las audiencias de los clientes mediante segmentos y expresar los atributos del cliente con fines de personalización.

XDM es el marco de trabajo básico que permite a Adobe Experience Cloud, con tecnología de Experience Platform, enviar el mensaje correcto a la persona adecuada, en el canal correcto, en el momento exacto. La metodología en la que se basa Experience Platform. Sistema XDM, pone en funcionamiento esquemas del Modelo de datos de experiencia para que los utilicen los servicios de Platform.

Arquitectos de datos deberá crear esquemas fuera de este tutorial, pero Ingenieros de datos trabajará estrechamente con los esquemas creados por el arquitecto de datos.

Antes de comenzar los ejercicios, vea este breve vídeo para obtener más información sobre los esquemas y el modelo de datos de experiencia (XDM):

https://video.tv.adobe.com/v/38506?learn=on&captions=spa

TIP
Para profundizar en el modelado de datos en Experience Platform, recomendamos realizar el curso Modelar los datos de la experiencia del cliente con XDM, disponible de forma gratuita en Experience League.

Permisos necesarios

En el Configuración de permisos Esta lección, ha configurado todos los controles de acceso necesarios para completar esta lección.

Crear esquema de fidelización mediante la IU

En este ejercicio, crearemos un esquema para los datos de fidelidad de Luma.

  1. Vaya a la interfaz de usuario de Platform y asegúrese de que la zona protegida está seleccionada.

  2. Ir a Esquemas en el panel de navegación izquierdo.

  3. Seleccione el Crear esquema botón en la parte superior derecha.
    Esquema con grupo de campos OOTB

  4. En el flujo de trabajo Crear esquema, seleccione Perfil individual como clase base para su esquema, ya que modelaremos los atributos de un cliente individual (puntos, estado, etc.).

  5. Seleccionar Siguiente.
    Seleccionar clase base

  6. Entrar Luma Loyalty Schema en el Nombre para mostrar del esquema campo de texto. En el lienzo siguiente, también puede revisar y verificar la estructura de esquema base proporcionada por la clase elegida.

  7. Seleccionar Finalizar para crear el esquema.
    Terminar de crear el esquema de fidelización

Adición de grupos de campos estándar

Una vez creado el esquema, se le redirigirá al Editor de esquemas, donde puede agregar campos al esquema. Puede agregar campos individuales directamente al esquema o utilizar grupos de campos. Es importante tener en cuenta que todos los campos individuales siguen estando asociados a una clase o grupo de campos. Puede elegir entre un gran conjunto de grupos de campos estándar del sector proporcionados por Adobe o crear los suyos propios. A medida que empiece a modelar sus propios datos en Experience Platform, es bueno familiarizarse con los grupos de campo estándar del sector que proporciona Adobe. Siempre que sea posible, se recomienda utilizarlos, ya que a veces alimentan servicios descendentes, como inteligencia artificial aplicada al cliente, Attribution AI y Adobe Analytics.

Al trabajar con sus propios datos, un paso significativo será determinar cuáles de sus propios datos deben capturarse en Platform y cómo deben modelarse. Este gran tema se analiza con más detalle en el curso Modelar los datos de la experiencia del cliente con XDM. En este tutorial, solo le guiaré a través de la implementación de algunos esquemas predeterminados.

Para agregar grupos de campos:

  1. Seleccionar Añadir en el Grupos de campos encabezado.
    Añadir un nuevo grupo de campos

  2. En el Agregar grupos de campos modal, seleccione los siguientes grupos de campos:

    1. Datos demográficos para datos básicos del cliente, como nombre y fecha de nacimiento
    2. Datos personales de contacto para obtener información básica de contacto, como dirección de correo electrónico y número de teléfono

  3. Puede obtener una vista previa de los campos contribuidos en el grupo de campos seleccionando el icono en el lado derecho de la fila.
    Seleccionar grupos de campos estándar

  4. Compruebe la Industria > Comercial para exponer los grupos de campos específicos del sector.

  5. Seleccionar Detalles de fidelización para añadir los campos del programa de fidelización.

  6. Seleccionar Adición de grupos de campos para agregar los tres grupos de campos al esquema.
    Adición de grupos de campos estándar al esquema de fidelización

Ahora, dedique un tiempo a explorar el estado actual del esquema. Los grupos de campos han agregado campos estándar relacionados con una persona, sus detalles de contacto y el estado del programa de fidelización. Puede encontrar útiles estos dos grupos de campos al crear esquemas para los datos de su propia compañía. Seleccione una fila de grupo de campos específica o marque la casilla junto al nombre del grupo de campos para ver cómo cambia la visualización.

Para guardar el esquema, seleccione Guardar.
Guardar el esquema

NOTE
Es aceptable si un grupo de campos agrega un campo para un punto de datos que no recopila. Por ejemplo, "faxPhone" puede ser un campo para el que Luma no recopila datos. Eso está bien. El hecho de que un campo se defina en el esquema no significa que haya datos para él debe ingerirse más adelante. También puede quitar el campo del esquema.

Agregar un grupo de campos personalizados

Ahora, vamos a crear un grupo de campos personalizados.

Mientras que el grupo de campo de fidelidad contenía un loyaltyID , Luma desea administrar todos sus identificadores del sistema en un solo grupo para garantizar la coherencia en sus esquemas.

Los grupos de campos deben crearse en el flujo de trabajo del esquema. Puede hacer lo siguiente:

  • Agregue primero un nuevo campo personalizado al esquema y, a continuación, cree un grupo de campos personalizados, o
  • Cree primero un grupo de campos personalizados y, a continuación, agréguele campos.

En este tutorial, empezamos con la creación de un grupo de campos personalizados.

Para crear el grupo de campos:

  1. Seleccionar Añadir en el Grupos de campos de esquema encabezado
    Añadir un nuevo grupo de campos
  2. Seleccionar Crear nuevo grupo de campos
  3. Uso Luma Identity profile field group como el Nombre para mostrar
  4. Uso system identifiers for XDM Individual Profile class como el Descripción
  5. Seleccionar Adición de grupos de campos
    Añadir un nuevo grupo de campos

El nuevo grupo de campo vacío se agrega al esquema. El + Los botones se pueden utilizar para añadir nuevos campos a cualquier ubicación de la jerarquía. En nuestro caso, queremos añadir campos en el nivel raíz:

  1. Seleccionar + junto al nombre del esquema. Esto agrega un nuevo campo bajo el área de nombres de ID de inquilino para administrar los conflictos entre los campos personalizados y cualquier campo estándar.

  2. En el Propiedades del campo barra lateral para añadir los detalles del nuevo campo:

    1. Nombre de campo: systemIdentifier

    2. Nombre para mostrar: System Identifier

    3. Tipo: Objeto

    4. En el Grupo de campos menú desplegable seleccione la Grupo de campos del perfil de identidad de Luma que hemos creado.

      Añadir un nuevo grupo de campos

    5. Seleccionar Aplicar

      Aplicar nuevas propiedades de campo

Ahora añada dos campos debajo de systemIdentifier objeto:

  1. Primer campo

    1. Nombre de campo: loyaltyId
    2. Nombre para mostrar: Loyalty Id
    3. Tipo: Cadena

  2. Segundo campo

    1. Nombre de campo: crmId
    2. Nombre para mostrar: CRM Id
    3. Tipo: Cadena

El nuevo grupo de campos debe tener este aspecto. Seleccione el Guardar para guardar el esquema, pero déjelo abierto para el siguiente ejercicio.
Grupo de campos de fidelización completo

Creación de un tipo de datos

Grupos de campos, como el nuevo Luma Identity profile field group, se puede reutilizar en otros esquemas, lo que permite aplicar definiciones de datos estándar en varios sistemas. Pero solo pueden ser reutilizados en esquemas que comparten una clase, en este caso la clase Perfil individual XDM.

El tipo de datos es otra construcción de varios campos que se puede reutilizar en esquemas en varias clases. Vamos a convertir nuestro nuevo systemIdentifier en un tipo de datos:

Con el Luma Loyalty Schema aún abierto, seleccione la systemIdentifier objeto y seleccione Convertir a nuevo tipo de datos

Grupo de campos de fidelización completo

Si usted Cancelar fuera del esquema y navegue hasta el Tipos de datos , verá el tipo de datos recién creado. Utilizaremos este tipo de datos más adelante en la lección.

Grupo de campos de fidelización completo

Crear esquema CRM mediante API

Ahora crearemos un esquema con la API.

TIP
Si prefiere omitir el ejercicio de API, puede crear el siguiente esquema con el método de interfaz de usuario:
  1. Utilice el Perfil individual clase
  2. Asígnele un nombre Luma CRM Schema
  3. Utilice los siguientes grupos de campos: Detalles demográficos, detalles de contacto personal y grupo de campos del perfil de identidad de Luma

Primero creamos el esquema vacío:

  1. Abrir Postman

  2. Si no tiene un token de acceso, abra la solicitud OAuth: Request Access Token y seleccione Enviar para solicitar un nuevo token de acceso.

  3. Abra las variables de entorno y cambie el valor de CONTAINER_ID de global hasta tenant. Recuerde que debe utilizar tenant siempre que desee interactuar con sus propios elementos personalizados en Platform, como crear un esquema.

  4. Seleccionar Guardar
    Cambiar CONTAINER_ID a inquilino

  5. Abrir la solicitud Schema Registry API > Schemas > Create a new custom schema.

  6. Abra el Cuerpo y pegue el siguiente código y seleccione Enviar para realizar la llamada de API. Esta llamada crea un nuevo esquema con el mismo XDM Individual Profile clase base:

    code language-json 
    {
  "type": "object",
  "title": "Luma CRM Schema",
  "description": "Schema for CRM data of Luma Retail ",
  "allOf": [{
    "$ref": "https://ns.adobe.com/xdm/context/profile"
  }]
}
    note note
    NOTE
    El área de nombres hace referencia a en este ejemplo de código y en los siguientes (por ejemplo, https://ns.adobe.com/xdm/context/profile), se puede obtener utilizando la lista llamadas de API con el CONTAINER_ID y acepte el encabezado establecido en los valores correctos. Algunos también son fácilmente accesibles desde la interfaz de usuario.

  7. Usted debe conseguir una 201 Created respuesta

  8. Copiar meta:altId del cuerpo de respuesta. Lo utilizaremos más adelante en otro ejercicio.
    Creación del esquema CRM

  9. El nuevo esquema debe ser visible en la interfaz de usuario, pero sin ningún grupo de campos
    Creación del esquema CRM

NOTE
El meta:altId o el id de esquema también se puede obtener realizando la solicitud de API Schema Registry API > Schemas > Retrieve a list of schemas within the specified container. con el CONTAINER_ID establezca en tenant y un encabezado Aceptar application/vnd.adobe.xdm+json.
TIP
Problemas comunes con esta llamada y posibles correcciones:
  • Sin token de autenticación: ejecute el OAuth: Solicitar token de acceso solicitud para generar un nuevo token
  • 401: Not Authorized to PUT/POST/PATCH/DELETE for this path : /global/schemas/: Actualice el CONTAINER_ID variable de entorno de global hasta tenant
  • 403: PALM Access Denied. POST access is denied for this resource from access control: compruebe los permisos de usuario en el Admin Console

Adición de grupos de campos estándar

Ahora es el momento de agregar los grupos de campos al esquema:

  1. Entrada Postman, Abra la solicitud Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.

  2. En el Parámetros pestaña, pegue el meta:altId valor de la respuesta anterior como SCHEMA_ID

  3. Abra la pestaña Cuerpo, pegue el siguiente código y seleccione Enviar para realizar la llamada de API. Esta llamada agrega los grupos de campos estándar a la Luma CRM Schema:

    code language-json 
    [{
    "op": "add",
    "path": "/allOf/-",
    "value": {
      "$ref": "https://ns.adobe.com/xdm/context/profile-personal-details"
    }
  },
  {
    "op": "add",
    "path": "/allOf/-",
    "value": {
      "$ref": "https://ns.adobe.com/xdm/context/profile-person-details"
    }
  }
]

  4. Debe obtener un estado 200 OK para la respuesta y los grupos de campos deben ser visibles como parte del esquema en la interfaz de usuario

    Grupos de campo estándar añadidos

Agregar grupo de campos personalizados

Ahora vamos a añadir nuestro Luma Identity profile field group al esquema. En primer lugar, necesitamos encontrar el ID de nuestro nuevo grupo de campos, utilizando una API de lista:

  1. Abrir la solicitud Schema Registry API > Field groups > Retrieve a list of field groups within the specified container.

  2. Seleccione el Enviar para recuperar una lista de todos los grupos de campos personalizados de la cuenta

  3. Coja el $id valor del Luma Identity profile field group (el suyo será diferente del valor de esta captura de pantalla)
    Recuperación de la lista de grupos de campos

  4. Abrir la solicitud Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID. de nuevo

  5. El Parámetros La pestaña debe tener el valor $id de su esquema

  6. Abra el Cuerpo y pegue el siguiente código, reemplazando el $ref valor con el $id por su cuenta Luma Identity profile field group:

    code language-json 
    [{
  "op": "add",
  "path": "/allOf/-",
  "value": {
    "$ref": "REPLACE_WITH_YOUR_OWN_FIELD_GROUP_ID"
  }
}]

  7. Seleccionar Enviar
    Adición del grupo Campo de identidad

Compruebe que el grupo de campos se ha agregado al esquema comprobando tanto la respuesta de la API como en la interfaz.

Crear esquema de eventos de compra sin conexión

Ahora vamos a crear un esquema basado en el Evento de experiencia para los datos de compra sin conexión de Luma. Dado que ahora se está familiarizando con la interfaz de usuario del editor de esquemas, reduciré el número de capturas de pantalla en las instrucciones:

  1. Cree un esquema con Evento de experiencia clase.
  2. Asigne un nombre al esquema Luma Offline Purchase Events Schema.
  3. Añadir el grupo de campos estándar Detalles de Commerce para recopilar detalles de pedidos comunes. Dedique unos minutos a explorar los objetos que hay dentro.
  4. Buscar por Luma Identity profile field group. ¡No está disponible! Recuerde que los grupos de campos están vinculados a una clase y, como estamos utilizando una clase diferente para este esquema, no podemos utilizarla. Es necesario agregar un nuevo grupo de campos para la clase XDM ExperienceEvent que contenga los campos de identidad. Nuestro tipo de datos lo hará muy fácil.
  5. Seleccione el Crear nuevo grupo de campos botón de opción
  6. Introduzca el Nombre para mostrar as Luma Identity ExperienceEvent field group y seleccione la Adición de grupos de campos botón
  7. Seleccione + junto al nombre del esquema.
  8. Como el Nombre de campo, introduzca systemIdentifier.
  9. Como el Nombre para mostrar, introduzca System Identifier.
  10. Como el Tipo, seleccione Identificador del sistema que es el tipo de datos personalizados que creó anteriormente.
  11. Como el Grupo de campos select Grupo de campos de ExperienceEvent de identidad de Luma.
  12. Seleccione el Aplicar botón.
  13. Seleccione el Guardar botón.

Observe cómo el tipo de datos agregó todos los campos.

Añadir el tipo de datos al grupo de campos

Además, seleccione ExperienceEvent de XDM en el Clase encabezado e inspeccione algunos de los campos aportados por esta clase. Tenga en cuenta que los campos _id y timestamp son obligatorios al utilizar la clase XDM ExperienceEvent; estos campos deben rellenarse para cada registro que introduzca al utilizar este esquema:

Estructura base del evento de experiencia

Crear esquema de eventos web

Ahora vamos a crear un esquema más para los datos del sitio web de Luma. En este punto, debería ser un experto en la creación de esquemas. Cree el siguiente esquema con estas propiedades

Propiedad
Valor
Clase
Evento de experiencia
Nombre del esquema
Esquema de eventos web de Luma
Grupo de campo
ExperienceEvent del SDK web de AEP
Grupo de campo
Evento de experiencia del consumidor

Seleccione el Evento de experiencia del consumidor grupo de campos. Este grupo de campos contiene los objetos commerce y productListItems que también estaban en Detalles de Commerce. De hecho Evento de experiencia del consumidor es una combinación de otros grupos de campos estándar que también están disponibles por separado. ExperienceEvent del SDK web de AEP el grupo de campos también contiene otros grupos de campos, incluidos algunos de los mismos en Evento de experiencia del consumidor. Afortunadamente, se mezclan sin problemas.

Observe que no se ha agregado la variable Luma Identity ExperienceEvent field group a este esquema. Esto se debe a que el SDK web tiene una forma diferente de recopilar identidades. Si selecciona la opción ExperienceEvent de XDM clase en la Composición del editor de esquemas, verá que uno de los campos que agrega de forma predeterminada se llama IdentityMap. IdentityMap es utilizado por varias aplicaciones de Adobe para vincularse a Platform. Verá cómo se envían las identidades a Platform a través de identityMap en la lección de ingesta de transmisión.

Crear esquema de catálogo de productos

Mediante el uso de Detalles de Commerce y Evento de experiencia del consumidor grupos de campos, Luma informa de algunos detalles de los eventos relacionados con el producto a través del tipo de datos estándar productListItems. Pero también tienen campos de detalles de producto adicionales que les gustaría enviar a Platform. En lugar de capturar todos estos campos en sus sistemas de punto de venta y comercio electrónico, Luma preferiría ingerirlos directamente desde su sistema de catálogo de productos. Una "relación de esquema" permite definir una relación entre dos esquemas para los fines de clasificación o búsquedas. Luma utilizará una relación para clasificar los detalles del producto. Comenzaremos el proceso ahora y lo completaremos al final de la siguiente lección.

NOTE
Si es cliente existente de Analytics o Target, la clasificación de entidades con relaciones de esquema es análoga a las clasificaciones de SAINT o a la carga del catálogo de productos para Recommendations

En primer lugar, se debe crear un esquema para el catálogo de productos de Luma utilizando una clase personalizada:

  1. Seleccione el Crear esquema botón.

  2. En el flujo de trabajo Crear esquema, seleccione Otros opción.
    Crear nuevo esquema

  3. Seleccione el Crear clase botón

  4. Asígnele un nombre Luma Product Catalog Class

  5. Deje el Comportamiento as Registro

  6. Seleccione el Crear botón.
    Crear nueva clase

  7. El Clase del catálogo de productos Luma que haya creado aparecerá en la tabla Clases que aparece a continuación. Asegúrese de que la clase esté seleccionada y, a continuación, seleccione Siguiente.
    Nueva clase agregada

  8. Asignar un nombre al esquema Luma Product Catalog Schema.

  9. Crear un nuevo grupo de campos llamado Luma Product Catalog field group con los campos siguientes:

    1. productName: Nombre del producto: String
    2. productCategory: Categoría del producto: Cadena
    3. productColor: Product Color: String
    4. productSKU: Product SKU: String | Requerido
    5. productSize: Tamaño del producto: Cadena
    6. productPrice: Precio del producto: Doble

  10. Guardar el esquema

El nuevo esquema debería tener un aspecto similar al siguiente. Observe cómo las variables productSku El campo aparece en la Campos obligatorios sección:
Esquema del producto

El siguiente paso es definir la relación entre los dos esquemas de ExperienceEvent y Luma Product Catalog SchemaSin embargo, hay algunos pasos adicionales que debemos tomar en la siguiente lección antes de que podamos hacerlo.

Recursos adicionales

Ahora que tiene sus esquemas, puede asignar identidades!

recommendation-more-help
513160b6-bf42-4c58-abdd-4f817b1cccad