Tipi di elementi dati per le estensioni Edge

Nota: Adobe Experience Platform Launch viene riclassificato come una suite di tecnologie di raccolta dati nell’Experience Platform. Queste modifiche verranno implementate in tutta la documentazione del prodotto nelle prossime settimane. Fare riferimento al seguente documento per un riferimento consolidato delle modifiche terminologiche.

Un modulo libreria per tipo di elemento dati ha un obiettivo: recuperare dei dati. Sta a te decidere come devono essere recuperati i dati. Ad esempio, puoi utilizzare un tipo di elemento dati per consentire agli utenti di Adobe Experience Platform Launch di recuperare dei dati dall’archiviazione locale, da un cookie o da un elemento DOM.

IMPORTANTE

Questo documento descrive i tipi di elementi dati per le estensioni web. Se stai sviluppando un’estensione Edge, consulta invece la guida sui tipi di elementi dati per le estensioni Edge.

In questo documento si presuppone che tu abbia familiarità con i moduli libreria e con le modalità in cui vengono integrati nelle estensioni di Platform Launch. Per un'introduzione, vedere la panoramica sulla formattazione del modulo libreria prima di tornare a questa guida.

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 Platform Launch, 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.

In questa pagina