Información general sobre la recopilación de datos de extremo a extremo

Adobe Experience Platform recopila y transfiere sus datos a otros productos de Adobe y destinos de terceros. Para enviar datos de evento de la aplicación al Edge Network Experience Platform, es importante comprender estas tecnologías principales y cómo configurarlas para que entreguen los datos a los destinos que necesite, cuando lo necesite.

Esta guía proporciona un tutorial de alto nivel sobre cómo enviar un evento a través del Edge Network mediante las funciones de recopilación de datos de Platform. En concreto, el tutorial recorre los pasos de instalación y configuración de la extensión de etiqueta del SDK web de Adobe Experience Platform dentro de la IU de recopilación de datos (anteriormente, Adobe Experience Platform Launch).

Requisitos previos

Este tutorial utiliza la IU de recopilación de datos para crear un esquema, configurar un flujo de datos e instalar el SDK web. Para realizar estas acciones en la interfaz de usuario, se le debe otorgar acceso a al menos una propiedad web junto con los siguientes derechos de propiedad:

Consulte la guía sobre administración de permisos para la recopilación de datos para obtener información sobre cómo conceder acceso a propiedades y derechos de propiedad.

Para utilizar los distintos productos de recopilación de datos mencionados en esta guía, también debe tener acceso a los flujos de datos y la capacidad de crear y administrar esquemas. Si necesita acceder a alguna de estas funciones, póngase en contacto con el equipo de su cuenta de Adobe para que le ayude a obtener el acceso necesario. Tenga en cuenta que si no ha adquirido Adobe Experience Platform, Adobe le proporcionará el acceso necesario para utilizar el SDK sin coste adicional.

Si ya tiene acceso a Platform, debe asegurarse de que tiene habilitados todos los permisos en las siguientes categorías:

Consulte la descripción general de la interfaz de usuario de control de acceso para obtener información sobre cómo conceder permisos para las capacidades de Platform a los usuarios.

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:

Una vez que pueda enviar datos al 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 schema

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 el 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 el SDK web, debe agregar el grupo de campos AEP Web SDK ExperienceEvent Mixin. Este grupo de campos contiene definiciones de atributos de datos que la biblioteca del SDK web 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 del SDK web.

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 datastream

Un conjunto de datos es una configuración que indica al Edge Network a 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 del SDK web install

Una vez creados un esquema y un conjunto de datos, el siguiente paso es instalar y configurar el SDK web de Platform para que comience a enviar datos al Edge Network.

El proceso puede resumirse de la siguiente manera:

Instalación del SDK en una propiedad de etiqueta install-sdk

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 la lista del SDK web de Platform (opcionalmente, mediante la barra de búsqueda para reducir los resultados) y seleccione Instalar.

Aparecerá la página de configuración del 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 el SDK, debe seleccionar un conjunto 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 del SDK en la propiedad.

Creación de un elemento de datos XDM data-element

Para que el SDK envíe datos al 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 SDK web de Adobe Experience Platform 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 el entorno limitado de Platform y desde aquí puede ver todos los esquemas que se han creado en ese entorno limitado. 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.

Cuando haya terminado de asignar los datos al esquema, proporcione un nombre para el elemento de datos antes de seleccionar Guardar.

Crear una regla

Una vez guardado el elemento de datos, el siguiente paso es crear una regla que lo envíe al Edge Network cada vez que se produzca un evento determinado en el sitio web (como cuando un cliente agrega un producto al carro de compras).

Puede configurar reglas para prácticamente cualquier evento que se pueda producir en el sitio web. Por ejemplo, esta sección muestra cómo crear una regla que entrará en déclencheur cuando un cliente envíe un formulario. El siguiente HTML representa una página web sencilla con un formulario "Agregar al carro de compras", que será el tema de la regla:

<!DOCTYPE html>
<html>
<body>

  <form id="add-to-cart-form">
    <label for="item">Product:</label><br>
    <input type="text" id="item" name="item"><br>
    <label for="amount">Amount:</label><br>
    <input type="number" id="amount" name="amount" value="1"><br><br>
    <input type="submit" value="Add to Cart">
  </form>

</body>
</html>

En la IU de recopilación de datos, seleccione Reglas en el panel de navegación izquierdo y, a continuación, seleccione Crear nueva regla.

En la pantalla siguiente, proporcione un nombre para la regla. A partir de aquí, el siguiente paso es determinar el evento de la regla (es decir, cuándo se activará la regla). Seleccione Agregar en Eventos.

Aparecerá la página de configuración del evento. Para configurar un evento, primero debe seleccionar el tipo de evento. Las extensiones proporcionan los tipos de eventos. Para configurar un evento de "envío de formulario", por ejemplo, seleccione la extensión Core y, a continuación, seleccione el tipo de evento Enviar en la categoría Formulario.

El evento de envío de formulario le permite usar un selector de CSS para hacer referencia a un elemento específico en el que se activará la regla. En el ejemplo siguiente, se utiliza el ID add-to-cart-form para que esta regla solo se active para el formulario "Agregar al carro de compras". Seleccione Conservar cambios para agregar el evento a la regla.

La página de configuración de regla vuelve a aparecer y muestra que se ha añadido el evento. Puede reducir el "If" agregando más condiciones a la regla.

De lo contrario, el siguiente paso es añadir una acción para que la regla se ejecute cuando se active. Seleccione Agregar en Acciones para continuar.

Aparecerá la página de configuración de la acción. Para que la regla envíe datos al Edge Network, seleccione Adobe Experience Platform Web SDK para la extensión y Send event para el tipo de acción.

La pantalla se actualiza para mostrar opciones adicionales para configurar la acción de envío de eventos. En Type, puede proporcionar un valor de tipo personalizado para rellenar el campo XDM eventType. En Datos XDM, proporcione el nombre del tipo de datos XDM que creó anteriormente (rodeado de símbolos de porcentaje) o seleccione el icono de la base de datos ( ) para seleccionarlo en una lista. Estos son los datos que finalmente se envían al Edge Network.

Seleccione Conservar cambios cuando haya terminado.

Una vez que termine de configurar la regla, seleccione Guardar para finalizar el proceso.

Crear e instalar una biblioteca library

Una vez configurada la regla, está listo para agregarla a una biblioteca de etiquetas, compilarla en un entorno e instalarla en el sitio web.

Para obtener información sobre cómo crear una biblioteca, añadir extensiones y reglas a la biblioteca y crear esa biblioteca en un entorno, consulte la guía sobre administración de bibliotecas en la documentación de etiquetas. Cuando cree la biblioteca, asegúrese de incluir la extensión del SDK web de Platform y las reglas de recopilación de datos creadas anteriormente.

Una vez creada la biblioteca y asignada su compilación a un entorno, puede instalar ese entorno en el lado del cliente del sitio web. Consulte la sección sobre instalación de entornos para obtener más información.

Una vez que haya instalado el entorno en su sitio web, puede probar la implementación con el Adobe Experience Platform Debugger.

Configurar el reenvío de eventos (opcional) event-forwarding

Una vez configurado el SDK para enviar datos al Edge Network, puede configurar el reenvío de eventos para indicar al Edge Network dónde desea que se entreguen esos datos.

Para utilizar el reenvío de eventos, primero debe crear una propiedad de reenvío de eventos. Seleccione Reenvío de eventos en la barra de navegación izquierda, luego seleccione Nueva propiedad. Proporcione un nombre para la propiedad antes de seleccionar Guardar.

Una vez creada una propiedad de reenvío de eventos, el siguiente paso es crear una regla que determine a dónde se deben enviar los datos. Las reglas para las propiedades del reenvío de eventos se construyen de forma muy similar a las propiedades de etiquetas, con la excepción de que no se pueden especificar eventos (ya que el reenvío de eventos solo trata los eventos que recibe directamente del conjunto de datos). Para la acción de la regla, puede utilizar una de las extensiones de reenvío de eventos disponibles o utilizar código personalizado para entregar el evento.

Similar a antes, una vez configurada la regla, debe agregarla a una biblioteca y crear esa biblioteca en un entorno.

Una vez completada la compilación, el paso final es actualizar la secuencia de datos que configuró anteriormente y habilitar el reenvío de eventos. Para empezar, vaya a Datastreams y seleccione la secuencia de datos en cuestión en la lista. Desde aquí, habilite la opción para el reenvío de eventos y proporcione los nombres de la propiedad y el entorno que acaba de configurar.

Pasos siguientes

Esta guía proporciona información general de alto nivel sobre cómo enviar datos al Edge Network mediante el SDK web de Platform. Consulte la documentación relacionada con esta guía para obtener más información sobre los distintos componentes y servicios implicados.