Tipi di azioni per le estensioni web

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.

Nel contesto dei tag di raccolta dati, un'azione è qualcosa che viene eseguita dopo un evento di regola e tutte le condizioni hanno superato la valutazione.

Ad esempio, un’estensione potrebbe fornire un tipo di azione “show support chat” che potrebbe mostrare una finestra di dialogo con la chat di supporto per aiutare gli utenti che riscontrano difficoltà nel concludere un acquisto.

Questo documento illustra come definire i tipi di azioni per un'estensione Web in Adobe Experience Platform.

IMPORTANTE

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

Questo documento presuppone anche che tu abbia familiarità con i moduli di libreria e con la loro integrazione nelle estensioni web. Per un'introduzione, vedere la panoramica sulla formattazione del modulo libreria prima di tornare a questa guida.

I tipi di azione in genere consistono nei seguenti elementi:

  1. Una visualizzazione mostrata nell'interfaccia utente di Raccolta dati che consente agli utenti di modificare le impostazioni per l'azione.
  2. Un modulo libreria emesso all'interno della libreria di runtime di tag per interpretare le impostazioni ed eseguire un'azione.
module.exports = function(settings) {
  alert('Thanks for visiting our site!');
};

Ad esempio, per rendere il messaggio configurabile dall’utente Adobe Experience Platform, puoi consentire all’utente di inserire e salvare un messaggio nell’oggetto settings. L'oggetto ha un aspetto simile a questo:

{
  "message": "Thank you for being one of our VIP members!"
}

Per poter utilizzare il messaggio definito dall’utente, il modulo deve essere modificato come segue:

module.exports = function(settings) {
  alert(settings.message);
}

Dati contestuali sugli eventi

Un secondo argomento deve quindi essere passato al modulo che contiene le informazioni contestuali sull'evento che attiva 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