Tipi di condizioni per le estensioni web

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 tipi di condizione ha un obiettivo: valutare se qualcosa è vero o falso. Sta a te definire ciò che verrà valutato.

NOTA

Questo documento descrive i tipi di condizioni per le estensioni web. Se stai sviluppando un’estensione Edge, consulta invece la guida sui tipi di condizioni 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.

Ad esempio, per valutare se l’utente si trova sull’host example.com, il modulo potrebbe presentarsi così:

module.exports = function(settings) {
  return document.location.hostname === 'example.com';
};

Considera ora la situazione in cui desideri che l’utente di Adobe Experience Platform Launch possa configurare il nome dell’host. Puoi consentire all’utente di inserire un nome di host e quindi di salvarlo nell’oggetto impostazioni. L’oggetto potrebbe presentarsi così:

{
  "hostname": "example.com"
}

Per utilizzare il nome dell’host definito dall’utente, è necessario modificare il modulo come segue:

module.exports = function(settings) {
  return document.location.hostname === settings.hostname;
};

Dati contestuali sugli eventi

Al modulo viene trasmesso un secondo argomento che contiene 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