Configuración del reenvío de eventos con datos del SDK web de Platform
Obtenga información sobre cómo utilizar el reenvío de eventos con los datos del SDK web de Adobe Experience Platform.
El reenvío de eventos es un nuevo tipo de propiedad disponible en la recopilación de datos. El reenvío de eventos le permite enviar datos a proveedores de terceros que no sean de Adobe directamente desde el Edge Network de Adobe Experience Platform, en lugar del explorador tradicional del lado del cliente. Obtenga más información acerca de las ventajas del reenvío de eventos en la descripción general del reenvío de eventos.
Para utilizar el reenvío de eventos en Adobe Experience Platform, primero deben enviarse datos al Edge Network de Adobe Experience Platform mediante una o varias de las tres opciones siguientes:
Después de completar las lecciones anteriores de este tutorial, debe enviar datos al Edge Network de Platform mediante el SDK web. Una vez que los datos están en Platform Edge Network, puede habilitar el reenvío de eventos y utilizar una propiedad de reenvío de eventos para enviar datos a soluciones que no sean de Adobe.
Objetivos de aprendizaje
Al final de esta lección, debe ser capaz de:
- Creación de una propiedad de reenvío de eventos
- Vinculación de una propiedad de reenvío de eventos a un conjunto de datos del SDK web de Platform
- Comprender las diferencias entre los elementos de datos de propiedades de etiquetas y las reglas y los elementos y reglas de datos de propiedades de reenvío de eventos
- Creación de un elemento de datos de reenvío de eventos
- Configuración de una regla de reenvío de eventos
- Validar que una propiedad de reenvío de eventos esté enviando datos correctamente
Requisitos previos
-
Licencia de software que incluye el reenvío de eventos. El reenvío de eventos es una función de pago de la recopilación de datos. Póngase en contacto con el equipo de su cuenta de Adobe para obtener más información.
-
El reenvío de eventos está activado en su organización de Experience Cloud.
-
Permiso de usuario para el reenvío de eventos. (En Admin Console, en el producto Adobe Experience Platform Launch, los elementos de permiso para Plataformas > Edge y todos los Derechos de propiedad). Una vez concedido, debería ver Reenvío de eventos en la navegación izquierda de la interfaz de recopilación de datos:
-
El SDK web o móvil de Adobe Experience Platform está configurado para enviar datos al Edge Network. Debe haber completado las siguientes lecciones de este tutorial:
-
Configuración inicial
-
Configuración de etiquetas
-
Creación de una propiedad de reenvío de eventos
Para empezar, cree una propiedad de reenvío de eventos:
-
Abrir la interfaz de recopilación de datos
-
Seleccione Reenvío de eventos en el panel de navegación izquierdo
-
Seleccione Nueva propiedad.
-
Asigne un nombre a la propiedad. En este caso,
Server-Side - Web SDK Course -
Seleccione Guardar.
Configuración de la secuencia de datos
Para que el reenvío de eventos utilice los datos que envía al Edge Network de Platform, debe vincular la propiedad de reenvío de eventos recién creada al mismo conjunto de datos utilizado para enviar datos a las soluciones de Adobe.
Para configurar Target en el conjunto de datos:
-
Ir a la interfaz de recopilación de datos
-
En el panel de navegación izquierdo, seleccione Datastreams
-
Seleccione la secuencia de datos
Luma Web SDK: Development Environmentcreada anteriormente
-
Seleccionar Agregar servicio
-
Seleccione Reenvío de eventos como servicio
-
En el menú desplegable Id. de propiedad, seleccione el nombre que dio a su propiedad de reenvío de eventos, en este caso
Server-Side - Web SDK Course -
En el menú desplegable Id. de entorno, seleccione el entorno de etiqueta al que está vinculando el entorno de reenvío de eventos, en este caso
Developmentnote tip TIP Para enviar datos a un entorno de reenvío de eventos fuera de la organización de Adobe, selecciona Introducir manualmente los identificadores y pega los datos en un identificador. El ID se proporciona al crear una propiedad de reenvío de eventos. -
Seleccione Guardar.
Repita estos pasos para los flujos de datos de ensayo y producción cuando esté listo para promocionar los cambios a través del flujo de publicación.
Reenviar datos del Edge Network de Platform a una solución que no sea de Adobe
En este ejercicio aprenderá a configurar un elemento de datos de reenvío de eventos, configurar una regla de reenvío de eventos y validar mediante una herramienta de terceros llamada Webhook.site.
Creación de un elemento de datos de reenvío de eventos
El objeto XDM configurado anteriormente con la extensión de etiqueta del SDK web de Platform se convierte en la fuente de datos para los elementos de datos en una propiedad de reenvío de eventos. Los mismos datos que ya se han configurado en la propiedad de etiquetas se utilizan como fuente de datos para el reenvío de eventos.
arc.event:arcsignifica contexto de respuesta de Adobe.- Por ejemplo:
arc.event.xdm.web.webPageDetails.URL
En este ejercicio, reenviará la altura de la ventanilla del explorador y el ID del Experience Cloud del objeto XDM a un webhook. La ruta del campo XDM está determinada por el esquema XDM creado durante la lección Configurar un esquema XDM.
/ee, abriendo la señalización Payload y explorando en profundidad la variable que está buscando. A continuación, haga clic con el botón derecho del ratón y seleccione "Copiar ruta de propiedad". Este es un ejemplo de la altura de la ventanilla del explorador:
-
Vaya a la propiedad Reenvío de eventos que creó recientemente
-
En el panel de navegación izquierdo, seleccione Elementos de datos
-
Seleccione para crear nuevo elemento de datos
-
Nombre el elemento de datos
environment.browserDetails.viewportHeight -
En extensión, deje
CORE -
En Tipo de elemento de datos, seleccione
Path -
Escriba la ruta de objeto XDM que contiene la altura de la ventanilla del explorador
arc.event.xdm.environment.browserDetails.viewportHeight -
Seleccionar Guardar
-
Crear otro elemento de datos
-
Nombre lo
ecid -
En extensión, deje
CORE -
En Tipo de elemento de datos, seleccione
Path -
Escriba la ruta del objeto XDM que contiene el ID de Experience Cloud
arc.event.xdm.identityMap.ECID.0.id -
Seleccionar Guardar
note caution CAUTION Asegúrese de incluir el prefijo arc.event.en la ruta. Además, asegúrese de seguir exactamente las mayúsculas y minúsculas como el nombre del campo Objeto XDM; el área de nombres ECID debe estar en mayúsculas.note tip TIP Al trabajar con su propio sitio web, puede encontrar la ruta del objeto XDM con las herramientas de red del explorador web, filtrando las solicitudes /ee, abriendo la señalización Payload y explorando en profundidad la variable que está buscando. A continuación, haga clic con el botón derecho del ratón y seleccione "Copiar ruta de propiedad". Este es un ejemplo de la altura de la ventanilla del explorador:
Instalación de la extensión de conector de Adobe Cloud
Para enviar datos a ubicaciones de terceros, primero debe instalar la extensión Conector de Adobe Cloud.
-
Seleccione Extensiones en el panel de navegación izquierdo
-
Seleccione la ficha Catálogo
-
Busque Conector de Adobe Cloud, seleccione Instalar
No se necesita ninguna configuración de extensión. Con esta extensión, ahora puede reenviar datos a una solución que no sea de Adobe.
Creación de una regla de reenvío de eventos
Existen algunas diferencias principales entre la configuración de reglas en una propiedad de etiqueta y una regla en una propiedad de reenvío de eventos:
-
Eventos y Condiciones:
- Etiquetas: todas las reglas se activan mediante un Evento que debe especificarse en la regla, por ejemplo,
Library Loaded - Page Top. Las condiciones son opcionales. - Reenvío de eventos: Se supone que cada evento enviado al Edge Network de Platform es un déclencheur para reenviar datos. Por lo tanto, no hay Eventos que se deban seleccionar en las reglas de reenvío de eventos. Para administrar qué eventos almacenan en déclencheur una regla de reenvío de eventos, debe configurar las condiciones.
- Etiquetas: todas las reglas se activan mediante un Evento que debe especificarse en la regla, por ejemplo,
-
Token de elemento de datos:
-
Tags: los nombres de los elementos de datos se identifican mediante token con un
%al principio y al final del nombre del elemento de datos cuando se utilizan en una regla. Por ejemplo,%viewportHeight%. -
Reenvío de eventos: los nombres de los elementos de datos se identifican mediante token con
{{al principio y}}al final del nombre del elemento de datos cuando se utilizan en una regla. Por ejemplo,{{viewportHeight}}.
-
-
Secuencia de acciones de regla:
- La sección Acciones de una regla de reenvío de eventos siempre se ejecuta secuencialmente. Asegúrese de que el orden de las acciones es correcto al guardar una regla. Esta secuencia de ejecución no se puede ejecutar de forma asíncrona como con las etiquetas.
Para configurar una regla para reenviar datos a su webhook, primero debe obtener su webhook personal:
-
Ir a webhook.site
-
Busque su dirección URL única, la usa como solicitud de dirección URL en la regla de reenvío de eventos
-
Seleccionar Copiar al portapapeles
-
Deje esta ventana abierta, ya que podrá validar los datos del reenvío de eventos en tiempo real que captura Webhook
-
Retroceder Recopilación de datos > Reenvío de eventos > Reglas desde la navegación izquierda
-
Seleccionar Crear nueva regla
-
Asigne un nombre
all events - ad cloud connector - webhook -
Añadir una acción
-
En Extensión, seleccione Conector de nube de Adobe
-
En Tipo de acción, seleccione Realizar llamada de recuperación
-
Pegue la URL de Webhook en el campo URL
-
En [Parámetros de consulta], agregará ambos elementos de datos que creó anteriormente.
-
En el tipo de columna Clave de
viewPortHeight. En la columna Valor, escriba el elemento de datos{{environment.browserDetails.viewportHeight}}; para ello, escríbalo o selecciónelo en el icono del selector de elementos de datos -
Seleccione + Agregar otro para agregar otro parámetro de consulta
-
En el tipo de columna Clave de
ecid. En la columna Valor, escriba el elemento de datos{{ecid}} -
Seleccionar Conservar cambios
-
La regla debe ser similar a la siguiente
-
Seleccionar Guardar
Crear y crear la biblioteca
Cree una biblioteca y todos los cambios en el entorno de desarrollo del reenvío de eventos como lo haría normalmente en una propiedad de etiquetas.
Validar regla de reenvío de eventos
Ahora puede validar la propiedad de reenvío de eventos mediante Platform Debugger y Webhook.site:
-
Siga los pasos para cambiar la biblioteca de etiquetas en el sitio de demostración de Luma a la propiedad de etiquetas del SDK web a la que asignó la propiedad de reenvío de eventos en la secuencia de datos.
-
Antes de volver a cargar la página, en Experience Platform Debugger abra Registros desde el panel de navegación izquierdo
-
Seleccione la ficha Edge y, a continuación, seleccione Connect para ver las solicitudes del Edge Network de la plataforma
-
Volver a cargar la página
-
Verá solicitudes adicionales que le proporcionan visibilidad de las solicitudes del lado del servidor que el Edge Network de Platform envía al enlace web
-
La solicitud en la que se centra la validación es la que muestra la dirección URL completamente construida que envía la red de Edge
-
Observe los parámetros de cadena de consulta viewPortHeight y ecid
-
Coinciden con los datos que se ven en el objeto XDM
-
Por último, valide también las coincidencias de datos en Webhook.site al ver la ventana de Webhook abierta
¡Felicidades! Ha configurado el reenvío de eventos.