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 includono other (Collegamenti personalizzati), download (Collegamenti di download) e exit (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.

  1. Accedi a Raccolta dati di Adobe Experience Platform utilizzando le credenziali Adobe ID.
  2. Fai clic sulla proprietà del tag desiderata.
  3. Vai alla scheda Rules, quindi fai clic sulla regola desiderata (o crea una regola).
  4. Sotto Actions, fai clic sull’azione desiderata o fai clic su '+' per aggiungere un'azione.
  5. Imposta il Extension elenco a discesa per Adobe Analytics e Action Type a Send Beacon.
  6. 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.

NOTE
AppMeasurement attiva automaticamente 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.

// 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");
  }
}
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690