Tipi di elementi dati nelle estensioni edge

NOTA

Adobe Experience Platform Launch è stato classificato come una suite di tecnologie di raccolta dati in Adobe Experience Platform. Di conseguenza, sono state introdotte diverse modifiche terminologiche nella documentazione del prodotto. Consulta questo documento come riferimento consolidato delle modifiche terminologiche.

Nei tag, gli elementi dati sono alias per parti di dati su una pagina web o mobile, indipendentemente da dove si trovano all’interno dell’evento ricevuto dal server. Le regole possono fare riferimento a un elemento dati che funge da astrazione per accedere a tali dati. Quando la posizione dei dati cambia in futuro (ad esempio se si modifica la chiave evento che contiene il valore), è possibile riconfigurare un singolo elemento dati mentre tutte le regole che vi fanno riferimento possono rimanere invariate.

I tipi di elementi dati vengono forniti dalle estensioni e l’autore dell’estensione determina il modo in cui viene recuperato questo elemento dati. Ad esempio, è possibile utilizzare un tipo di elemento dati per consentire agli utenti Adobe Experience Platform di recuperare una parte di dati dal livello XDM o dal relativo livello dati personalizzato.

Questo documento illustra come definire i tipi di elementi dati per un’estensione edge in Adobe Experience Platform.

IMPORTANTE

Se stai sviluppando un'estensione web, consulta invece la guida sui tipi di elementi dati per estensioni web .

Questo documento presuppone anche che tu abbia familiarità con i moduli di libreria e con il modo in cui sono integrati nelle estensioni edge. Per un'introduzione, vedere la panoramica sulla formattazione del modulo libreria prima di tornare a questa guida.

I tipi di elementi dati sono in genere costituiti dai seguenti elementi:

  1. Visualizzazione nell’interfaccia utente di raccolta dati che consente agli utenti di modificare le impostazioni per l’elemento dati.
  2. Un modulo libreria emesso all'interno della libreria di runtime di tag per interpretare le impostazioni e recuperare parti di dati.

Se desideri consentire agli utenti di recuperare una parte di dati dal livello dati personalizzato, il modulo potrebbe avere un aspetto simile a questo esempio.

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

Se si desidera che i dati restituiti per il livello dati siano configurabili dall'utente Adobe Experience Platform, è possibile consentire all'utente di immettere un nome chiave e quindi salvare il nome nell'oggetto settings. L’oggetto potrebbe presentarsi così.

{
  keyName: "campaignId"
}

Per poter utilizzare il nome dell’elemento di archiviazione locale definito dall’utente, è necessario modificare il modulo in:

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

Contesto del modulo Libreria

Tutti i moduli di elementi dati hanno accesso a una variabile context fornita quando viene chiamato il modulo. Per saperne di più fai clic qui.

In questa pagina