tl
Il tl()
Il metodo è un componente core importante per Adobe Analytics. Prende tutte le variabili di Analytics definite sulla pagina, le compila in una richiesta di immagine e invia tali dati ai server di raccolta dati di Adobe. Funziona in modo simile al 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 caricamento di pagina completo.
Se trackDownloadLinks
o trackExternalLinks
sono attivati, AppMeasurement chiama automaticamente tl()
metodo per inviare i dati di tracciamento dei collegamenti di download e di uscita. Se la tua organizzazione preferisce avere un maggiore controllo sui collegamenti da tracciare e sul loro comportamento, puoi chiamare il tl()
manuale. I collegamenti personalizzati possono essere tracciati solo manualmente.
Tracciamento dei collegamenti tramite Web SDK
L’SDK per web non distingue tra chiamate di visualizzazione pagina e chiamate di tracciamento dei collegamenti; entrambe utilizzano sendEvent
comando. Se vuoi che Adobe Analytics conti un dato evento XDM come chiamata di tracciamento dei collegamenti, assicurati che i dati XDM includano o siano mappati su web.webInteraction.name
, web.webInteraction.URL
, e web.webInteraction.type
.
- Il nome del collegamento è associato a
web.webInteraction.name
. - Collega URL mappato a
web.webInteraction.URL
. - Il tipo di collegamento è associato a
web.webInteraction.type
. I valori validi includonoother
(Collegamenti personalizzati),download
(Collegamenti di download) eexit
(Collegamenti di uscita).
alloy("sendEvent", {
"xdm": {
"web": {
"webInteraction": {
"name": "My Custom Link",
"URL": "https://example.com",
"type": "other"
}
}
}
});
Tracciamento dei collegamenti tramite l’estensione Adobe Analytics
L'estensione Adobe Analytics dispone di una posizione dedicata per impostare una chiamata di tracciamento dei collegamenti.
- Accedi a Raccolta dati di Adobe Experience Platform utilizzando le credenziali Adobe ID.
- Fai clic sulla proprietà del tag desiderata.
- Vai alla scheda Rules, quindi fai clic sulla regola desiderata (o crea una regola).
- Sotto Actions, fai clic sull’azione desiderata o fai clic su '+' per aggiungere un'azione.
- Imposta il Extension elenco a discesa per Adobe Analytics e Action Type a Send Beacon.
- Fai clic su
s.tl()
pulsante di opzione.
Non è possibile impostare argomenti facoltativi nell’estensione Analytics.
Metodo s.tl() in AppMeasurement e nell’editor di codice personalizzato dell’estensione Analytics
Chiama il s.tl()
quando desideri inviare una chiamata di tracciamento ad Adobe.
s.tl([Link object],[Link type],[Link name],[Override variable]);
Oggetto collegamento (obbligatorio)
L'argomento oggetto link determina se il browser attende fino a 500 ms prima di uscire dalla pagina. Se una richiesta di immagine viene inviata prima di 500 ms, la pagina passa immediatamente al collegamento su cui è stato fatto clic.
useBeacon
variabile 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 all’AppMeasurement il tempo di 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 di un singolo carattere che determina il tipo di chiamata di tracciamento dei collegamenti. Sono disponibili tre valori validi.
o
: il collegamento è un Collegamento personalizzato.d
: il collegamento è un Collegamento di download.e
: il collegamento è un Collegamento di uscita.
// 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 si utilizza Collegamento personalizzato, Collegamento di download, o Collegamento di uscita dimensioni nel reporting, questa stringa contiene l’elemento dimensione. Se questo argomento non è impostato, il linkURL viene utilizzata la variabile.
// 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");
Override variabili (facoltative)
Consente di modificare i valori delle variabili per una singola chiamata. Consulta sostituzioni variabili per ulteriori informazioni.
var y = new Object();
y.eVar1 = "Override value";
y.linkTrackVars = "eVar1";
s.tl(true,"o","Example custom link",y);
Esempi e casi d’uso
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 del metodo:
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 nella pagina o in un file JavaScript collegato. È quindi possibile effettuare chiamate nella funzione onClick di ciascun 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 il tracciamento dei collegamenti duplicati
Se trackDownloadLinks
o trackExternalLinks
sono attivati, AppMeasurement effettua automaticamente una chiamata di tracciamento dei collegamenti se i filtri corretti corrispondono. Se richiami anche manualmente s.tl()
per questi clic sui collegamenti, puoi inviare dati duplicati ad Adobe. I dati duplicati gonfiano i numeri dei rapporti e li rendono meno precisi.
Ad esempio, la seguente funzione invierebbe due chiamate di tracciamento dei collegamenti per lo stesso clic di collegamento (collegamenti di download manuali e automatici):
function trackDownload(obj) {
s.tl(obj,"d","Example PDF download");
}
Puoi evitare chiamate di tracciamento dei collegamenti duplicate utilizzando la seguente funzione modificata. Verifica innanzitutto 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");
}
}