Tipos de elementos de datos para extensiones de Edge

Los módulos de biblioteca de tipos de elementos de datos tienen un objetivo: recuperar fragmentos de datos. Usted decide cómo se recuperan estos datos. Por ejemplo, puede utilizar un tipo de elemento de datos para permitir a los usuarios de Adobe Experience Platform Launch recuperar un fragmento de datos del almacenamiento local, de una cookie o un elemento DOM.

IMPORTANTE

Este documento describe los tipos de elementos de datos para extensiones web. Si va a desarrollar una extensión de Edge, consulte la guía sobre tipos de elementos de datos para 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 de Platform Launch. 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.

Considere una situación en la que desee permitir que los usuarios recuperen un fragmento de datos de un elemento de almacenamiento local denominado productName. Es posible que el módulo tenga este aspecto:

module.exports = function(settings) {
  return localStorage.getItem('productName');
}

Si desea que el usuario de Platform Launch pueda configurar el nombre del elemento de almacenamiento local, puede permitir que el usuario introduzca un nombre y su posterior almacenamiento en el objeto settings. El objeto podría tener este aspecto:

{
  itemName: "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 = function(settings) {
  return localStorage.getItem(settings.itemName);
}

Compatibilidad con valores predeterminados

Tenga en cuenta que los usuarios tienen la opción de configurar un valor predeterminado para cualquier elemento de datos. Si el módulo de la biblioteca de elementos de datos devuelve el valor undefined o null, este se reemplazará automáticamente por el valor predeterminado que el usuario haya configurado para el elemento de datos.

Datos de evento contextual

Si el elemento de datos se recupera como resultado de la activación de una regla (por ejemplo, los elementos de datos se utilizan en las condiciones y acciones de la regla), se pasará un segundo argumento al módulo que contiene información contextual sobre el evento que activó 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.

En esta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free