DocumentaciónExperience PlatformTutorial de SDK web

Creación de reglas de etiquetas

Last update: Thu Mar 05 2026 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 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 Platform Web SDK, las reglas se utilizan para enviar eventos a Platform Edge Network 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 con el sitio web de demostración de Luma, y ha 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 cuatro 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. event es el déclencheur de la regla
  3. propósito es la acción principal realizada por la regla
  4. order es el orden en el que la regla debe activarse en relación con otras reglas que comparten el mismo evento

Añadir la extensión de capa de datos del cliente Adobe

El sitio web de Luma utiliza una capa de datos impulsada por evento denominada capa de datos del cliente de Adobe (ACDL). Cada vez que se produce un evento de capa de datos, se inserta en la matriz adobeDataLayer. Este tutorial utiliza una extensión de etiquetas denominada Capa de datos del cliente de Adobe para aprovechar convenientemente estos eventos para construir nuestras reglas.

Para añadir la extensión:

  1. Ir a Extensiones

  2. Filtrar a capa de datos del cliente de Adobe

  3. Seleccionar Instalar

    Agregar extensión de capa de datos del cliente de Adobe

  4. Mantener la configuración predeterminada

  5. Seleccionar Guardar

NOTE
No es necesario utilizar la capa de datos del cliente de Adobe para implementar Experience Platform Web SDK. Muchos otros tipos de eventos se utilizan normalmente en implementaciones de etiquetas (Library Loaded, DOM Ready, Window Loaded, etc.) para activar reglas.

Creación de reglas de etiquetas

En las etiquetas, las reglas se utilizan para ejecutar acciones como configurar variables y activar llamadas de red bajo diversas condiciones. La extensión de etiquetas Experience Platform Web SDK incluye dos acciones que se utilizan en las reglas:

  • Variable de actualización asigna elementos de datos a sus variables de datos o XDM
  • Enviar evento realiza la llamada de red para enviar datos a Experience Platform Edge Network

En el resto de esta lección:

  1. Utilice la acción Actualizar variable para definir una "configuración global" de los campos XDM.

  2. Use de nuevo la acción Actualizar variable para anular la "configuración global" y contribuir con campos XDM adicionales en ciertas condiciones (por ejemplo, al agregar detalles del producto en páginas de productos).

  3. Use la acción Enviar evento para enviar los datos a Adobe Experience Platform Edge Network.

Todas estas reglas se secuenciarán correctamente usando la opción "order".

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

https://video.tv.adobe.com/v/3454030/?captions=spa&learn=on&enablevpops

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. Vaya a Reglas en el panel de navegación izquierdo

  3. Seleccione el botón Crear nueva regla

    Crear una regla

  4. Asigne un nombre a la regla all pages - adobeDataLayer push - set global variables - 1.

  5. En la sección Eventos, seleccione Agregar

    Asigne un nombre a la regla y agregue un evento

  6. Utilice la extensión Adobe Client Data Layer y seleccione Datos insertados como Tipo de evento

  7. Seleccione el menú desplegable Avanzado e introduzca 1 como 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. Escuchar Todos los eventos

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

  10. En la sección Acciones, seleccione Agregar

  11. Como la extensión, seleccione Adobe Experience Platform Web SDK

  12. Como Tipo de acción, seleccione Actualizar variable

  13. Como elemento de datos, seleccione XDM Variable que creó en la lección Crear elementos de datos

    Actualizar esquema de variable

  14. Ahora, especifique los campos XDM asignándolos a los valores adecuados:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Campo XDM Mapa a
    eventType Web Webpagedetails Page Views (empiece a escribir para ver los valores sugeridos)
    identityMap Identity Map elemento de datos
    web.webPageDetails.name Page Name elemento de datos
    web.webPageDetails.pageViews.value 1
    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 el elemento de datos Identity Map es nulo, no se enviará el objeto identityMap. Por eso podemos definirlo con seguridad en nuestra "configuración global".
    note tip
    TIP
    La configuración web.webPageDetails.pageViews.value proporciona una forma estándar de indicar una vista de página para otras aplicaciones de flujo descendente. No es necesario que Adobe Analytics procese una llamada de red como una vista de página.

  15. Cuando haya terminado, su XDM Variable tendrá este aspecto. Observe cómo los campos rellenados y parcialmente rellenados se indican con los círculos azules:
    Variable XDM

  16. Seleccione Conservar cambios y luego Guardar la regla

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 Platform Edge Network.

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 regla con el número de orden 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. Asigne un nombre product detail pages - adobeDataLayer push - set product details variables - 20

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

  4. En Extensión, seleccione Capa de datos del cliente de Adobe

  5. En Tipo de evento, seleccione Datos insertados

  6. Seleccione para abrir Opciones avanzadas, escriba 20. Este valor de orden garantiza que la regla se ejecute después de la regla de variables globales.

  7. Escuchar un evento específico

  8. Escriba productView como evento/clave para registrarse en

  9. Seleccionar Conservar cambios

    Reglas XDM de Analytics

  10. En Acciones, seleccione Agregar

  11. Seleccione la extensión Adobe Experience Platform Web SDK

  12. Seleccione Tipo de acción como variable de actualización

  13. Seleccione XDM Variable como elemento de datos

  14. Asigne estos campos XDM a los valores adecuados:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Campo XDM Mapa a
    eventType Commerce Product Views (empiece a escribir para ver los valores sugeridos)
    commerce.productViews.value 1
    productListItems.name Ecommerce Product Name elemento de datos (seleccione Proporcionar elementos individuales y Agregar elemento primero )
    productListItems.sku Ecommerce Product Id elemento de datos

  15. Seleccionar Conservar cambios

  16. Seleccione Guardar para guardar la regla

    note note
    NOTE
    Debido a que esta regla tiene un orden superior, sobrescribirá el conjunto eventType en la regla de "configuración global". eventType solo puede contener un valor y se recomienda configurarlo con el evento más valioso.
    note tip
    TIP
    La configuración de commerce.productViews.value=1 en XDM se asigna automáticamente al evento prodView en Analytics

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 Ecommerce Cart Products que creó anteriormente recorre el objeto de capa de datos adobeDataLayer.ecommerce.cart.items del sitio web de Luma y lo traduce al formato requerido del objeto 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 la estructura de productListItems (sugerencia, debe coincidir).

NOTE
No podrá ejecutar _satellite.getVar('Ecommerce Cart Products') en este punto del tutorial.
IMPORTANT
Al asignar campos de la capa de datos al XDM, asegúrese de que los campos coincidan con el tipo de datos del campo XDM. En el ejemplo anterior quantity y priceTotal deben ser enteros, de lo contrario el registro no se introducirá en Platform.
Tipo de datos de esquema XDM ​

Ahora, asignemos la matriz al objeto XDM:

  1. Cree una nueva regla con el nombre cart page - adobeDataLayer push - set cart variables - 20

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

  3. En Extensión, seleccione Capa de datos del cliente de Adobe

  4. En Tipo de evento, seleccione Datos insertados

  5. Seleccione para abrir Opciones avanzadas, escriba 20. Este valor de orden garantiza que la regla se ejecute después de la regla de variables globales.

  6. Escuchar un evento específico

  7. Escriba cartView como evento/clave para registrarse en

  8. Seleccionar Conservar cambios

    Evento para la regla del carro de compras

  9. En Acciones, seleccione Agregar

  10. Seleccione la extensión Adobe Experience Platform Web SDK

  11. Seleccione Tipo de acción como variable de actualización

  12. Seleccione XDM Variable como elemento de datos

  13. Asigne estos campos XDM a los valores adecuados:

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Campo XDM Mapa a
    eventType Commerce Product List (Cart) Views (empiece a escribir para ver los valores sugeridos)
    commerce.productListViews.value 1
    productListItems Ecommerce Cart Products elemento de datos (seleccione Proporcionar toda la matriz primero )
    note tip
    TIP
    La configuración de commerce.productListViews.value=1 en XDM se asigna automáticamente al evento scView en Analytics

  14. Seleccionar Conservar cambios

  15. Seleccione Guardar para guardar la regla

Campos de confirmación de pedido

Cree otra regla para los eventos de compra:

  1. Cree una nueva regla con el nombre order confirmation - adobeDataLayer push - set purchase variables - 20

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

  3. En Extensión, seleccione Capa de datos del cliente de Adobe

  4. En Tipo de evento, seleccione Datos insertados

  5. Seleccione para abrir Opciones avanzadas, escriba 20. Este valor de orden garantiza que la regla se ejecute después de la regla de variables globales.

  6. Escuchar un evento específico

  7. Escriba purchase como evento/clave para registrarse en

  8. Seleccionar Conservar cambios

  9. En Acciones, seleccione Agregar

  10. Seleccione la extensión Adobe Experience Platform Web SDK

  11. Seleccione Tipo de acción como variable de actualización

  12. Seleccione XDM Variable como elemento de datos

  13. Asigne estos campos XDM a los valores adecuados:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
    Campo XDM Mapa a
    eventType Commerce Purchases (empiece a escribir para ver los valores sugeridos)
    commerce.productListViews.value 1
    commerce.order.purchaseID Ecommerce Purchase Id elemento de datos
    commerce.order.currencyCode USD
    productListItems Ecommerce Cart Products elemento de datos (seleccione Proporcionar toda la matriz primero )
    note tip
    TIP
    Si se establece commerce.productListViews.value en 1, commerce.order.purchaseID y commerce.order.currencyCode en XDM, se asignará automáticamente a las variables purchase, s.purchaseID y s.currencyCode en Analytics, respectivamente.

  14. Seleccionar Conservar cambios

  15. Seleccionar Guardar

Enviar regla de evento

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

  1. Cree una nueva regla con el nombre all pages - adobeDataLayer push - send event - 50

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

  3. En Extensión, seleccione Capa de datos del cliente de Adobe

  4. En Tipo de evento, seleccione Datos insertados

  5. Seleccione para abrir Opciones avanzadas, escriba 50 (que es probablemente el valor predeterminado). Este valor de orden garantiza que la regla se ejecute después de las reglas de configuración de variables.

  6. Escuchar Todos los eventos

  7. Seleccionar Conservar cambios

  8. En Acciones, seleccione Agregar

  9. Seleccione la extensión Adobe Experience Platform Web SDK

  10. Seleccione Tipo de acción como Enviar variable de evento

  11. Como Tipo de acción, seleccione Enviar evento

  12. Como XDM, seleccione el elemento de datos XDM Variable creado en la lección anterior

  13. Seleccione Conservar cambios para volver a la pantalla de regla principal

    Agregar la acción Enviar evento

  14. Seleccione Guardar para guardar la regla

    Guarde la regla

Debe tener las siguientes reglas en la propiedad:

Verificar lista de reglas

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. Vaya a Flujo de publicación en el panel de navegación izquierdo

  2. Seleccionar Agregar biblioteca

    Seleccionar Agregar biblioteca

  3. Para Name, escriba 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 la JavaScript base requerida por todas las propiedades de etiquetas web.

  6. Seleccione Guardar y generar para desarrollo

    Crear y compilar 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 la pantalla Flujo de publicación, 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 Adobe Experience Platform Debugger.

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