Tipos de elementos de datos en 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 las etiquetas, los elementos de datos son alias de datos de una página web o móvil, independientemente de dónde se encuentren dichos datos dentro del evento que recibe el servidor. Las reglas pueden hacer referencia a un elemento de datos y este puede actuar como una abstracción para acceder a estos fragmentos de datos. Cuando la ubicación de los datos cambie en el futuro (por ejemplo, cambiando la clave del evento que contiene el valor), se puede volver a configurar un único elemento de datos y mantener sin cambios a todas las reglas que hacen referencia a dicho elemento de datos.

Las extensiones proporcionan los tipos de elementos de datos, y el autor de la extensión determina cómo se recupera este fragmento de datos. Por ejemplo, ¿puede utilizar un tipo de elemento de datos para permitir a los usuarios de Adobe Experience Platform recuperar un fragmento de datos de la capa XDM o de su capa de datos personalizada.

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

IMPORTANTE

Si va a desarrollar una extensión web, consulte la guía de tipos de elementos de datos 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 elementos de datos 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 del elemento de datos.
  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 recuperar fragmentos de datos.

Si desea permitir que los usuarios recuperen un fragmento de datos de la capa de datos personalizada, su módulo puede tener el aspecto de este ejemplo.

module.exports = (context) => {
  const productName = context.arc.event.data.productName;
  return productName;
};

Si desea que los usuarios de Adobe Experience Platform puedan configurar los datos devueltos para la capa de datos, puede permitirles introducir un nombre de clave y después que lo guarden en el objeto settings. El objeto podría tener este aspecto.

{
  keyName: "campaignId"
}

Para poder utilizar el nombre del elemento de almacenamiento local definido por el usuario, su módulo deberá cambiar a lo siguiente:

module.exports = (context) => {
  const data = context.arc.event.data;
  return data[keyName];
};

Contexto del módulo Biblioteca

Todos los módulos de elementos de datos 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