Información general sobre la extensión Adobe Target v2

NOTE
Adobe Experience Platform Launch se ha convertido en un conjunto de tecnologías de recopilación de datos en Adobe Experience Platform. Como resultado, se han implementado varios cambios terminológicos en la documentación del producto. Consulte el siguiente documento para obtener una referencia consolidada de los cambios terminológicos.

Utilice esta referencia para obtener información sobre las opciones disponibles al utilizar esta extensión para generar una regla.

Configurar la extensión de Adobe Target v2

IMPORTANT
La extensión Adobe Target requiere At.js 2.x.

Si la extensión de Adobe Target todavía no está instalada, abra su propiedad, seleccione Extensiones > Catálogo, coloque el puntero sobre la extensión de grupo de destinatarios y seleccione Instalar.

Para configurar la extensión, abra la pestaña Extensiones, pase el puntero sobre la extensión y, a continuación, seleccione Configurar.

Configuración de at.js

Todos los ajustes de at.js, excepto el Tiempo de espera, se recuperan automáticamente de la configuración de at.js en la interfaz de usuario de Target. La extensión solo recupera la configuración de la interfaz de usuario de Target cuando se agrega por primera vez, por lo que todos los ajustes se deben administrar en la interfaz de usuario si se necesitan actualizaciones adicionales.

Las opciones de configuración disponibles son las siguientes:

Código de cliente

El código de cliente es el identificador de cuenta de Target. Esto debe mantenerse casi siempre con el valor predeterminado. Se puede cambiar utilizando elementos de datos.

ID de organización

Este ID vincula la implementación con su cuenta de Adobe Experience Cloud. Esto debe mantenerse casi siempre con el valor predeterminado. Se puede cambiar utilizando elementos de datos.

Dominio del servidor

El dominio del servidor hace referencia al dominio al que se envían las solicitudes de Target. Esto debe mantenerse casi siempre con el valor predeterminado.

Inclusión del RGPD

Cuando está habilitada, Adobe Target proporciona la funcionalidad de inclusión para apoyar su estrategia de administración de consentimiento. La funcionalidad de inclusión permite a los clientes controlar cómo y cuándo se inicia la etiqueta de Target. Para obtener más información sobre la inclusión de Adobe, consulte  Privacidad y Reglamento General de Protección de Datos (RGPD).

Tiempo de espera (ms)

Si la respuesta de Target no se recibe dentro del período definido, se agota el tiempo de espera de la solicitud y se muestra el contenido predeterminado. Se siguen realizando solicitudes adicionales durante la sesión del visitante. El valor predeterminado es 3000 ms, que puede diferir del tiempo de espera configurado en la interfaz de usuario de Target.

Para obtener más información sobre cómo funciona la configuración de Timeout, consulte la ayuda de Adobe Target.

Tipos de acción de extensión de Target

En esta sección se describen los tipos de acción disponibles en la extensión de Target.

La extensión de Target proporciona las siguientes acciones en la porción Then de una regla:

Enviar baliza

Añada esta acción a la regla de etiqueta donde tiene sentido cargar Target en el contexto de la regla. Esto carga la biblioteca at.js en la página. En la mayoría de las implementaciones, Target debe cargarse en todas las páginas del sitio. Adobe recomienda usar la acción Load Target solo si va precedida de una llamada de Target. De lo contrario, podría tener problemas como la demora de la llamada de Analytics.

No es necesaria ninguna configuración.

Carga de Target con la toma de decisiones en el dispositivo

Añada esta acción a la regla de etiqueta donde tiene sentido cargar Target con la toma de decisiones en el dispositivo activada en el contexto de la regla. Esto carga la biblioteca at.js con la toma de decisiones en el dispositivo habilitada en la página. En la mayoría de las implementaciones, Target debe cargarse en todas las páginas del sitio. Adobe recomienda usar la acción Cargar destinatario con toma de decisiones en el dispositivo solo si va precedida de una llamada de Target. De lo contrario, podría tener problemas como la demora de la llamada de Analytics.

No es necesaria ninguna configuración.

Agregar parámetros a todas las solicitudes

Este tipo de acción permite agregar parámetros a todas las solicitudes de Target. La acción Load Target debe usarse anteriormente.

  1. Especifique el nombre y el valor de cualquier parámetro que desee añadir.
  2. Seleccione el icono de añadir para añadir más parámetros.

Agregar parámetros a solicitud de carga de página

Este tipo de acción permite agregar parámetros específicamente a las solicitudes de carga de página. La acción Load Target debe usarse anteriormente.

  1. Especifique el nombre y el valor de cualquier parámetro que desee añadir.
  2. Seleccione el icono de añadir para añadir más parámetros.

Fire Page Load Request

Este tipo de acción permite a Target activar una solicitud cuando se carga la página. La acción Load Target debe usarse anteriormente.

Especifique si desea habilitar la ocultación del cuerpo para evitar parpadeos y el estilo utilizado al ocultar el elemento de cuerpo. Las opciones disponibles son las siguientes:

  • Ocultación del cuerpo: puede habilitar o deshabilitar esta configuración. El valor predeterminado es Enabled, lo cual significa que BODY de HTML está oculto.
  • Estilo oculto del cuerpo: el valor predeterminado es body {opacity: 0}. Este valor se puede cambiar por otro, por ejemplo, body{display:none}.

Para obtener más información, consulte la documentación de ayuda en línea de Target.

Activar vista

Se puede llamar a la acción de vista de activación cada vez que se carga una página nueva o cuando se vuelve a procesar un componente de una página. La vista de activación debe implementarse para las aplicaciones de una sola página.

  1. Especifique el nombre de vista que se debe activar.
  2. Especifique si el activador de la vista debe atribuirse a una impresión para los informes marcando la casilla de verificación Page. Si la vista se correlaciona con un componente que se vuelve a procesar y no atribuye a una impresión para informes, deje la casilla de verificación Page desmarcada.

Para obtener más información sobre cómo activar una vista, consulte triggerView() la documentación de ayuda.

Implementación básica de Adobe Target

Una vez que está instalada la extensión de Target, debe crear al menos una regla para implementarla correctamente. Primero debe cargar la biblioteca de Target (at.js), especificar los parámetros que desea utilizar con la solicitud de carga de página y activar la solicitud de carga de página.

Una regla de Target con esta implementación básica tiene este aspecto:

Una vez guardada esta regla, debe añadirla a una biblioteca y crearla o implementarla para poder probar su comportamiento.

Extensión de Adobe Target con implementación asíncrona

Las etiquetas se pueden implementar de forma asíncrona. Si carga la biblioteca de etiqueta de forma asíncrona con Target dentro de ella, Target también se cargará de forma asíncrona. Se trata de una situación totalmente compatible, pero hay una consideración adicional que se debe gestionar.

En implementaciones asincrónicas, es posible que la página termine de procesar el contenido predeterminado antes de que la biblioteca de Target se cargue completamente y haya realizado el intercambio de contenido. Esto puede llevar a lo que se conoce como "parpadeo" en el que el contenido predeterminado se muestra brevemente antes de ser reemplazado por el contenido personalizado especificado por Target. Si desea evitar este parpadeo, le sugerimos utilizar un fragmento preocultado y cargar el paquete de etiqueta de forma asíncrona para evitar cualquier parpadeo del contenido.

A continuación se indican algunos aspectos que se deben tener en cuenta al utilizar el fragmento de preocultamiento:

  • Se debe agregar el fragmento antes de cargar el código incrustado del encabezado de etiqueta.

  • Las etiquetas no pueden gestionar este código, por lo que debe añadirse directamente a la página.

  • La página se muestra cuando se produce el primero de los siguientes eventos:

    • Cuando se recibe la respuesta de carga de página
    • Cuando se agota el tiempo de espera de la solicitud de página
    • Cuando se agota el tiempo de espera del propio fragmento
  • La acción "Fire Page Load Request" debe usarse en todas las páginas utilizando el fragmento de preocultación para minimizar su duración.

  • También debe habilitarse la opción de ocultar el cuerpo en la acción de solicitud de carga de página de la regla de carga de página que use para Target; de lo contrario, todas las cargas de página permanecerán ocultas durante el periodo de espera.

El fragmento de código de preocultamiento es el siguiente y se puede minimizar. Las opciones configurables se encuentran al final:

;(function(win, doc, style, timeout) {
  var STYLE_ID = 'at-body-style';

  function getParent() {
    return doc.getElementsByTagName('head')[0];
  }

  function addStyle(parent, id, def) {
    if (!parent) {
      return;
    }

    var style = doc.createElement('style');
    style.id = id;
    style.innerHTML = def;
    parent.appendChild(style);
  }

  function removeStyle(parent, id) {
    if (!parent) {
      return;
    }

    var style = doc.getElementById(id);

    if (!style) {
      return;
    }

    parent.removeChild(style);
  }

  addStyle(getParent(), STYLE_ID, style);
  setTimeout(function() {
    removeStyle(getParent(), STYLE_ID);
  }, timeout);
}(window, document, "body {opacity: 0 !important}", 3000));

De forma predeterminada, el fragmento preoculta el BODY de HTML entero. En algunos casos solo se pueden preocultar determinados elementos HTML y no la página completa. Se puede conseguir personalizando el parámetro de estilo. Sustitúyala por algo que preoculte únicamente partes concretas de la página.

Imagine que tiene dos regiones identificadas por los contenedores de ID container-1 y container-2; el estilo se puede reemplazar de este modo:

#container-1, #container-2 {opacity: 0 !important}

En vez del valor predeterminado:

body {opacity: 0 !important}

De forma predeterminada, el tiempo de espera del fragmento es de 3000 ms o 3 segundos. Este valor se puede personalizar.

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