Configurar la extensión de etiqueta del SDK web

La extensión de etiquetas Web SDK envía datos a Adobe Experience Cloud desde las propiedades web a través del Edge Network del Experience Platform.

La extensión de le permite transmitir datos a Platform, sincronizar identidades, procesar señales de consentimiento de clientes y recopilar automáticamente datos de contexto.

En este documento se explica cómo configurar la extensión de etiqueta en la interfaz de usuario de Etiquetas.

Instalación de la extensión de etiqueta del SDK web install

La extensión de etiqueta del SDK web necesita que se instale una propiedad en. Si aún no lo ha hecho, consulte la documentación de creación de una propiedad de etiqueta.

Después de crear una propiedad, ábrala y seleccione la ficha Extensiones en la barra lateral izquierda.

Seleccione la ficha Catálogo. En la lista de extensiones disponibles, busque la extensión Web SDK y seleccione Instalar.

Imagen que muestra la interfaz de usuario de etiquetas con la extensión de SDK web seleccionada

Después de seleccionar Instalar, debe configurar la extensión de etiqueta del SDK web y guardar la configuración.

NOTE
La extensión de etiqueta solo se instala después de guardar la configuración. Consulte las secciones siguientes para obtener información sobre cómo configurar la extensión de etiqueta.

Configuración de la instancia general

Las opciones de configuración en la parte superior de la página indican a Adobe Experience Platform dónde enrutar los datos y qué configuraciones utilizar en el servidor.

Imagen que muestra la configuración general de la extensión de etiqueta del SDK web en la interfaz de usuario de etiquetas

  • Nombre: la extensión del SDK web de Adobe Experience Platform admite varias instancias en la página. El nombre se utiliza para enviar datos a varias organizaciones con una configuración de etiquetas. El nombre de instancia predeterminado es alloy. Sin embargo, puede cambiar el nombre de la instancia a cualquier nombre de objeto de JavaScript válido.
  • ID de organización de IMS: ID de la organización a la que desea que se envíen los datos durante el Adobe. La mayoría de las veces, utilice el valor predeterminado que se rellena automáticamente. Cuando tenga varias instancias en la página, rellene este campo con el valor de la segunda organización a la que desee enviar datos.
  • Dominio de Edge: Dominio desde el cual la extensión envía y recibe datos. El Adobe recomienda utilizar un dominio de origen (CNAME) para esta extensión. El dominio de terceros predeterminado funciona para entornos de desarrollo, pero no es adecuado para entornos de producción. Las instrucciones sobre cómo configurar un CNAME de origen se enumeran aquí.

Configuración del flujo de datos datastreams

Esta sección le permite seleccionar los flujos de datos que deben utilizarse para cada uno de los tres entornos disponibles (producción, ensayo y desarrollo).

Cuando se envía una solicitud al Edge Network, se utiliza un ID de conjunto de datos para hacer referencia a la configuración del lado del servidor. Puede actualizar la configuración sin tener que realizar cambios en el código del sitio web.

Consulte la guía de flujos de datos para obtener información sobre cómo configurar un flujo de datos.

Puede elegir una secuencia de datos de los menús desplegables disponibles, o seleccionar Introducir valores e introducir un ID de secuencia de datos personalizado para cada entorno.

Imagen que muestra la configuración de secuencia de datos de la extensión de etiqueta del SDK web en la interfaz de usuario de etiquetas

Configuración de privacidad privacy

Esta sección le permite configurar cómo el SDK web gestiona las señales de consentimiento de los usuarios desde el sitio web. En concreto, le permite seleccionar el nivel de consentimiento predeterminado que se supone de un usuario si no se ha proporcionado ninguna otra preferencia de consentimiento explícita.

El nivel de consentimiento predeterminado no se guarda en el perfil de usuario.

Imagen que muestra la configuración de privacidad de la extensión de etiqueta del SDK web en la interfaz de usuario de etiquetas

Nivel de consentimiento predeterminado
Descripción
En
Recopilar eventos que se producen antes de que el usuario proporcione preferencias de consentimiento.
Fuera
Descartar los eventos que se producen antes de que el usuario proporcione preferencias de consentimiento.
Pendiente
Eventos de cola que se producen antes de que el usuario proporcione preferencias de consentimiento. Cuando se proporcionan las preferencias de consentimiento, los eventos se recopilan o descartan según las preferencias proporcionadas.
Proporcionado por el elemento de datos
El nivel de consentimiento predeterminado está determinado por un elemento de datos independiente que usted defina. Al utilizar esta opción, debe especificar el elemento de datos mediante el menú desplegable proporcionado.
TIP
Use Out o Pending si necesita el consentimiento explícito del usuario para sus operaciones comerciales.

Configuración de la identidad identity

Esta sección le permite definir el comportamiento del SDK web en lo que respecta a la gestión de la identificación del usuario.

Imagen que muestra la configuración de identidad de la extensión de etiqueta del SDK web en la interfaz de usuario de etiquetas

  • Migrar ECID desde VisitorAPI: esta opción está habilitada de manera predeterminada. Cuando esta característica está habilitada, el SDK puede leer las cookies AMCV y s_ecid y establecer la cookie AMCV que usa Visitor.js. Esta característica es importante al migrar al SDK web, ya que algunas páginas podrían seguir utilizando Visitor.js. Esta opción permite al SDK seguir utilizando el mismo(a) ECID para que los usuarios no se identifiquen como dos usuarios independientes.

  • Usar cookies de terceros: cuando esta opción está habilitada, el SDK web intenta almacenar un identificador de usuario en una cookie de terceros. Si se realiza correctamente, el usuario se identifica como un solo usuario a medida que navega por varios dominios, en lugar de identificarse como un usuario independiente en cada dominio. Si esta opción está habilitada, es posible que el SDK aún no pueda almacenar el identificador de usuario en una cookie de terceros si el explorador no admite cookies de terceros o si el usuario lo ha configurado para no permitir cookies de terceros. En este caso, el SDK solo almacena el identificador en el dominio de origen.

    note important
    IMPORTANT
    ​>Las cookies de terceros no son compatibles con la funcionalidad ID de dispositivo de origen del SDK web.

Puede usar ID de dispositivos de origen o cookies de terceros, pero no puede usar ambas funciones simultáneamente.

Configuración de la personalización personalization

Esta sección le permite configurar cómo desea ocultar determinadas partes de una página mientras se carga contenido personalizado. Esto garantiza que los visitantes solo vean la página personalizada.

Imagen que muestra la configuración de personalización de la extensión de etiqueta del SDK web en la interfaz de usuario de etiquetas

  • Migrar Target de at.js al SDK web: use esta opción para permitir que Web SDK lea y escriba las cookies heredadas de mbox y mboxEdgeCluster que usan las bibliotecas de at.js 1.x o 2.x. Esto le ayuda a mantener el perfil del visitante mientras se desplaza de una página que utiliza el SDK web a una página que utiliza bibliotecas at.js 1.x o 2.x, y viceversa.

Estilo preocultado prehiding-style

El editor de estilos preocultado permite definir reglas CSS personalizadas para ocultar secciones específicas de una página. Cuando se carga la página, el SDK web utiliza este estilo para ocultar las secciones que deben personalizarse, recupera la personalización y, a continuación, muestra las secciones de página personalizadas. De este modo, los visitantes ven las páginas ya personalizadas, sin ver el proceso de recuperación de la personalización.

Preocultando fragmento prehiding-snippet

El fragmento de preocultación resulta útil cuando la biblioteca del SDK web se carga asincrónicamente. En este caso, para evitar parpadeos, se recomienda ocultar el contenido antes de cargar la biblioteca del SDK web.

Para utilizar el fragmento preocultado, cópielo y péguelo dentro del elemento <head> de su página.

IMPORTANT
Al utilizar el fragmento preocultado, Adobe recomienda utilizar la misma regla de CSS que la utilizada por estilo preocultado.

Configuración de la recopilación de datos data-collection

Administrar las opciones de configuración de recopilación de datos. Hay configuraciones similares disponibles en la biblioteca JavaScript mediante el comando configure.

Imagen que muestra la configuración de recopilación de datos de la extensión de etiquetas del SDK web en la interfaz de usuario de etiquetas.

  • Activado antes de la devolución de llamada de envío de evento: Una función de devolución de llamada para evaluar y modificar la carga útil enviada al Adobe. Utilice la variable content dentro de la función de devolución de llamada para modificar la carga útil. Esta llamada de retorno es la etiqueta equivalente a onBeforeEventSend en la biblioteca de JavaScript.

  • Recopilar clics en vínculos internos: Casilla de verificación que permite recopilar datos de seguimiento de vínculos internos del sitio o la propiedad. Al activar esta casilla de verificación, aparecen las opciones de agrupación de eventos:

    • Sin agrupación de eventos: los datos de seguimiento de vínculos se envían al Adobe en eventos independientes. Los clics en vínculos enviados en eventos independientes pueden aumentar el uso contractual de los datos enviados a Adobe Experience Platform.
    • Agrupación de eventos mediante el almacenamiento de sesión: almacena los datos de seguimiento de vínculos en el almacenamiento de sesión hasta el siguiente evento de página. En la página siguiente, los datos de seguimiento de vínculos almacenados y los datos de vista de página se envían al Adobe al mismo tiempo. Adobe recomienda habilitar esta configuración al realizar el seguimiento de vínculos internos.
    • Agrupación de eventos mediante el objeto local: almacena los datos de seguimiento de vínculos en un objeto local hasta el siguiente evento de página. Si un visitante navega a una página nueva, se pierden los datos de seguimiento de vínculos. Esta configuración es más beneficiosa en el contexto de aplicaciones de una sola página.
  • Recopilar clics en vínculos externos: Casilla de verificación que habilita la recopilación de vínculos externos.

  • Recopilar clics en vínculos de descarga: Casilla de verificación que habilita la recopilación de vínculos de descarga.

  • Calificador de vínculo de descarga: una expresión regular que califica una dirección URL de vínculo como vínculo de descarga.

  • Filtrar propiedades de clic: una función de devolución de llamada para evaluar y modificar las propiedades relacionadas con los clics antes de la colección. Esta función se ejecuta antes de Activado antes de la devolución de llamada del envío de evento.

  • Configuración de contexto: recopile automáticamente información del visitante para rellenar automáticamente campos XDM específicos. Puede elegir Toda la información contextual predeterminada o Información contextual específica. Es la etiqueta equivalente a context en la biblioteca de JavaScript.

    • Web: recopila información sobre la página actual.
    • Dispositivo: recopila información sobre el dispositivo del usuario.
    • Entorno: recopila información acerca del explorador del usuario.
    • Contexto del lugar: recopila información sobre la ubicación del usuario.
    • Sugerencias de usuario-agente de alta entropía: Recopila información más detallada acerca del dispositivo del usuario.
TIP
El campo Activado antes de hacer clic en el vínculo enviar es una llamada de retorno obsoleta que solo está visible para propiedades que ya lo tienen configurado. Es la etiqueta equivalente a onBeforeLinkClickSend en la biblioteca de JavaScript. Use la llamada de retorno Filter click properties para filtrar o ajustar los datos de clics, o use la llamada de retorno Activado antes del envío de evento para filtrar o ajustar la carga útil general enviada al Adobe. Si se establecen tanto la devolución de llamada Filter click properties como la devolución de llamada Activada antes de enviar clic en vínculo, solo se ejecutará la devolución de llamada Filter click properties.

Configuración de la colección de medios media-collection

La función de recopilación de contenido le ayuda a recopilar datos relacionados con las sesiones de contenido del sitio web.

Los datos recopilados pueden incluir información sobre reproducciones de contenido, pausas, finalizaciones y otros eventos relacionados. Una vez recopilados, puede enviar estos datos a Adobe Experience Platform o Adobe Analytics para generar informes. Esta función proporciona una solución completa para realizar el seguimiento y comprender el comportamiento del consumo de medios en el sitio web.

Imagen que muestra la configuración de recopilación de medios de la extensión de etiquetas del SDK web en la interfaz de usuario de etiquetas

  • Canal: Nombre del canal donde se produce la recopilación de medios. Ejemplo: Video channel.
  • Nombre del reproductor: El nombre del reproductor multimedia.
  • Versión de la aplicación: La versión de la aplicación del reproductor multimedia.
  • Intervalo de ping principal: Frecuencia de pings para el contenido principal, en segundos. El valor predeterminado es 10. Los valores pueden oscilar entre 10 y 50 segundos. Si no se especifica ningún valor, se usa el valor predeterminado al usar sesiones con seguimiento automático.
  • Intervalo de ping de anuncio: Frecuencia de pings para contenido de anuncio, en segundos. El valor predeterminado es 10. Los valores pueden oscilar entre 1 y 10 segundos. Si no se especifica ningún valor, se usa el valor predeterminado al usar sesiones con seguimiento automático

Configurar anulaciones de secuencia de datos datastream-overrides

Las anulaciones de las secuencias de datos permiten definir configuraciones adicionales para las secuencias de datos, que pasan a la red perimetral mediante el SDK web.

Esto le ayuda a activar comportamientos de secuencias de datos diferentes de los predeterminados, sin crear una nueva secuencia de datos ni modificar la configuración existente.

La anulación de la configuración de la secuencia de datos es un proceso de dos pasos:

  1. En primer lugar, debe definir las anulaciones de configuración de la secuencia de datos en la página de configuración de secuencia de datos.
  2. A continuación, debe enviar las invalidaciones al Edge Network a través de un comando del SDK web o mediante la extensión de etiqueta del SDK web.

Consulte la documentación sobre las anulaciones de configuración de la secuencia de datos 1} para obtener instrucciones detalladas sobre cómo anular las configuraciones de la secuencia de datos.

Como alternativa a pasar las invalidaciones a través de un comando del SDK web, puede configurarlas en la pantalla de extensión de etiquetas que se muestra a continuación.

IMPORTANT
Las anulaciones de flujos de datos deben configurarse por entorno. Los entornos de desarrollo, ensayo y producción tienen invalidaciones independientes. Puede copiar los ajustes entre ellos utilizando las opciones dedicadas que se muestran en la pantalla siguiente.

Imagen que muestra las invalidaciones de configuración de la secuencia de datos usando la página de extensión de etiquetas del SDK web.

De forma predeterminada, la anulación de la configuración de la secuencia de datos está desactivada. La opción Coincidir configuración de secuencia de datos está seleccionada de forma predeterminada.

La interfaz de usuario de la extensión de etiquetas del SDK web que muestra la configuración de secuencia de datos invalida la configuración predeterminada.

Para habilitar las invalidaciones de secuencia de datos en la extensión de etiqueta, seleccione Habilitado en el menú desplegable.

La interfaz de usuario de la extensión de etiquetas del SDK web muestra las anulaciones de configuración de secuencia de datos habilitada.

Después de habilitar las invalidaciones de configuración de la secuencia de datos, puede configurar las invalidaciones para cada servicio descrito a continuación.

La configuración de anulación de la secuencia de datos que aparece a continuación anulará cualquier configuración y regla del conjunto de datos del lado del servidor para el entorno seleccionado.

Adobe Analytics analytics

Utilice la configuración de esta sección para anular el enrutamiento de datos al servicio Adobe Analytics.

Imagen de la interfaz de usuario de la extensión de etiquetas del SDK web que muestra la configuración de anulación de secuencia de datos de Adobe Analytics.

  • Habilitado / Deshabilitado: Use este menú desplegable para habilitar o deshabilitar el enrutamiento de datos al servicio Adobe Analytics.
  • Grupos de informes: Los ID de los grupos de informes de destino en Adobe Analytics. El valor debe ser un grupo de informes de anulación preconfigurado (o una lista de grupos de informes separados por comas) de la configuración del conjunto de datos. Esta configuración anula los grupos de informes principales.
  • Agregar grupo de informes: seleccione esta opción para agregar grupos de informes adicionales.

Adobe Audience Manager audience-manager

Utilice la configuración de esta sección para anular el enrutamiento de datos al servicio Adobe Audience Manager.

Imagen de la interfaz de usuario de la extensión de etiquetas del SDK web que muestra la configuración de anulación de secuencia de datos de Adobe Audience Manager.

  • Habilitado / Deshabilitado: Use este menú desplegable para habilitar o deshabilitar el enrutamiento de datos al servicio Adobe Audience Manager.
  • Contenedor de sincronización de ID de terceros: El ID del contenedor de sincronización de ID de terceros de destino en el Audience Manager. El valor debe ser un contenedor secundario preconfigurado de la configuración del conjunto de datos y anula el contenedor principal.

Adobe Experience Platform experience-platform

Utilice la configuración de esta sección para anular el enrutamiento de datos al servicio Adobe Experience Platform.

Imagen de la interfaz de usuario de la extensión de etiquetas del SDK web que muestra la configuración de anulación de secuencia de datos de Adobe Experience Platform.

  • Habilitado / Deshabilitado: Use este menú desplegable para habilitar o deshabilitar el enrutamiento de datos al servicio Adobe Experience Platform.
  • Conjunto de datos de evento: ID del conjunto de datos de evento de destino en Adobe Experience Platform. El valor debe ser un conjunto de datos secundario preconfigurado de la configuración del conjunto de datos.
  • Offer decisioning: utilice este menú desplegable para habilitar o deshabilitar el enrutamiento de datos al servicio Offer Decisioning.
  • Segmentación de Edge: use este menú desplegable para habilitar o deshabilitar el enrutamiento de datos al servicio Edge Segmentation.
  • Destinos de Personalization: utilice este menú desplegable para habilitar o deshabilitar el enrutamiento de datos a destinos de personalización.
  • Adobe Journey Optimizer: Utilice este menú desplegable para habilitar o deshabilitar el enrutamiento de datos al servicio Adobe Journey Optimizer.

Adobe Reenvío de eventos del lado del servidor ssf

Utilice la configuración de esta sección para anular el enrutamiento de datos al servicio de reenvío de eventos del lado del servidor de Adobe.

Imagen de la interfaz de usuario de la extensión de etiquetas del SDK web que muestra la configuración de anulación de secuencia de datos del reenvío de eventos del lado del servidor de Adobe.

  • Habilitado / Deshabilitado: Utilice este menú desplegable para habilitar o deshabilitar el enrutamiento de datos al servicio de reenvío de eventos del lado del servidor de Adobe.

Adobe Target target

Utilice la configuración de esta sección para anular el enrutamiento de datos al servicio Adobe Target.

Imagen de la interfaz de usuario de la extensión de etiquetas del SDK web que muestra la configuración de anulación de secuencia de datos de Adobe Target.

  • Habilitado / Deshabilitado: Use este menú desplegable para habilitar o deshabilitar el enrutamiento de datos al servicio Adobe Target.

Configuración avanzada

Utilice el campo ruta base de Edge si necesita cambiar la ruta base que se usa para interactuar con el Edge Network. Esto no debería requerir ninguna actualización, pero en caso de que participe en una versión beta o alfa, Adobe podría pedirle que cambie este campo.

Imagen que muestra la configuración avanzada mediante la página de extensión de etiquetas del SDK web.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743