Documentazione per gli oggetti Satellite

Questo documento funge da riferimento per l’oggetto _satellite lato client e le varie funzioni che è possibile eseguire con esso.

track

Codice

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

Esempio

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

track attiva tutte le regole utilizzando il tipo di evento Direct Call configurato con l’identificatore specificato dall’estensione tag Core. 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');

Nell’esempio fornito, se esiste un elemento dati con un nome corrispondente, verrà restituito il suo valore. 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.

Tieni presente che, in molti campi del modulo nell’interfaccia utente di Data Collection, puoi utilizzare la sintassi %% per fare riferimento alle variabili, riducendo la necessità di chiamate a _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');

setVar() 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.');

L’oggetto logger consente di registrare un messaggio nella console del browser. Il messaggio viene visualizzato solo se l’utente ha abilitato il debug dei tag (chiamando _satellite.setDebug(true) o utilizzando un’estensione del browser adeguata).

Registrazione degli avvisi di funzioni deprecate

_satellite.logger.deprecation(message: string)

Esempio

_satellite.logger.deprecation('This method is no longer supported, please use [new example] instead.');

Registra un avviso nella console del browser. Il messaggio viene visualizzato indipendentemente dal fatto che l’utente abbia abilitato o meno il debug del tag.

cookie

_satellite.cookie contiene funzioni per la lettura e la scrittura di cookie. Questa è una copia esposta della libreria js-cookie di terze parti. Per informazioni sull'utilizzo più avanzato di questa libreria, consulta la documentazione js-cookie.

Imposta un cookie

Per impostare un cookie, utilizza _satellite.cookie.set().

Codice

_satellite.cookie.set(name: string, value: string[, attributes: Object])

Esempio

La seguente chiamata di funzione scrive un cookie che scade in una settimana.

_satellite.cookie.set('product', 'Circuit Pro', { expires: 7 });

Recupera un cookie

Per recuperare un cookie, utilizza _satellite.cookie.get().

Codice

_satellite.cookie.get(name: string) => string

Esempio

La seguente chiamata di funzione legge un cookie impostato in precedenza.

var product = _satellite.cookie.get('product');

Rimuovere un cookie

Per rimuovere un cookie, utilizza _satellite.cookie.remove().

Codice

_satellite.cookie.remove(name: string)

Esempio

La seguente chiamata di funzione rimuove un cookie impostato in precedenza.

_satellite.cookie.remove('product');

buildInfo

Codice

_satellite.buildInfo

Questo oggetto contiene informazioni sulla build dell’attuale libreria di runtime dei tag. L'oggetto contiene le proprietà seguenti:

turbineVersion

Fornisce 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.

Questo esempio illustra i valori dell'oggetto:

{
  turbineVersion: "14.0.0",
  turbineBuildDate: "2016-07-01T18:10:34Z",
  buildDate: "2016-03-30T16:27:10Z"
}

environment

Questo oggetto contiene informazioni sull'ambiente in cui viene distribuita la libreria di runtime di tag corrente.

Codice

_satellite.environment

L'oggetto contiene le proprietà seguenti:

{
  id: "ENbe322acb4fc64dfdb603254ffe98b5d3",
  stage: "development"
}

notify

Codice

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

Esempio

_satellite.notify('Hello world!');

notify registra un messaggio nella console del browser. Il messaggio viene visualizzato solo se l’utente ha abilitato il debug dei tag (chiamando _satellite.setDebug(true) o utilizzando un’estensione del browser adeguata).

È possibile trasmettere un livello di registrazione facoltativo che influisca sullo stile e sul filtraggio 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

Codice

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

Esempio

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

Questa operazione imposta un cookie nel browser dell’utente. Il cookie persiste per il numero di giorni specificati.

readCookie

Codice

_satellite.readCookie(name: string) => string

Esempio

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

Legge un cookie dal browser dell’utente.

removeCookie

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

monitor

Codice

_satellite._monitors

Esempio

Esempio

Nella pagina web in cui è in esecuzione una libreria di tag, aggiungi uno snippet di codice all’HTML. In genere, il codice viene inserito nell’elemento <head> prima dell’elemento <script> che carica la libreria di tag. Questo consente al monitoraggio di rilevare i primi eventi di sistema che si verificano nella libreria di tag. 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 elemento di script, poiché la libreria dei tag non è ancora stata caricata, viene creato l’oggetto _satellite iniziale e viene inizializzato 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, che verranno successivamente chiamati dalla libreria dei tag:

ruleTriggered

Questa funzione viene chiamata 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

Questa funzione viene chiamata dopo che una regola è stata completamente elaborata. 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 attivata.

ruleConditionFailed

Questa funzione viene chiamata dopo l’attivazione di una regola per la quale una condizione 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.

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 tag:

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.