Tipos de acción para extensiones web

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.

En el contexto de las etiquetas de recopilación de datos, una acción se realiza después de que se haya producido un evento de regla y de que todas las condiciones hayan superado la evaluación.

Por ejemplo, una extensión podría proporcionar un tipo de acción "mostrar chat de asistencia" que puede mostrar un cuadro de diálogo de chat de asistencia técnica para ayudar a los usuarios con problemas para efectuar sus pagos.

Este documento explica cómo definir tipos de acción para una extensión web en Adobe Experience Platform.

IMPORTANT
Este documento describe los tipos de acción para las extensiones web. Si va a desarrollar una extensión de Edge, consulte la guía sobre tipos de acción para las extensiones de Edge en su lugar.
Este documento supone que ya está familiarizado con los módulos de la biblioteca y con la forma en que se integran con las extensiones web. Si necesita una introducción, consulte la información general sobre el formato del módulo de biblioteca antes de volver a esta guía.

Los tipos de acción suelen consistir en lo siguiente:

  1. A vista se muestra dentro de la interfaz de usuario del Experience Platform y de la recopilación de datos que permite a los usuarios modificar la configuración de la acción.
  2. Módulo de biblioteca que se emite dentro de la biblioteca de tiempo de ejecución de etiquetas para interpretar la configuración y realizar una acción.
module.exports = function(settings) {
  alert('Thanks for visiting our site!');
};

Por ejemplo, para que el mensaje sea configurable por el usuario de Adobe Experience Platform, puede permitir que este introduzca y guarde un mensaje en el objeto de configuración. El objeto tiene un aspecto similar al siguiente:

{
  "message": "Thank you for being one of our VIP members!"
}

Para poder modificar el mensaje definido por el usuario, el módulo deberá cambiar a esto:

module.exports = function(settings) {
  alert(settings.message);
}

Datos de evento contextual

Luego se tendría que pasar un segundo argumento al módulo que contiene la información contextual acerca del evento que activa la regla. Esto puede ser beneficioso en algunos casos y se puede acceder a estos datos de la siguiente manera:

module.exports = function(settings, event) {
  // event contains information regarding the event that fired the rule
};

El objeto event debe contener las propiedades siguientes:

Propiedad
Descripción
$type
Cadena que describe el nombre de la extensión y el nombre del evento, unidos mediante un punto. Por ejemplo, youtube.play.
$rule

Objeto que contiene información sobre la regla que se está ejecutando. El objeto debe contener las siguientes propiedades secundarias:

  • id: ID de la regla que se está ejecutando.
  • name: nombre de la regla que se está ejecutando.

La extensión que proporciona el tipo de evento que activó la regla puede, de manera opcional, añadir cualquier otra información de utilidad a este objeto event.

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