Utilice esta referencia para obtener información sobre las opciones disponibles al utilizar esta extensión para generar una regla.
La extensión Adobe Target requiere At.js 2.x.
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.
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:
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.
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 donde se envían las solicitudes de Target. Esto debe mantenerse casi siempre con el valor predeterminado.
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).
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.
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:
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 de Target. La acción Load Target debe usarse anteriormente.
Agregue parámetros únicamente a las solicitudes de carga de página. La acción Load Target debe usarse anteriormente.
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:
Para obtener más información, consulte la documentación de ayuda en línea de Target.
Active una vista para las aplicaciones de una sola página.
Para obtener más información sobre cómo activar una vista, consulte triggerView()
la documentación de ayuda.
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.
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:
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.