DocumentaciónExperience PlatformTutorial de SDK web

Creación de reglas de etiquetas

Last update: Sat Jun 01 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Principiante
  • Intermedio
  • Desarrollador

Obtenga información sobre cómo enviar eventos al Edge Network de Adobe Experience Platform con el objeto XDM mediante reglas de etiquetas. Una regla de etiqueta es una combinación de eventos, condiciones y acciones que indica a la propiedad de etiqueta que haga algo. Con el SDK web de Platform, las reglas se utilizan para enviar eventos al Edge Network de Platform con los datos adecuados.

Objetivos de aprendizaje

Al final de esta lección, puede hacer lo siguiente:

  • Utilice una convención de nombres para administrar reglas dentro de las etiquetas
  • Envío de un evento con campos XDM mediante las acciones Actualizar variable y Enviar evento
  • Apilar varios conjuntos de campos XDM en varias reglas
  • Asignar elementos de datos de matriz individuales o completos al objeto XDM
  • Publicación de una regla de etiqueta en una biblioteca de desarrollo

Requisitos previos

Está familiarizado con las etiquetas de recopilación de datos y las Sitio de demostración de Luma y haya completado las lecciones anteriores en el tutorial:

Convenciones de nomenclatura

Para administrar reglas en etiquetas, se recomienda seguir una convención de nombres estándar. Este tutorial utiliza una convención de nombres de cinco partes:

  • [ubicación] - [evento] - [propósito] - [pedido]

donde;

  1. ubicación es la página o páginas del sitio donde se activa la regla
  2. evento es el déclencheur de la regla
  3. propósito es la acción principal realizada por la regla
  4. pedido es el orden en que la regla debe activarse en relación con otras reglas

Creación de reglas de etiquetas

En las etiquetas, las reglas se utilizan para ejecutar acciones (llamadas de activación) bajo varias condiciones. La extensión de etiquetas del SDK web de Platform incluye dos acciones que se utilizan en esta lección:

  • Actualizar variable asigna elementos de datos a propiedades en un objeto XDM
  • Enviar evento envía el objeto XDM al Edge Network del Experience Platform

En el resto de esta lección:

  1. Cree una regla con Actualizar variable acción para definir una "configuración global" de campos XDM.

  2. Creación de reglas adicionales con Actualizar variable Acciones que anulan nuestra "configuración global" y aportan campos XDM adicionales en determinadas condiciones (por ejemplo, añadir detalles del producto en páginas de productos).

  3. Cree otra regla con Enviar evento acción, que enviará el objeto XDM completo al Edge Network de Adobe Experience Platform.

Todas estas reglas se secuenciarán correctamente usando el complemento "pedidoOpción ".

Este vídeo ofrece información general del proceso:

https://video.tv.adobe.com/v/3427710/?learn=on

Campos de configuración global

Para crear una regla de etiqueta para los campos XDM globales:

  1. Abra la propiedad de etiqueta que está utilizando para este tutorial.

  2. Ir a Reglas en el panel de navegación izquierdo

  3. Seleccione el Crear nueva regla botón

    Creación de una regla

  4. Asigne un nombre a la regla all pages - library loaded - set global variables - 1.

  5. En el Eventos , seleccione Añadir

    Asignar un nombre a la regla y añadir un evento

  6. Utilice el Extensión principal y seleccione Library Loaded (Page Top) como el Tipo de evento

  7. Seleccionar Avanzadas desplegable e introduzca 1 como el Pedido

    note note
    NOTE
    Cuanto más bajo sea el número de pedido, más pronto se ejecutará. Por lo tanto, le damos a nuestra "configuración global" un número de pedido bajo.

  8. Seleccionar Conservar cambios para volver a la pantalla de regla principal
    Seleccionar Déclencheur cargado de biblioteca

  9. En el Acciones , seleccione Añadir

  10. Como el Extensión, seleccione SDK web de Adobe Experience Platform

  11. Como el Tipo de acción, seleccione Actualizar variable

  12. Como el Elemento de datos, seleccione la xdm.variable.content que creó en la Creación de elementos de datos lección

    Actualizar esquema de variables

Ahora, asigne los elementos de datos a la esquema utilizado por el objeto XDM. Puede asignar a propiedades individuales u objetos completos. En este ejemplo, se asigna a propiedades individuales:

  1. Busque el campo eventType y selecciónelo

  2. Introduzca el valor web.webpagedetails.pageViews

    note tip
    TIP
    Para comprender qué valores se rellenan en eventType , debe ir a la página de esquema y seleccionar el campo eventType para ver los valores sugeridos en el carril derecho. También puede introducir un nuevo valor, si es necesario.
    valores sugeridos por eventType en la página de esquemas

  3. A continuación, busque la identityMap en el esquema y selecciónelo

  4. Mapa a identityMap.loginID elemento de datos

    Actualizar mapa de identidad variable

    note tip
    TIP
    Los campos XDM no se incluirán en la solicitud de red si el elemento de datos es nulo. Por lo tanto, cuando el usuario no está autenticado y la variable identityMap.loginID el elemento de datos es nulo, el identityMap no se enviará el objeto. Por eso podemos definirlo en nuestra "configuración global".

  5. Desplácese hacia abajo hasta que llegue al web objeto

  6. Seleccione para abrirlo

  7. Asigne los siguientes elementos de datos al correspondiente web Variables XDM

    • web.webPageDetials.name hasta %page.pageInfo.pageName%
    • web.webPageDetials.server hasta %page.pageInfo.server%
    • web.webPageDetials.siteSection hasta %page.pageInfo.hierarchie1%

  8. Configure web.webPageDetials.pageViews.value como 1.

    Actualización del contenido de variables

    note tip
    TIP
    Mientras que ninguno eventType establezca en web.webpagedetails.pageViews ni web.webPageDetails.pageViews.value son necesarios para que Adobe Analytics procese una señalización como vista de página, resulta útil disponer de una forma estándar de indicar una vista de página para otras aplicaciones de flujo descendente.

  9. Seleccionar Conservar cambios y luego Guardar la regla de la siguiente pantalla para terminar de crearla

Campos de página de producto

Ahora, empiece a usar Actualizar variable en reglas adicionales secuenciadas para enriquecer el objeto XDM antes de enviarlo a Edge Network de plataforma.

TIP
El orden de las reglas determina qué regla se ejecuta primero cuando se activa un evento. Si dos reglas tienen el mismo tipo de evento, se ejecuta primero la que tenga el número más bajo.

Comience por rastrear las vistas de productos en la página de detalles del producto de Luma:

  1. Seleccionar Agregar regla

  2. Asígnele un nombre ecommerce - library loaded - set product details variables - 20

  3. Seleccione el símbolo + en Evento para añadir un nuevo déclencheur

  4. En Extensión, seleccione Núcleo

  5. En Tipo de evento, seleccione Library Loaded (Page Top)

  6. Seleccionar para abrir Opciones avanzadas, escriba 20. Este valor de orden garantiza la ejecución de la regla después el all pages - library loaded - set global variables - 1 que establece la configuración global.

  7. Seleccionar Conservar cambios

    Reglas XDM de Analytics

  8. En Condiciones, seleccione para Añadir

  9. Salir Tipo de lógica as Normal

  10. Salir Extensión as Núcleo

  11. Seleccionar Tipo de condición as Ruta sin cadena de consulta

  12. A la derecha, habilite la Regex alternar

  13. En ruta igual a set /products/. Para el sitio de demostración de Luma, garantiza que la regla solo incluya déclencheur en las páginas de productos

  14. Seleccionar Conservar cambios

    Reglas XDM de Analytics

  15. En Acciones select Añadir

  16. Seleccionar SDK web de Adobe Experience Platform extensión

  17. Seleccionar Tipo de acción as Actualizar variable

  18. Seleccionar xdm.variable.content como el Elemento de datos

  19. Desplácese hacia abajo hasta el commerce objeto

  20. Abra el productViews objeto y conjunto valor hasta 1

    configurar vista de producto

    note tip
    TIP
    La configuración de commerce.productViews.value=1 en XDM se asigna automáticamente al prodView evento en Analytics

  21. Desplácese hacia abajo hasta eventType y configúrelo en commerce.productViews

    note note
    NOTE
    Debido a que esta regla tiene un orden superior, sobrescribirá la variable eventType se establece en la regla "configuración global". eventType solo puede contener un valor, y se recomienda configurarlo con el evento más valioso.

  22. Desplácese hacia abajo hasta y seleccione productListItems matriz

  23. Seleccionar Proporcionar elementos individuales

  24. Seleccionar Agregar elemento

    Estableciendo evento de vista de producto

    note caution
    CAUTION
    El productListItems es un array tipo de datos, de modo que espera que los datos se incluyan como una colección de elementos. Debido a la estructura de capas de datos del sitio de demostración de Luma y a que solo es posible ver un producto a la vez en el sitio de Luma, los elementos se agregan de forma individual. Al implementar en su propio sitio web, en función de la estructura de la capa de datos, puede proporcionar una matriz completa.

  25. Seleccionar para abrir Elemento 1

  26. Mapa productListItems.item1.SKU hasta %product.productInfo.sku%

    Variable del objeto XDM de SKU del producto

  27. Seleccionar Conservar cambios

  28. Seleccionar Guardar para guardar la regla

Campos del carro de compras

Puede asignar toda la matriz a un objeto XDM, siempre que la matriz coincida con el formato del esquema XDM. El elemento de datos de código personalizado cart.productInfo ha creado bucles anteriores a través de digitalData.cart.cartEntries objeto de capa de datos en Luma y lo traduce al formato requerido del productListItems del esquema XDM.

Para ilustrarlo, consulte la comparación a continuación de la capa de datos del sitio de Luma (izquierda) con el elemento de datos traducido (derecha):

Formato de matriz de objeto XDM

Comparar el elemento de datos con productListItems estructura (sugerencia, debe coincidir).

IMPORTANT
Observe cómo se traducen las variables numéricas, con valores de cadena en la capa de datos como price y qty se ha cambiado el formato a números en el elemento de datos. Estos requisitos de formato son importantes para la integridad de los datos en Platform y se determinan durante la configuración de esquemas paso. En el ejemplo, cantidad utiliza el Entero tipo de datos.
Tipo de datos del esquema XDM

Ahora, asignemos la matriz al objeto XDM:

  1. Cree una nueva regla con el nombre ecommerce - library loaded - set shopping cart variables - 20

  2. Seleccione el símbolo + en Evento para añadir un nuevo déclencheur

  3. En Extensión, seleccione Núcleo

  4. En Tipo de evento, seleccione Library Loaded (Page Top)

  5. Seleccionar para abrir Opciones avanzadas, escriba 20

  6. Seleccionar Conservar cambios

    Reglas XDM de Analytics

  7. En Condiciones, seleccione para Añadir

  8. Salir Tipo de lógica as Normal

  9. Salir Extensiones as Núcleo

  10. Seleccionar Tipo de condición as Ruta sin cadena de consulta

  11. A la derecha, no habilite el Regex alternar

  12. En ruta igual a set /content/luma/us/en/user/cart.html. Para el sitio de demostración de Luma, garantiza que la regla solo contenga déclencheur en la página del carro de compras

  13. Seleccionar Conservar cambios

    Reglas XDM de Analytics

  14. En Acciones select Añadir

  15. Seleccionar SDK web de Adobe Experience Platform extensión

  16. Seleccionar Tipo de acción as Actualizar variable

  17. Seleccionar xdm.variable.content como el Elemento de datos

  18. Desplácese hacia abajo hasta el commerce y seleccione para abrirlo.

  19. Abra el productListViews objeto y conjunto valor hasta 1

    configurar vista de producto

    note tip
    TIP
    La configuración de commerce.productListViews.value=1 en XDM se asigna automáticamente al scView evento en Analytics

  20. Seleccionar eventType y se establece en commerce.productListViews

  21. Desplácese hacia abajo hasta y seleccione productListItems matriz

  22. Seleccionar Proporcionar toda la matriz

  23. Mapa a cart.productInfo elemento de datos

  24. Seleccionar Conservar cambios

  25. Seleccionar Guardar para guardar la regla

Cree otras dos reglas para el cierre de compra y la compra siguiendo el mismo patrón con las siguientes diferencias:

Nombre de regla: ecommerce - library loaded - set checkout variables - 20

  1. Condición: /content/luma/us/en/user/checkout.html

  2. Configure eventType como commerce.checkouts.

  3. Configure commerce.checkout.value como 1.

    note tip
    TIP
    Esto equivale a configurar scCheckout evento en Analytics

Nombre de regla: ecommerce - library loaded - set purchase variables - 20

  1. Condición: /content/luma/us/en/user/checkout/order/thank-you.html

  2. Configure eventType como commerce.purchases.

  3. Configure commerce.purchases.value como 1.

    note tip
    TIP
    Esto equivale a configurar purchase evento en Analytics

  4. Establecer commerce.order.purchaseID a la cart.orderId elemento de datos

  5. Establecer commerce.order.currencyCode al valor codificado USD

    Estableciendo purchaseID para Analytics

    note tip
    TIP
    Esto equivale a configurar s.purchaseID y s.currencyCode variables en Analytics

  6. Desplácese hacia abajo hasta y seleccione productListItems matriz

  7. Seleccionar Proporcionar toda la matriz

  8. Mapa a cart.productInfo.purchase elemento de datos

  9. Seleccionar Conservar cambios

  10. Seleccionar Guardar

Cuando haya terminado, debería ver las siguientes reglas creadas.

Reglas XDM de Analytics

Enviar regla de evento

Ahora que ha establecido las variables, puede crear la regla para enviar el objeto XDM completo al Edge Network de Platform con la variable Enviar evento acción.

  1. A la derecha, seleccione Agregar regla para crear otra regla

  2. Asigne un nombre a la regla all pages - library loaded - send event - 50.

  3. En el Eventos , seleccione Añadir

  4. Utilice el Extensión principal y seleccione Library Loaded (Page Top) como el Tipo de evento

  5. Seleccionar Avanzadas desplegable e introduzca 50 in Pedido. Esto garantizará que esta regla se active después de todas las demás reglas configuradas (que tenían 1 o 20 como su Pedido).

  6. Seleccionar Conservar cambios para volver a la pantalla de regla principal
    Seleccionar Déclencheur cargado de biblioteca

  7. En el Acciones , seleccione Añadir

  8. Como el Extensión, seleccione SDK web de Adobe Experience Platform

  9. Como el Tipo de acción, seleccione Enviar evento

  10. Como el XDM, seleccione la xdm.variable.content elemento de datos creado en la lección anterior

  11. Seleccionar Conservar cambios para volver a la pantalla de regla principal

    Añadir la acción Enviar evento

  12. Seleccionar Guardar para guardar la regla

    Guarde la regla

Publicación de las reglas en una biblioteca

A continuación, publique la regla en el entorno de desarrollo para poder verificar si funciona.

Para crear una biblioteca:

  1. Ir a Flujo de publicación en el panel de navegación izquierdo

  2. Seleccionar Añadir biblioteca

    Seleccione Añadir biblioteca.

  3. Para el Nombre, introduzca Luma Web SDK Tutorial

  4. Para el Entorno, seleccione Development

  5. Seleccionar Añadir todos los recursos modificados

    note note
    NOTE
    Debería ver todos los componentes de etiquetas creados en lecciones anteriores. La extensión Core contiene el JavaScript base requerido por todas las propiedades de etiquetas web.

  6. Seleccionar Guardar y generar para desarrollo

    Crear y crear la biblioteca

La biblioteca puede tardar unos minutos en crearse y, cuando se completa, muestra un punto verde a la izquierda del nombre de la biblioteca:

Compilación completa

Como puede ver en el Flujo de publicación En la pantalla de, hay mucho más en el proceso de publicación, que está fuera del ámbito de este tutorial. Este tutorial solo utiliza una biblioteca en el entorno de desarrollo.

Ahora está listo para validar los datos de la solicitud mediante el Adobe Experience Platform Debugger.

Siguiente

NOTE
Gracias por dedicar su tiempo a conocer el SDK web de Adobe Experience Platform. Si tiene preguntas, desea compartir comentarios generales o tiene sugerencias sobre contenido futuro, compártalas en este Entrada de discusión de la comunidad Experience League
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4