tl

Il metodo tl() è un componente di base importante per Adobe Analytics. Prende tutte le variabili Analytics definite nella pagina, le compila in una richiesta di immagine e invia tali dati ai server di raccolta dati di Adobe. Funziona in modo simile al metodo t() , tuttavia questo metodo non incrementa le visualizzazioni di pagina. È utile per tenere traccia dei collegamenti e di altri elementi che non verrebbero considerati come un caricamento completo della pagina.

Se sono abilitati trackDownloadLinks o trackExternalLinks , AppMeasurement chiama automaticamente il metodo tl() per inviare il collegamento di download e uscire dai dati di tracciamento dei collegamenti. Se la tua organizzazione preferisce avere più controllo sui collegamenti da tracciare e sul loro comportamento, puoi chiamare manualmente il metodo tl() . I collegamenti personalizzati possono essere tracciati solo manualmente.

Chiamata di tracciamento dei collegamenti tramite tag in Adobe Experience Platform

L’interfaccia utente di raccolta dati dispone di una posizione dedicata impostata per una chiamata di tracciamento dei collegamenti.

  1. Accedi all' Interfaccia di raccolta dati utilizzando le tue credenziali AdobeID.
  2. Fai clic sulla proprietà desiderata.
  3. Vai alla scheda Rules , quindi fai clic sulla regola desiderata (o crea una regola).
  4. In Actions, fai clic sull'icona "+"
  5. Imposta il menu a discesa Extension su Adobe Analytics e Action Type su Invia beacon.
  6. Fare clic sul pulsante di scelta s.tl().

Non è possibile impostare argomenti facoltativi nell’interfaccia utente Raccolta dati.

s.tl() in AppMeasurement e nell'editor di codice personalizzato

Chiama il metodo s.tl() quando desideri inviare una chiamata di tracciamento ad Adobe.

s.tl([Link object],[Link type],[Link name],[Override variable]);

L’argomento dell’oggetto collegamento determina se il browser attende fino a 500 ms prima di spostarsi dalla pagina. Se una richiesta di immagine viene inviata prima di 500 ms, la pagina passa immediatamente al collegamento selezionato.

NOTA

AppMeasurement abilita automaticamente la variabile useBeacon per i collegamenti di uscita, rendendo questo argomento non più necessario nei browser moderni. Questo argomento è stato utilizzato più comunemente nelle versioni precedenti di AppMeasurement.

  • this: Attendi fino a 500 ms per dare tempo ad AppMeasurement per inviare una richiesta di immagine. Valore predefinito.
  • true: Non aspettare.
// Include a 500ms delay with an exit link
s.tl(this,"e","Example exit link");

// Do not include a 500ms delay with an exit link
s.tl(true,"e","Example exit link");

Tipo di collegamento (obbligatorio)

L’argomento tipo di collegamento è una stringa a carattere singolo che determina il tipo di chiamata di tracciamento del collegamento. Tre valori validi.

  • o: Il collegamento è un collegamento personalizzato.
  • d: Il collegamento è un collegamento Scarica.
  • e: Il collegamento è un collegamento Esci.
// Send a custom link
s.tl(true,"o","Example custom link");

// Send a download link
s.tl(true,"d","Example download link");

// Send an exit link
s.tl(true,"e","Example exit link");

Nome collegamento (consigliato)

L’argomento nome collegamento è una stringa che determina l’elemento della dimensione di tracciamento del collegamento. Quando utilizzi le dimensioni Collegamento personalizzato, Collegamento di download o Collegamento di uscita nel rapporto, questa stringa contiene l’elemento dimensione. Se questo argomento non è impostato, viene utilizzata la variabile linkURL .

// When using the Download link dimension, this method call increases the occurrences metric for "Sea turtle PDF report" by 1.
s.tl(true,"d","Sea turtle PDF report");

Ignorare le variabili (facoltativo)

Consente di modificare i valori delle variabili per una singola chiamata. Per ulteriori informazioni, consulta sostituzioni delle variabili .

var y = new Object();
y.eVar1 = "Override value";
y.linkTrackVars = "eVar1";
s.tl(true,"o","Example custom link",y);

Esempi e casi di utilizzo

Invia una chiamata di tracciamento dei collegamenti di base direttamente all’interno di un collegamento HTML:

<a href="example.html" onClick="s.tl(true,'o','Example link');">Click here</a>

Utilizza JavaScript per effettuare una chiamata di tracciamento dei collegamenti di base utilizzando gli argomenti dei metodi:

s.tl(true,"o","Example link");

Effettuare chiamate di tracciamento dei collegamenti all’interno di una funzione personalizzata

Puoi consolidare il codice di tracciamento dei collegamenti in una funzione JavaScript indipendente definita sulla pagina o in un file JavaScript collegato. È quindi possibile effettuare chiamate nella funzione onClick di ogni collegamento. Imposta quanto segue in un file JavaScript:

function trackClickInteraction(name){
  s.linkTrackVars = "eVar1,eVar2";
  s.eVar1 = name;
  s.eVar2 = s.pageName;
  s.tl(true,"o",name);
}

Puoi quindi chiamare la funzione ogni volta che desideri tenere traccia di un determinato collegamento:

<!-- Use wherever you want to track links -->
<a href="example.html" onClick="trackClickInteraction('Example link');">Click here</a>

Evita di tracciare i collegamenti duplicati

Se sono abilitati trackDownloadLinks o trackExternalLinks , AppMeasurement effettua automaticamente una chiamata di tracciamento dei collegamenti se i filtri corretti corrispondono. Se effettui anche una chiamata manuale s.tl() per questi clic sul collegamento, puoi inviare dati duplicati ad Adobe. I dati duplicati gonfiano i numeri dei rapporti e li rendono meno precisi.

Ad esempio, la funzione seguente invierebbe due chiamate di tracciamento dei collegamenti per lo stesso clic (collegamenti per il download manuale e automatico):

function trackDownload(obj) {
  s.tl(obj,"d","Example PDF download");
}

Puoi evitare chiamate di tracciamento dei collegamenti duplicate utilizzando la seguente funzione modificata. In primo luogo controlla se esiste un oggetto collegamento e invia una chiamata di tracciamento dei collegamenti manuale solo se l'oggetto collegamento è una stringa vuota.

function linkCode(obj) {
  var lt = obj.href != null ? s.lt(obj.href) : "";
  if (lt=="") {
    s.tl(obj,"d","Example PDF download");
  }
}

In questa pagina