Tipos de condición para extensiones de Edge

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 una regla de etiqueta, una condición se evalúa después de que se haya producido un evento. Todas las condiciones deben devolver el valor verdadero para que la regla pueda continuar el procesamiento. Las extensiones proporcionan los tipos de condición y evalúan si algo es verdadero o falso, devolviendo un valor booleano.

Por ejemplo, una extensión podría proporcionar un tipo de condición "la ventanilla contiene" en la que el usuario de podría especificar un selector CSS. Cuando la condición se evalúa en el sitio web del cliente, la extensión puede encontrar elementos que coincidan con el selector de CSS y devolver si alguno de ellos se incluye en la ventanilla del usuario.

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

IMPORTANT
Si está desarrollando una extensión web, consulte la guía sobre tipos de condición para extensiones web 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 de Edge. 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 condición suelen consistir en lo siguiente:

  1. Vista que se muestra dentro de la interfaz de usuario del Experience Platform y de la recopilación de datos, y que permite a los usuarios modificar la configuración de la condición.
  2. Módulo de biblioteca que se emite dentro de la biblioteca de tiempo de ejecución de la etiqueta para interpretar la configuración y evaluar una condición.

Por ejemplo, si desea evaluar si el usuario está en el host example.com, el módulo puede tener un aspecto similar al siguiente.

module.exports = (context) => {
  const URL = context.arc.event.xdm.web.webpageDetails.URL;
  return URL.endsWith("adobelaunch.com");
};

Si desea que el nombre de host se pueda configurar por el usuario para permitir la entrada de un nombre de host y guardarlo en el objeto de configuración, el objeto podría tener un aspecto similar al de este ejemplo.

{
  "hostname": "example.com"
}

Para poder modificar el nombre de host definido por el usuario, el módulo deberá cambiar a lo siguiente:

module.exports = (context) => {
  const URL = context.arc.event.xdm.web.webpageDetails.URL;
  return URL.endsWith(settings.hostname);
};

Resultado de la condición

El resultado devuelto por un módulo de condición puede ser uno de los siguientes:

  1. Un valor booleano (true o false).
  2. Una promesa que devuelve un valor booleano una vez resuelto.

Contexto del módulo Biblioteca

Todos los módulos de condición tienen acceso a una variable context que se proporciona cuando se invoca el módulo. Puede obtener más información aquí.

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