Tipi di elementi dati per le estensioni web

NOTE
Adobe Experience Platform Launch è stato ridefinito come 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 di raccolta dati, gli elementi dati sono essenzialmente alias per parti di dati su una pagina. Questi dati si trovano in parametri di stringhe di query, cookie, elementi DOM o altre posizioni. Le regole possono fare riferimento a un elemento dati che funge da astrazione per accedere a tali dati.

I tipi di elementi dati vengono forniti dalle estensioni e consentono agli utenti di configurare elementi dati per accedere a parti di dati in un modo particolare. Ad esempio, un’estensione potrebbe fornire un tipo di elemento dati “elemento di archiviazione locale” in cui l’utente di può specificare il nome di un elemento specifico. Quando una regola fa riferimento all’elemento dati, l’estensione sarà in grado di cercare il valore dell’elemento nell’archiazione locale utilizzando il nome fornito dall’utente durante la configurazione dell’elemento dati.

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

IMPORTANT
Se stai sviluppando un’estensione Edge, consulta la guida su tipi di elementi dati per le estensioni edge invece.
In questo documento si presuppone che tu abbia familiarità con i moduli libreria e sul modo in cui vengono integrati nelle estensioni web. 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. A visualizza mostrate nell’interfaccia di Experience Platform e nell’interfaccia di Data Collection, che consentono agli utenti di modificare le impostazioni per l’elemento dati.
  2. Modulo libreria emesso all’interno della libreria runtime di tag per interpretare le impostazioni e recuperare i dati.

Considera una situazione in cui desideri consentire agli utenti di recuperare dei dati da un elemento nell’archiviazione locale denominato productName. Il modulo potrebbe presentarsi così:

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

Se desideri che il nome dell’elemento nell’archiviazione locale possa essere configurato dall’utente di Adobe Experience Platform, puoi consentire agli utenti di immettere un nome e quindi di salvarlo nell’oggetto settings. L’oggetto potrebbe presentarsi così:

{
  itemName: "campaignId"
}

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

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

Supporto di valori predefiniti

Gli utenti possono configurare un valore predefinito per qualsiasi elemento dati. Se il modulo libreria dell’elemento dati restituisce il valore undefined o null, verrà automaticamente sostituito dal valore predefinito configurato dall’utente per l’elemento dati.

Dati contestuali sugli eventi

Se l’elemento dati viene recuperato a seguito dell’attivazione di una regola (ad esempio, se gli elementi dati vengono utilizzati nelle condizioni e nele azioni della regola), al modulo verrà trasmesso un secondo argomento contenente informazioni contestuali relative all’evento che ha attivato la regola. Può risultare utile in alcuni casi e vi si può accedere nel modo seguente:

module.exports = function(settings, event) {
  // event contains information regarding the event that fired the rule
};

L’oggetto event deve contenere le seguenti proprietà:

Proprietà
Descrizione
$type
Stringa che descrive il nome dell’estensione e il nome dell’evento, separati da un punto. Ad esempio, youtube.play.
$rule

Oggetto contenente informazioni sulla regola attualmente in esecuzione. L’oggetto deve contenere le seguenti sotto-proprietà:

  • id: ID della regola attualmente in esecuzione.
  • name: nome della regola attualmente in esecuzione.

L’estensione che fornisce il tipo di evento che ha attivato la regola può facoltativamente aggiungere altre informazioni utili a questo oggetto event.

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