Resumen del proceso
El proceso de configuración de la recopilación de datos para su sitio web se puede resumir de la siguiente manera:
- Cree un esquema para determinar cómo se estructurarán los datos cuando se envíen a Edge Network.
- Cree una secuencia de datos para configurar a qué destinos desea enviar los datos.
- Instale y configure Web SDK para enviar datos al conjunto de datos cuando se produzcan ciertos eventos en el sitio web.
Una vez que pueda enviar datos a Edge Network, también puede configurar el reenvío de eventos si su organización dispone de una licencia para él.
Creación de un esquema
Experience Data Model (XDM) es una especificación de código abierto que proporciona estructuras y definiciones comunes para datos en forma de esquemas. En otras palabras, XDM es una forma de estructurar y dar formato a los datos de una manera que pueda ser procesada por Edge Network y otras aplicaciones de Adobe Experience Cloud.
El primer paso para configurar las operaciones de recopilación de datos es crear un esquema XDM para representar los datos. En un paso posterior de este tutorial, asignará los datos que desee enviar a la estructura de este esquema.
En la interfaz de usuario, seleccione Esquemas en el panel de navegación izquierdo. Desde aquí puede ver una lista de los esquemas creados anteriormente que pertenecen a su organización. Para continuar, selecciona Crear esquema y luego selecciona XDM ExperienceEvent en el menú desplegable.
Aparece un cuadro de diálogo que le solicita que empiece a agregar grupos de campos al esquema. Para enviar eventos mediante Web SDK, debe agregar el grupo de campos AEP Web SDK ExperienceEvent Mixin. Este grupo de campos contiene definiciones de atributos de datos que la biblioteca Web SDK recopila automáticamente.
Utilice la barra de búsqueda para reducir la lista y facilitar la búsqueda de este grupo de campos. Una vez que lo haya encontrado, selecciónelo en la lista antes de seleccionar Agregar grupos de campos.
Aparece el lienzo del esquema, que muestra una estructura de árbol del esquema XDM que incluye los campos proporcionados por el grupo de campos de Web SDK.
Seleccione el campo raíz en el árbol para abrir Propiedades del esquema en el carril derecho, donde puede proporcionar un nombre y una descripción opcional para el esquema.
Si desea agregar más campos al esquema, puede hacerlo seleccionando Agregar en la sección Grupos de campos en el carril izquierdo.
Una vez que haya agregado los campos que necesita, seleccione Guardar para guardar el esquema.
Crear un flujo de datos
Un conjunto de datos es una configuración que indica a Edge Network dónde desea que se envíen los datos. En concreto, un conjunto de datos especifica a qué productos de Experience Cloud desea enviar los datos, y cómo desea que se gestionen y almacenen los datos en cada producto.
Seleccione Datastreams en el panel de navegación izquierdo. Desde aquí, puede seleccionar una secuencia de datos existente de la lista para editarla, o bien puede crear una nueva configuración seleccionando Nueva secuencia de datos.
Los requisitos de configuración de un conjunto de datos dependen de los productos y las capacidades a los que esté enviando datos. Para obtener información detallada sobre las opciones de configuración de cada producto, consulte la descripción general de flujos de datos.
Instalación y configuración de Web SDK
Una vez creados un esquema y un conjunto de datos, el siguiente paso es instalar y configurar Experience Platform Web SDK para que comience a enviar datos a Edge Network.
El proceso puede resumirse de la siguiente manera:
- Instale Adobe Experience Platform Web SDK en una propiedad de etiquetas para obtener acceso a sus funciones.
- Cree un elemento de datos de objeto XDM para asignar variables en su sitio web a la estructura del esquema XDM que creó anteriormente.
- Cree una regla para indicar a SDK cuándo debe enviar datos a Edge Network.
- Cree e instale una biblioteca para implementar la regla en su sitio web.
Instalación de SDK en una propiedad de etiquetas
Seleccione Etiquetas en el panel de navegación izquierdo para mostrar una lista de propiedades de etiquetas. Puede elegir una propiedad existente para editarla si lo desea, o bien puede seleccionar Nueva propiedad.
Si va a crear una nueva propiedad, proporcione un nombre descriptivo y establezca la Plataforma en Web. Proporcione el dominio completo para la propiedad web y luego seleccione Guardar.
Aparecerá la página de información general de la propiedad. Aquí, seleccione Extensiones en el panel de navegación izquierdo y, a continuación, seleccione Catálogo. Busque el listado de Experience Platform Web SDK (opcionalmente, mediante la barra de búsqueda para reducir los resultados) y seleccione Instalar.
Aparecerá la página de configuración de SDK. La mayoría de los valores necesarios se rellenan automáticamente con valores predeterminados que puede elegir cambiar si lo desea.
Sin embargo, antes de instalar SDK, debe seleccionar una secuencia de datos para que sepa a dónde enviar los datos. En Flujos de datos, utilice el menú desplegable para seleccionar el flujo de datos que configuró en un paso anterior. Una vez que haya establecido la secuencia de datos, seleccione Guardar para finalizar la instalación de SDK en la propiedad.
Creación de un elemento de datos XDM
Para que SDK envíe datos a Edge Network, esos datos deben asignarse al esquema XDM creado en un paso anterior. Esta asignación se realiza mediante el uso de un elemento de datos.
En la interfaz de usuario, seleccione Elementos de datos y luego seleccione Crear nuevo elemento de datos.
En la siguiente pantalla, seleccione Adobe Experience Platform Web SDK en el menú desplegable Extensión y, a continuación, seleccione objeto XDM para el tipo de elemento de datos.
Aparecerá el cuadro de diálogo de configuración para el tipo de objeto XDM. El cuadro de diálogo selecciona automáticamente la zona protegida de Experience Platform y desde aquí puede ver todos los esquemas que se han creado en esa zona protegida. Seleccione el esquema XDM creado anteriormente en la lista.
Aparecerá la estructura del esquema. Todos los campos con un asterisco (*) indican los campos que se rellenarán automáticamente cuando se activen eventos. Para todos los demás campos, puede explorar la estructura del esquema y rellenar el resto de los datos.
cartAbandonsTotal
) a un campo XDM haciendo referencia a su nombre en el campo Valor, rodeado de símbolos de porcentaje (%
).Cuando haya terminado de asignar los datos al esquema, proporcione un nombre para el elemento de datos antes de seleccionar Guardar.