La extensión principal es la extensión predeterminada lanzada con Adobe Experience Platform Launch.
Utilice esta referencia para obtener información sobre las opciones disponibles al utilizar esta extensión para generar una regla.
En este tema se describen los tipos de eventos disponibles en la Extensión principal.
Para obtener más información sobre las opciones que se pueden configurar para distintos tipos de eventos, consulte Opciones.
Se activa la acción cuando una pestaña pierde Focus.
No hay configuraciones para este tipo de evento.
Se activa la acción cuando una pestaña recibe Focus.
No hay configuraciones para este tipo de evento.
Se activa la acción cuando un formulario pierde Focus.
Consulte Opciones, a continuación.
Se activa la acción cuando un formulario recibe Focus.
Consulte Opciones, a continuación.
Se activa la acción cuando se envía un formulario.
Consulte Opciones, a continuación.
El evento se activa si se pulsa una tecla.
Consulte Opciones, a continuación.
El evento se activa cuando el medio termina.
Consulte Opciones, a continuación.
Se activa el evento cuando el medio carga datos.
Consulte Opciones, a continuación.
Se activa el evento cuando se pausa el medio.
Consulte Opciones, a continuación.
Se activa el evento cuando se reproduce el medio.
Consulte Opciones, a continuación.
Se activa el evento si se bloquean los medios.
Consulte Opciones, a continuación.
Se activa el evento si el medio se reproduce durante un periodo de tiempo determinado.
Consulte Opciones, a continuación.
Además, se indica que el evento se activará después de una cantidad de tiempo determinada.
Se activa el evento si el volumen aumenta o se reduce.
Consulte Opciones, a continuación.
Se activa el evento si cambia la orientación del dispositivo.
No hay configuraciones para este tipo de evento.
Además, se indica que el evento se activará después de una cantidad de tiempo determinada.
Se activa el evento si el usuario amplía o reduce la imagen.
No hay configuraciones para este tipo de evento.
Se activa el evento si se selecciona el elemento especificado (al hacer clic).
También se pueden especificar valores de propiedad que deben tener el valor “True” para el elemento antes de activar el evento.
Si el elemento es un vínculo (una etiqueta <a>
), también puede especificar si retrasará la navegación durante un período de tiempo. Esto puede resultar útil si la regla requiere tiempo adicional para ejecutarse y normalmente no se completaría antes de que se realice la navegación de página.
Esta opción debe utilizarse con extrema precaución debido a las posibles consecuencias negativas que puede tener para la experiencia del usuario si se utiliza incorrectamente.
Cuando se utiliza el retraso del vínculo, el Platform Launch evitará que el explorador navegue fuera de la página y, a continuación, realizará una redirección de JavaScript al destino original después del tiempo de espera especificado. Esto es especialmente peligroso cuando el marcado de la página tiene <a>
etiquetas donde la funcionalidad deseada no sale del usuario de la página. Si no puede resolver el problema de ninguna otra manera, debe ser extremadamente preciso con la definición del selector para que este evento déclencheur exactamente donde lo necesita y en ningún otro lugar.
El valor de retraso predeterminado del vínculo es 100 milisegundos. Tenga en cuenta que el Platform Launch siempre esperará la cantidad de tiempo especificada y no estará conectado a la ejecución de las acciones de la regla de ninguna manera. Es posible que la demora obligue al usuario a esperar más tiempo del necesario y también que el retraso no sea lo suficientemente largo como para que todas las acciones de la regla se completen correctamente. Los retrasos más largos proporcionan más tiempo para la ejecución de reglas, pero también contribuyen a que la experiencia del usuario sea peor.
Además, se indica que el evento se activará después de una cantidad de tiempo determinada.
Para ver las opciones avanzadas, consulte Opciones.
Se activa el evento si el usuario pasa el ratón sobre un elemento especificado.
Consulte Opciones, a continuación.
Además, configure si la regla se activa inmediatamente o después de un número determinado de milisegundos.
Se activa el evento si se produce un tipo de Custom Event.
Puede asignar un nombre a una función JavaScript que haya definido en otro sitio y utilizarla para el evento.
Especifique el nombre del tipo de Custom Event y, a continuación, configure las demás opciones como se describe en Opciones.
Se activa el evento si cambia un elemento de datos especificado.
Indique el nombre del elemento de datos. Para seleccionar el elemento de datos de una lista, seleccione el icono y, a continuación, el elemento de datos.
Diseñado para evitar la detección de eventos y los sistemas de búsqueda.
Las reglas de Direct Call son perfectas para situaciones en las que desea decir a Platform Launch exactamente lo que está ocurriendo. Además, son también perfectas para cuando Platform Launch no puede detectar un evento en el DOM, como con Adobe Flash.
Especifique la cadena _satellite.track
.
Se activa el evento si el elemento especificado existe.
Consulte Opciones, a continuación.
Se activa el evento si el usuario entra en una ventanilla especificada.
Consulte Opciones, a continuación.
Además, configure si la regla se activa inmediatamente o después de un número determinado de milisegundos.
Se activa el evento si se produce un pushState o hashchange.
No hay configuraciones para este tipo de evento.
Se activa el evento si el usuario permanece en la página durante una determinada cantidad de segundos.
Especifique la cantidad de segundos que deben transcurrir antes de activar el evento.
Se activa cuando el DOM está listo y el usuario puede interactuar con la página
No hay configuraciones para este tipo de evento.
El evento se activa en cuanto se carga la biblioteca de Platform Launch.
No hay configuraciones para este tipo de evento.
Se activa el evento una vez que se realiza la llamada a _satellite.pageBottom();
. Al cargar la biblioteca de Platform Launch de forma asíncrona, no se debe utilizar este tipo de evento.
No hay configuraciones para este tipo de evento.
Se activa el evento cuando el explorador llama onLoad y la página ha terminado de cargarse.
No hay configuraciones para este tipo de evento.
Cada uno de los tipos de eventos de formulario utiliza la siguiente configuración:
Indique el selector de CSS que identifica los elementos que activan el evento.
Si selecciona esta opción, aparecerán disponibles los siguientes parámetros:
property=value
Especifique el valor de la propiedad
Regex
Habilitar si property=value
es una expresión regular.
Add
Añadir otro par de property=value
.
Esta sección describe los tipos de condición disponibles en la Extensión principal. Estos tipos de condiciones se pueden usar con el tipo de lógica regular o de excepción.
Especifique el nombre y el valor de la cookie que deben darse para activar una acción con un evento.
Especifique cualquier Custom Code que deba darse como condición del evento. Utilice el editor de código integrado para introducir el Custom Code.
Una variable denominada event
estará disponible automáticamente y podrá hacer referencia a ella desde su Custom Code. El objeto event
contendrá información útil sobre el evento que activó la regla. La forma más sencilla de determinar qué datos de eventos están disponibles es registrar event
en la consola desde el Custom Code:
console.log(event);
return true;
Ejecute la regla en un explorador e inspeccione el objeto de evento registrado en la consola del explorador. Una vez que sepa qué información está disponible, puede utilizarla para la toma de decisiones mediante programación dentro del Custom Code.
Secuencia de condiciones
Cuando la opción "Run rule components in sequence" de la configuración de propiedades está activada, puede hacer que los componentes de regla subsiguientes esperen mientras la condición realiza una tarea asincrónica.
Cuando la condición arroja una promesa, la siguiente condición de la regla no se ejecutará hasta que se resuelva la promesa que se muestra. Si se rechaza la promesa, Platform Launch considera que la condición ha fallado y que no se ejecutarán más condiciones o acciones de esa regla.
Un ejemplo de una condición que arroja una promesa:
return new Promise(function(resolve, reject) {
setTimeout(function() {
if (new Date().getDay() === 5) {
resolve();
} else {
reject();
}
}, 1000);
});
Compara dos valores para determinar si esta condición devuelve el valor “True”.
Si tiene una regla con varias condiciones, es posible que esta condición devuelva el valor “True”, pero la regla no se activará porque las demás condiciones se evalúan como “False” o una de las excepciones como “True”.
Están disponibles los siguientes operadores de comparación de valores:
Equal: La condición devuelve el valor “True” si los dos valores son iguales usando una comparación no estricta (en JavaScript, el operador ==). Los valores pueden ser de cualquier tipo. Al escribir una palabra como True, False, Null o Undefined en un campo de valor, la palabra se compara como una cadena y no se convierte a su equivalente de JavaScript.
Does Not Equal: La condición devuelve el valor “True” si los dos valores no se igualan con una comparación no estricta (en JavaScript,operador !=). Los valores pueden ser de cualquier tipo. Al escribir una palabra como True, False, Null o Undefined en un campo de valor, la palabra se compara como una cadena y no se convierte a su equivalente de JavaScript.
Contains: La condición devuelve el valor “True” si el primer valor contiene el segundo valor. Los números se convierten en cadenas. Cualquier valor que no sea un número o una cadena provocará que la condición devuelva el valor “False”.
Does Not Contain: La condición devuelve el valor “True” si el primer valor no contiene el segundo valor. Los números se convierten en cadenas. Cualquier valor que no sea un número o una cadena dará como resultado que la condición devuelva el valor “True”.
Starts With: La condición devuelve el valor “True” si el primer valor empieza por el segundo valor. Los números se convierten en cadenas. Cualquier valor que no sea un número o una cadena provocará que la condición devuelva el valor “False”.
Does Not Start With: La condición devuelve el valor “True” si el primer valor no comienza con el segundo valor. Los números se convierten en cadenas. Cualquier valor distinto al número o cadena provoca que la condición devuelva el valor “True”.
Ends With: La condición devuelve el valor “True” si el primer valor termina con el segundo valor. Los números se convierten en cadenas. Cualquier valor que no sea un número o una cadena provocará que la condición devuelva el valor “False”.
Does Not End With: La condición devuelve el valor “True” si el primer valor no termina con el segundo valor. Los números se convierten en cadenas. Cualquier valor distinto al número o cadena provoca que la condición devuelva el valor “True”.
Matches Regex: La condición devuelve el valor “True” si el primer valor coincide con la expresión regular. Los números se convierten en cadenas. Cualquier valor que no sea un número o una cadena provocará que la condición devuelva el valor “False”.
Does Not Match Regex: La condición devuelve el valor “True” si el primer valor no coincide con la expresión regular. Los números se convierten en cadenas. Cualquier valor distinto al número o cadena provoca que la condición devuelva el valor “True”.
Is Less Than: La condición devuelve el valor “True” si el primer valor es menor que el segundo valor. Las cadenas que representan números se convierten en números. Cualquier valor que no sea un número o una cadena convertible provocará que la condición devuelva el valor “False”.
Is Less Than Or Equal To: La condición devuelve el valor “True” si el primer valor es menor o igual que el segundo valor. Las cadenas que representan números se convierten en números. Cualquier valor que no sea un número o una cadena convertible provocará que la condición devuelva el valor “False”.
Is Greater Than: La condición devuelve el valor “True” si el primer valor es mayor que el segundo valor. Las cadenas que representan números se convierten en números. Cualquier valor que no sea un número o una cadena convertible provocará que la condición devuelva el valor “False”.
Is Greater Than Or Equal To: La condición devuelve el valor “True” si el primer valor es mayor o igual que el segundo valor. Las cadenas que representan números se convierten en números. Cualquier valor que no sea un número o una cadena convertible provocará que la condición devuelva el valor “False”.
Is True: La condición devuelve el valor “True” si se trata de una condición booleana con el valor “True”. El valor que proporcione no se convierte en booleano si es de cualquier otro tipo. Cualquier valor que no sea booleano con el valor “True” provoca que se devuelva el valor “False”.
Is Truthy: La condición devuelve el valor “True” si el valor es “True” después de convertirse en un valor booleano. Consulte la documentación sobre Truthy de MDN para ver ejemplos de valores “Truthy”.
Is False: La condición devuelve el valor “True” si se trata de una condición booleana con el valor “False”. El valor que proporcione no se convierte en booleano si es de cualquier otro tipo. Cualquier valor que no sea booleano con el valor “False” provoca que se devuelva el valor “False”.
Is Falsy: La condición devuelve el valor “True” si el valor es “False” después de convertirse en un valor booleano. Consulte la documentación sobre Falsy de MDN para ver ejemplos de valores “falsy”.
Especifique el nombre y el valor de la variable JavaScript que debe darse para activar una acción con un evento.
Especifique la página en la que el usuario debe aterrizar para activar el evento.
Especifique si el visitante debe ser un visitante nuevo o recurrente para que un evento active una acción.
Seleccione una de las siguientes opciones:
Configure la cantidad de veces que el visitante debe ver la página antes de activar la acción.
Se activa la acción si la cantidad de sesiones del usuario cumple los criterios especificados.
Se activa la acción si la cantidad de sesiones del usuario cumple los criterios especificados.
Configure cuánto tiempo debe estar el visitante en el sitio antes de activar la acción.
Se activa la acción si la cantidad de sesiones del usuario cumple los criterios especificados.
Especifique la fuente del tráfico del visitante que debe tener el valor “true” para que se active la acción.
Seleccione el explorador que el visitante debe utilizar para activar la acción.
Seleccione uno o varios de los siguientes exploradores:
Seleccione el tipo de dispositivo que debe utilizar el visitante para que se active la acción.
Seleccione uno o varios de los siguientes tipos de dispositivos:
Seleccione el sistema operativo que el visitante debe utilizar para activar la acción.
Seleccione uno o varios de los siguientes sistemas operativos:
Seleccione la resolución de pantalla que deben utilizar los visitantes en sus dispositivos para activar la acción.
Seleccione el tamaño de la ventana que deben utilizar los visitantes en sus dispositivos para que se active la acción.
Especifique el dominio del visitante.
Especifique uno o varios patrones hash que deben darse en la dirección URL.
Una condición OR permite unir varios patrones hash.
Especifique una o más rutas que deben darse en la dirección URL. Esto incluye Path And Query String.
Las rutas múltiples se unen mediante una condición OR.
Especifique una o más rutas que deben darse en la dirección URL. Esto incluye la ruta, pero no la cadena de consulta.
Las rutas múltiples se unen mediante una condición OR.
Especifique el protocolo utilizado en la dirección URL.
Seleccione una de las siguientes opciones:
Especifique el URL Parameter utilizado en la URL.
Especifique uno o varios subdominios que deben darse en la dirección URL.
Los subdominios múltiples se unen mediante una condición OR.
Especifique un intervalo de fechas. Seleccione la fecha y la hora tras la que se produce el evento, la fecha antes de la que se produce y la zona horaria.
Especifique el número máximo de veces que la condición devuelve el valor “True”. Puede seleccionar las siguientes opciones:
Para la frecuencia máxima 1 de condición por sesión, se comparan estos dos elementos localStorage
. Si visitorTracking.sessionCount
es mayor que el recuento de maxFrequency.session
, la condición de muestreo es verdadera. Si son iguales, la condición es falsa.
sessionCount
es un elemento visitorTracking
, por lo que la API de visitante debe estar activada para que la condición de muestreo funcione.
Especifique el porcentaje del tiempo que la condición devuelve true.
En esta sección se describen los tipos de acción disponibles en la Extensión principal.
Proporcione el código que se ejecuta después de activar el evento y de evaluar las condiciones.
Cuando se selecciona JavaScript como idioma, estará disponible automáticamente una variable denominada event
y podrá hacer referencia a ella desde su Custom Code. El objeto event
contendrá información útil sobre el evento que activó la regla. La forma más sencilla de determinar qué datos de eventos están disponibles es registrar event
en la consola desde el Custom Code:
console.log(event);
Ejecute la regla en un explorador e inspeccione el objeto de evento registrado en la consola del explorador. Después de saber qué información está disponible, puede utilizarla para la toma de decisiones mediante programación dentro del Custom Code, el envío de una parte del objeto event
a un servidor, etc.
La Extensión principal, disponible para todos los usuarios de Platform Launch, contiene una acción de Custom Code para ejecutar JavaScript o HTML proporcionados por el usuario. A menudo, es útil que los usuarios comprendan cómo se procesan las reglas con acciones de Custom Code.
El Código de las acciones personalizadas está incrustado en la biblioteca principal de Platform Launch. El código se escribe en el documento usando document.write. Si una regla tiene varias acciones Custom Code, el código se escribe en el orden configurado en la regla.
El código de las acciones personalizadas se carga desde el servidor y se escribe en el documento mediante Postscribe. Si una regla tiene varias acciones Custom Code, el código se carga en paralelo desde el servidor, pero se escribe en el orden configurado en la regla.
Cuando se utiliza document.write después de que una página se haya cargado normalmente, no supone un problema para el código proporcionado mediante acciones de Custom Code. Puede utilizar document.write dentro de las acciones de Custom Code independientemente de cuándo se ejecuta el código.
El validador utilizado en el editor de código de Platform Launch se ha diseñado para identificar los problemas con el código escrito por el desarrollador. El código que ha pasado por un proceso de reducción (como el código AppMeasurement.js descargado del Administrador de códigos) puede recibir falsas advertencias sobre problemas por el validador que generalmente se pueden ignorar.
Cuando la opción "Run rule components in sequence" de la configuración de propiedades está activada, puede hacer que los componentes de regla subsiguientes esperen mientras la acción realiza una tarea asincrónica. Esto funciona de forma diferente para un Custom Code JavaScript y HTML.
JavaScript
Al crear una acción de Custom Code de JavaScript, puede devolver una promesa de su acción. La acción siguiente de la regla se ejecutará únicamente cuando se resuelva la promesa proporcionada. Si se rechaza la promesa, no se ejecutarán las siguientes acciones de la regla.
Nota: Esto solo funciona cuando JavaScript no está configurado para ejecutarse globalmente. Si está ejecutando la acción de Custom Code en el ámbito global, Platform Launch tratará la promesa como resuelta inmediatamente y pasará al siguiente elemento de la cola de procesamiento.
Ejemplo de una acción de Custom Code de JavaScript que arroja una promesa:
return new Promise(function(resolve, reject) {
setTimeout(function() {
if (new Date().getDay() === 5) {
resolve();
} else {
reject();
}
}, 1000);
});
HTML
Al crear una acción de Custom Code HTML, una función denominada onCustomCodeSuccess()
estará disponible para usar en el Custom Code. Puede llamar esta función para indicar que el Custom Code se ha completado y que Platform Launch puede pasar a ejecutar acciones posteriores. Por otro lado, si el Custom Code falla de alguna manera, puede llamar a onCustomCodeFailure()
. Esto informará a Platform Launch que no ejecute las acciones posteriores a esa regla.
Ejemplo de una acción de Custom Code HTML que utiliza las llamadas de retorno nuevas:
<script>
setTimeout(function() {
if (new Date().getDay() === 5) {
onCustomCodeSuccess();
} else {
onCustomCodeFailure();
}
}, 1000);
</script>
Los tipos de Data Elements están determinados por la extensión. No hay límite para los tipos que se pueden crear.
Las secciones siguientes describen los tipos de Data Elements disponibles en la Extensión principal. Otras extensiones utilizan tipos de Data Elements diferentes.
Es posible hacer referencia a cualquier cookie de dominio disponible en el campo de nombre de cookie.
cookieName
Cualquier valor de cadena constante al que se pueda hacer referencia en acciones o condiciones.
string
Puede introducir código JavaScript personalizado en la IU si selecciona la opción Abrir editor e inserta código en la ventana del editor.
Se debe incluir una sentencia de retorno en la ventana del editor para indicar qué valor se tiene que usar como valor del elemento de datos. Si no se incluye una sentencia de retorno o se arroja el valor null
o undefined
, el valor predeterminado del elemento de datos se utilizará como valor del elemento de datos.
Ejemplo:
var pageType = $('div.page-wrapper').attr('class').split('')[1];
if (window.location.pathname == '/') {
return 'homepage';
} else {
return pageType;
}
Si se recupera el elemento de datos de Custom Code como parte de una ejecución de regla, estará disponible automáticamente una variable denominada event
a la que podrá hacer referencia desde el Custom Code. El objeto event
contendrá información útil sobre el evento que activó la regla. La forma más sencilla de determinar qué datos de eventos están disponibles es registrar event
en la consola desde el Custom Code:
console.log(event);
return true;
Ejecute la regla en un explorador e inspeccione el objeto de evento registrado en la consola del explorador. Una vez que sepa qué información está disponible bajo las distintas reglas que pueden utilizar el elemento de datos, puede utilizarla para la toma de decisiones mediante programación dentro del Custom Code o devolver una parte del objeto event
como valor del elemento de datos.
Es posible recuperar cualquier elemento, como una etiqueta H1 o div.
Cadena de selector de CSS:
id#dc logo img
Obtener el valor de:
src
Es posible hacer referencia a cualquier objeto JavaScript o variable mediante el campo de ruta.
Si tiene variables JavaScript o propiedades de objeto en el marcado y desea recopilar esos valores en Platform Launch para utilizarlos con cualquiera de las extensiones o reglas, una manera de capturar esos valores es utilizar Data Elements en Platform Launch. De esta forma, puede hacer referencia al elemento de datos mediante las Reglas y, en caso de que la fuente de datos cambie en algún momento, solo deberá cambiar la referencia a la fuente (el elemento de datos) en la administración dinámica de etiquetas de Platform Launch.
Por ejemplo, supongamos que el marcado contiene una variable de JavaScript llamada “Page_Name
” similar a la que se muestra a continuación:
<script>
//data layer
var Page_Name = "Homepage"
</script>
Cuando cree el elemento de datos en Launch, simplemente proporcione la ruta a esa variable.
Si utiliza un objeto de recopilación de datos como parte de la capa de datos, solo tiene que utilizar la notación de puntos en la ruta para hacer referencia al objeto y la propiedad que desea capturar en el elemento de datos como, por ejemplo, _myData.pageName
o digitalData.pageName
, etc.
window.document.title
Proporcione el nombre del elemento de almacenamiento local en el campo Local Storage Item Name.
El almacenamiento local proporciona a los exploradores una forma de almacenar información de página a página (https://www.w3schools.com/html/html5_webstorage.asp). El almacenamiento local funciona de forma muy similar a las cookies, pero es mucho más amplio y flexible.
Utilice el campo proporcionado para especificar el valor que ha creado para un elemento de almacenamiento local, como lastProductViewed.
Utilice estos puntos de datos para capturar información de página para usarla en la lógica de regla o para enviar información a Analytics o a sistemas de seguimiento externos.
Puede seleccionar uno de los siguientes atributos de página para usarlos en el elemento de datos:
Especifique un único parámetro de URL en el campo URL Parameter.
Solo es necesaria la sección de nombres y cualquier indicador especial como "?" o "=" debe omitirse
contentType
Utilice este elemento de datos para generar un número aleatorio. A menudo se utiliza para datos de muestra o para crear ID, como un ID de visita individual. El número aleatorio puede utilizarse para proteger o desproteger datos confidenciales. Algunos ejemplos pueden incluir:
Especifique los valores mínimos y máximos del número aleatorio.
Valores predeterminados:
Mínimo: 0
Máximo: 1000000000
Proporcione el nombre del elemento de almacenamiento de la sesión en el campo Session Storage Item Name.
El almacenamiento de sesión es similar al almacenamiento local, excepto que los datos se descartan después de que finalice la sesión, mientras que el almacenamiento local o una cookie pueden retener los datos.
De manera similar a Información de página (Page Info), este elemento de datos utiliza tipos de comportamiento comunes para enriquecer la lógica dentro de las reglas o la recopilación de datos.
Seleccione uno de los siguientes atributos de comportamiento del visitante:
Algunos casos de uso común son: