Show Menu
ARGOMENTI×

Riferimento agli oggetti di Launch

In molti campi del modulo nell'interfaccia utente di Launch, puoi utilizzare la sintassi %% per fare riferimento alle variabili, riducendo la necessità di chiamare _satellite.getVar() . Ad esempio, se utilizzi %product% accederai al valore dell'elemento di dati o della variabile personalizzata del prodotto.

Riferimento agli oggetti di Launch

Questo riferimento documenta l'oggetto _satellite e le operazioni possibili con esso.

track

Codice

_satellite.track(identifier: string [, detail: *] )

Esempio

_satellite.track('contact_submit', { name: 'John Doe' });

Attiva tutte le regole utilizzando il tipo di evento Direct Call dell'estensione Core configurato con l'identificativo specificato. L'esempio precedente attiva tutte le regole utilizzando un tipo di evento Call Direct in cui l'identificativo configurato è contact_submit . Inoltre, viene trasmesso un oggetto facoltativo contenente le relative informazioni. L'oggetto dettaglio è accessibile immettendo %event.detail% all'interno di un campo di testo in una condizione o in un'azione oppure event.detail all'interno dell'editor di codice in una condizione o in un'azione di codice personalizzato.

getVar

Codice

_satellite.getVar(name: string) => *

Esempio

var product = _satellite.getVar('product');

Se esiste un elemento di dati con un nome corrispondente, verrà restituito il valore dell'elemento di dati. Se non esiste alcun elemento di dati corrispondente, eseguirà una verifica per vedere se in precedenza è stata impostata una variabile personalizzata con un nome corrispondente utilizzando _satellite.setVar() . Se si trova una variabile personalizzata corrispondente, verrà restituito il relativo valore.
Nota che, in molti campi del modulo nell'interfaccia utente di Launch, puoi utilizzare la sintassi %% per fare riferimento alle variabili, riducendo la necessità di chiamare _satellite.getVar() . Ad esempio, se utilizzi %product% accederai al valore dell'elemento di dati o della variabile personalizzata del prodotto.

setVar

Codice

_satellite.setVar(name: string, value: *)

Esempio

_satellite.setVar('product', 'Circuit Pro');

Imposta una variabile personalizzata con un nome e un valore specifici. In seguito è possibile accedere al valore della variabile utilizzando _satellite.getVar() .
Se lo desideri, puoi impostare più variabili contemporaneamente trasmettendo un oggetto in cui le chiavi sono nomi di variabili e i valori sono i rispettivi valori delle variabili.
_satellite.setVar({ 'product': 'Circuit Pro', 'category': 'hobby' });

getVisitorId

Codice

_satellite.getVisitorId() => Object

Esempio

var visitorIdInstance = _satellite.getVisitorId();

Se l'estensione Adobe Experience Cloud ID è installata nella proprietà, questo metodo restituisce l'istanza ID visitatore. Per ulteriori informazioni, consulta la documentazione del servizio Experience Cloud ID .

logger

Codice

_satellite.logger.log(message: string)

_satellite.logger.info(message: string)

_satellite.logger.warn(message: string)

_satellite.logger.error(message: string)

Esempio

_satellite.logger.error('No product ID found.');

Registra un messaggio nella console del browser. Il messaggio viene visualizzato solo se l'utente ha abilitato il debug di Launch chiamando _satellite.setDebug(true) o utilizzando un'estensione del browser adeguata.

buildInfo

Codice

_satellite.buildInfo

Questo oggetto contiene informazioni sulla build della libreria di runtime corrente di Launch. L'oggetto contiene le proprietà seguenti:

turbineVersion

La versione di Turbine utilizzata all'interno della libreria corrente.

turbineBuildDate

La data di creazione della versione di Turbine utilizzata all'interno del contenitore in formato ISO 8601.

buildDate

La data di creazione della libreria corrente in formato ISO 8601.

environment

L'ambiente per il quale è stata generata la libreria. I valori possibili sono:
  • development
  • staging
  • production
Questo esempio illustra i valori dell'oggetto:
{
  turbineVersion: "14.0.0",
  turbineBuildDate: "2016-07-01T18:10:34Z",
  buildDate: "2016-03-30T16:27:10Z",
  environment: "development"
}

notify

Questo metodo è stato dichiarato obsoleto. Utilizza invece _satellite.logger.log() .

Codice

_satellite.notify(message: string[, level: number])

Esempio

_satellite.notify('Hello world!');

Registra un messaggio nella console del browser. Il messaggio viene visualizzato solo se l'utente ha abilitato il debug di Launch chiamando _satellite.setDebug(true) o utilizzando un'estensione del browser adeguata.
È possibile trasmettere un livello di registrazione facoltativo che influirà sullo stile e i filtri del messaggio registrato. I livelli supportati sono i seguenti:
3: messaggi informativi.
4: messaggi di avviso.
5: messaggi di errore.
Se non definisci un livello di registrazione o non trasmetti altri valori di livello, il messaggio sarà registrato come messaggio regolare.

setCookie

Questo metodo è stato dichiarato obsoleto. Utilizza invece _satellite.cookie.set() .

Codice

_satellite.setCookie(name: string, value: string, days: number)

Esempio

_satellite.setCookie('product', 'Circuit Pro', 3);

Imposta un cookie nel browser dell'utente. Il cookie persiste per il numero di giorni specificati.

readCookie

Questo metodo è stato dichiarato obsoleto. Utilizza invece _satellite.cookie.get() .

Codice

_satellite.readCookie(name: string) => string

Esempio

var product = _satellite.readCookie('product');

Legge un cookie dal browser dell'utente.

removeCookie

Questo metodo è stato dichiarato obsoleto. Utilizza invece _satellite.cookie.remove() .

Codice

_satellite.removeCookie(name: string)

Esempio

_satellite.removeCookie('product');

Rimuove un cookie dal browser dell'utente.

Funzioni di debug

Non è possibile accedere alle seguenti funzioni dal codice di produzione. Queste sono intese solo a scopo di debug e cambiano nel tempo in base alle esigenze.

container

Codice

_satellite._container

Esempio

Questa funzione non è accessibile dal codice di produzione. La funzione è intesa solo a scopo di debug e cambia nel tempo in base alle esigenze.

monitor

Codice

_satellite._monitors

Esempio

Questa funzione non è accessibile dal codice di produzione. La funzione è intesa solo a scopo di debug e cambia nel tempo in base alle esigenze.

Esempio

Nella pagina Web in cui è in esecuzione una libreria di Launch, aggiungi uno snippet di codice al codice HTML. In genere, il codice si inserisce nel tag <head> prima del tag <script> che carica la libreria Launch. Questo consente al monitoraggio di rilevare i primi eventi di sistema che si verificano nella libreria di Launch. Ad esempio:
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>Title</title>
  <script>
    window._satellite = window._satellite || {};
    window._satellite._monitors = window._satellite._monitors || [];
    window._satellite._monitors.push({
      ruleTriggered: function (event) {
        console.log(
          'rule triggered',
          event.rule
        );
      },
      ruleCompleted: function (event) {
        console.log(
          'rule completed',
          event.rule
        );
      },
      ruleConditionFailed: function (event) {
        console.log(
          'rule condition failed',
          event.rule,
          event.condition
        );
      }
    });
  </script>
  <script src="//assets.adobedtm.com/launch-EN5bfa516febde4b22b3e7c6f96f6b439f.min.js"
          async></script>
</head>
<body>
  <h1>Click me!</h1>
</body>
</html>

Nel primo tag di script, poiché la libreria di Launch non è ancora stata caricata, viene creato l'oggetto _satellite iniziale e si avvia un array su _satellite._monitors . Lo script aggiunge quindi un oggetto di monitoraggio a tale array. L'oggetto di monitoraggio può specificare i metodi seguenti, i quali verranno successivamente chiamati dalla libreria di Launch:

ruleTriggered

Chiamato dopo che un evento attiva una regola, ma prima dell'elaborazione delle condizioni e azioni della regola. L'oggetto evento trasmesso a ruleTriggered contiene informazioni sulla regola attivata.

ruleCompleted

Chiamato dopo il completamento dell'elaborazione di una regola. In altre parole, l'evento si è verificato, tutte le condizioni sono state trasmesse e tutte le azioni sono state eseguite. L'oggetto evento trasmesso a ruleCompleted contiene informazioni sulla regola completata.

ruleConditionFailed

Chiamato dopo l'attivazione di una regola con una condizione che ha avuto esito negativo. L'oggetto evento trasmesso a ruleConditionFailed contiene informazioni sulla regola attivata e sula condizione che ha avuto esito negativo.
Se si chiama ruleTriggered , poco dopo sarà chiamato ruleCompleted oppure ruleConditionFailed .
Un monitoraggio non deve specificare tutti e tre i metodi ( ruleTriggered , ruleCompleted e ruleConditionFailed ). Launch funziona con tutti i metodi supportati forniti dal monitoraggio.

Verifica del monitoraggio

L'esempio precedente specifica tutti e tre i metodi nel monitoraggio. Quando questi vengono chiamati, il monitoraggio disporrà di informazioni pertinenti. Per eseguire il test, imposta due regole nella libreria di Launch:
  1. Una regola con un evento di clic e una condizione di browser che trasmette solo se il browser è Chrome.
  2. Una regola con un evento di clic e una condizione di browser che trasmette solo se il browser è Firefox.
Se apri la pagina in Chrome, apri la console del browser e fai clic sulla pagina, la console visualizza quanto segue:
Puoi aggiungere agli handler hook o informazioni supplementari, se necessario.