Tipos de condición para extensiones de Edge

NOTA

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, se evalúa una condición 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, lo que devuelve 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 condiciones para una extensión edge en Adobe Experience Platform.

IMPORTANTE

Si está desarrollando una extensión web, consulte la guía sobre tipos de condición para extensiones web en su lugar.

Este documento también supone que está familiarizado con los módulos de biblioteca y cómo se integran en las extensiones 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 en la interfaz de usuario 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 emitido en la biblioteca de tiempo de ejecución de etiquetas 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 este aspecto.

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í.

En esta página