Configuración del reenvío de eventos con datos del SDK web de Platform
Aprenda a utilizar el reenvío de eventos con 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. Descubra las ventajas del reenvío de eventos en la Resumen 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. (Entrada Admin Console, en el producto de Adobe Experience Platform Launch, elementos de permiso paraPlataformas > Edge y todo Derechos de propiedad). Una vez concedida, 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:
-
Seleccionar Reenvío de eventos desde la navegación izquierda
-
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 Recopilación de datos interfaz
-
En el panel de navegación izquierdo, seleccione Datastreams
-
Seleccione el creado anteriormente
Luma Web SDK: Development Environment
secuencia de datos -
Seleccionar Añadir servicio
-
Seleccionar Reenvío de eventos como el Servicio
-
En el 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 ID de entorno , seleccione el entorno de etiquetas al que está vinculando el entorno de reenvío de eventos, en este caso
Development
note tip TIP Para enviar datos a un entorno fuera de la organización de Adobe, seleccione Introducir ID manualmente y pegar en un ID. 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
prefijo:arc
significa 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 Configuración de un esquema XDM lección.
/ee
solicitudes, abrir la señalización Carga útil y profundizando en 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:![Ruta XDM de reenvío de eventos](./media_1f1f238d38f101ee7dc35acb73bea09e8352ae29a.png?width=750&format=png&optimize=medium)
-
Vaya a la Reenvío de eventos propiedad creada recientemente
-
En el panel de navegación izquierdo, seleccione Elementos de datos
-
Seleccionar para Crear nuevo elemento de datos
-
Nombre el elemento de datos
environment.browserDetails.viewportHeight
-
En Extensión, dejar
CORE
-
En Tipo de elemento de datos, seleccione
Path
-
Escriba la ruta del 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 it
ecid
-
En Extensión, dejar
CORE
-
En Tipo de elemento de datos, seleccione
Path
-
Escriba la ruta del objeto XDM que contiene el ID del Experience Cloud
arc.event.xdm.identityMap.ECID.0.id
-
Seleccionar Guardar
note caution CAUTION Asegúrese de incluir el arc.event.
prefijo 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 por /ee
solicitudes, abrir la señalización Carga útil y profundizando en 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 el Conector de Adobe Cloud extensión.
-
Seleccionar Extensiones en el panel de navegación izquierdo
-
Seleccione el Catálogo pestaña
-
Busque la variable 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 & 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 da por hecho que cada evento enviado al Edge Network de Platform es un déclencheur para reenviar datos. Por lo tanto, no hay Eventos que se deben 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,
-
Tokenización de elemento de datos:
-
Etiquetas: 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 utiliza en una regla. Por ejemplo,%viewportHeight%
. -
Reenvío de eventos: los nombres de los elementos de datos llevan un token
{{
al principio y}}
al final del nombre del elemento de datos cuando se utiliza 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
-
Buscar Su URL única, se usa como solicitud de URL en la regla del 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
-
Volver atrás Recopilación de datos > Reenvío de eventos > Reglas desde la navegación izquierda
-
Seleccionar Crear nueva regla
-
Asígnele un nombre
all events - ad cloud connector - webhook
-
Añadir una acción
-
En Extensión, seleccione Conector de Adobe Cloud
-
En Tipo de acción, seleccione Hacer llamada de recuperación
-
Pegue la dirección URL del webhook en URL campo
-
En [Parámetros de consulta], agregará ambos elementos de datos creados anteriormente.
-
En el Clave tipo de columna en
viewPortHeight
. En el Valor , introduzca la columna{{environment.browserDetails.viewportHeight}}
elemento de datos escribiéndolo o seleccionándolo en el icono del selector de elementos de datos -
Seleccionar + Agregar otro para agregar otro parámetro de consulta
-
En el Clave tipo de columna en
ecid
. En la columna Value, introduzca la variable{{ecid}}
elemento de datos -
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 el conjunto de datos.
-
Antes de volver a cargar la página, abra en Experience Platform Debugger. Registros desde la navegación izquierda
-
Seleccione el Edge pestaña, luego seleccione Connect para ver las solicitudes del Edge Network de Platform
-
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 debe centrar 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 las coincidencias de datos en Webhook.site así como al ver su ventana de webhook abierta
¡Felicidades! Ha configurado el reenvío de eventos.