Show Menu
TEMAS×

Extensión de Adobe Target 2.0

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

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, haga clic en Extensions > Catalog , coloque el puntero sobre la extensión Target y haga clic en Install .
Para configurar la extensión, abra la pestaña Extensions, pase el cursor sobre la extensión y, a continuación, haga clic en Configure .

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 Launch 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

Dominio donde 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:

Load Target

Añada esta acción a la regla de Launch 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.
No es necesaria ninguna configuración.

Agregar parámetros a todas las solicitudes

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. Haga clic en el icono Add para agregar más parámetros.

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

Agregue parámetros únicamente 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. Haga clic en el icono Add para agregar más parámetros.

Activar solicitud de carga de página

Activa una solicitud de Target 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 CUERPO HTML está oculto.
  • Estilo oculto del cuerpo: El valor predeterminado es body .
Para obtener más información, consulte la documentación de ayuda en línea de Target .

Activar vista

Active una vista 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() .

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

Launch se puede implementar de forma asíncrona. Si carga la biblioteca de Launch asincrónicamente con Target dentro de ella, Target también se cargará asincrónicamente. 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 de ocultación previa y cargar el paquete de Launch asincrónicamente para evitar cualquier parpadeo en el contenido.
A continuación se indican algunos aspectos que se deben tener en cuenta al utilizar el fragmento de preocultación:
  • Se debe agregar el fragmento antes de cargar el código incrustado del encabezado de Launch.
  • Launch no puede administrar este código, por lo que se debe agregar 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 ocultación previo para minimizar su duración.
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.