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

Si la extensión de Adobe Target aún no está instalada, abra la propiedad, luego seleccione Extensions > Catalog, pase el ratón sobre la Extensión de grupo de destinatarios y seleccione Install.

Para configurar la extensión, abra la ficha Extensiones, pase el ratón sobre la extensión y seleccione 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 Adobe Experience Platform 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 Platform 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. 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.

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. Seleccione el icono Agregar 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. Seleccione el icono Agregar 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 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

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() 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

Platform Launch se puede implementar de forma asíncrona. Si carga la biblioteca de Platform 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 Platform 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 preocultamiento:

• Se debe agregar el fragmento antes de cargar el código incrustado del encabezado de Platform Launch.
• Platform 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.
• 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 en Platform Launch; 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.