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 su aplicación a Experience Platform Edge Network, 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 de la red perimetral 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 debe otorgar acceso al menos a una propiedad web junto con lo siguiente derechos de propiedad:

Consulte la guía de 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 dispone de todos los permissions en las siguientes categorías habilitadas:

Consulte la Introducción a IU 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 a la red perimetral, también puede configuración del reenvío de eventos si su organización dispone de una licencia para ello.

Creación de un esquema schema

Modelo de datos de experiencia (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 la red de Edge 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, seleccione Crear esquema, luego seleccione ExperienceEvent de XDM 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 Mezcla de ExperienceEvent del SDK web de AEP. 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 encontrado, selecciónelo en la lista antes de seleccionar Adición de 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 del árbol que desea 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 Añadir en el Grupos de campos en el carril izquierdo.

Una vez añadidos 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 a la red perimetral 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.

Seleccionar Datastreams en el panel de navegación izquierdo. Desde aquí, puede seleccionar un conjunto de datos existente de la lista para editarlo, o 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 información general sobre flujos de datos.

Instalación y configuración del SDK web install

Una vez que haya creado un esquema y una secuencia de datos, el siguiente paso es instalar y configurar el SDK web de Platform para que comience a enviar datos a la red perimetral.

El proceso puede resumirse de la siguiente manera:

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

Seleccionar 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 puede seleccionar Nueva propiedad en su lugar.

Si está creando una nueva propiedad, proporcione un nombre descriptivo y establezca el Plataforma hasta Web. Proporcione el dominio completo para la propiedad web y, a continuación, seleccione Guardar.

Aparecerá la página de información general de la propiedad. Desde aquí, seleccione Extensiones en el panel de navegación izquierdo, seleccione Catálogo. Busque la lista del SDK web de Platform (opcionalmente, utilizando 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 Datastreams, utilice el menú desplegable para seleccionar el conjunto de datos que configuró en una paso anterior. Una vez definido el conjunto 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 a la red perimetral, esos datos deben asignarse al esquema XDM creado en una paso anterior. Esta asignación se realiza mediante el uso de un elemento de datos.

En la interfaz de usuario, seleccione Elementos de datos, luego seleccione Crear nuevo elemento de datos.

En la pantalla siguiente, seleccione SDK web de Adobe Experience Platform en el 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 (*) indicar 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

Después de guardar el elemento de datos, el siguiente paso es crear una regla que lo envíe a la red perimetral 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, 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). Seleccionar Añadir bajo 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 Núcleo extensión y, a continuación, seleccione la Enviar tipo de evento en Form categoría.

El evento de envío de formularios le permite utilizar un Selector de CSS para hacer referencia a un elemento específico en el que la regla se debe activar. En el siguiente ejemplo, la variable ID add-to-cart-form se utiliza para que esta regla solo se active para el formulario "Agregar al carro de compras". Seleccionar Conservar cambios para añadir 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 la "If" añadiendo 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. Seleccionar Añadir bajo Acciones para continuar.

Aparecerá la página de configuración de la acción. Para obtener la regla para enviar datos a Edge Network, seleccione SDK web de Adobe Experience Platform para la extensión de, y Enviar evento 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 Tipo, puede proporcionar un valor de tipo personalizado para rellenar el eventType Campo XDM. 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 de una lista. Estos son los datos que se envían finalmente a la red perimetral.

Seleccionar Conservar cambios cuando termine.

Cuando haya terminado 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 de 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 instalado el entorno en el sitio web, puede hacer lo siguiente prueba de la implementación usando el Adobe Experience Platform Debugger.

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

Una vez configurado el SDK para enviar datos a la red perimetral, puede configurar el reenvío de eventos para indicar a la red perimetral 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. Seleccionar Reenvío de eventos en la navegación izquierda, 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 generación, el paso final es actualizar la secuencia de datos que desee configurado previamente y habilite 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 a la red perimetral 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.