tl

Metoden tl() är en viktig kärnkomponent för Adobe Analytics. Den tar alla analysvariabler som definieras på sidan, kompilerar dem till en bildbegäran och skickar data till datainsamlingsservrarna i Adobe. Den fungerar på ungefär samma sätt som metoden t(), men den här metoden ökar inte sidvisningen. Den är användbar för att spåra länkar och andra element som inte skulle betraktas som en fullständig sidinläsning.

Om trackDownloadLinks eller trackExternalLinks är aktiverade anropar AppMeasurementet automatiskt metoden tl() för att skicka hämtningslänkar och avsluta länkspårningsdata. Om din organisation föredrar att ha större kontroll över länkarna och deras beteende kan du anropa metoden tl() manuellt. Anpassade länkar kan bara spåras manuellt.

Länkspårning med Web SDK

Web SDK skiljer inte mellan sidvisningsanrop och länkspårningsanrop. Båda använder kommandot sendEvent.

Om du använder ett XDM-objekt och vill att Adobe Analytics ska räkna en viss händelse som ett länkspårningsanrop, ska du kontrollera att dina XDM-data innehåller:

alloy("sendEvent", {
  "xdm": {
    "web": {
      "webInteraction": {
        "name": "My Custom Link",
        "URL": "https://example.com",
        "type": "other"
      }
    }
  }
});

Om du använder ett dataobjekt och vill att Adobe Analytics ska räkna en viss händelse som ett länkspårningsanrop, ska du se till att dataobjektet innehåller:

alloy("sendEvent", {
  "data": {
    "__adobe": {
      "analytics": {
        "linkName": "My custom link",
        "linkURL": "https://example.com",
        "linkType": "o"
      }
    }
  }
});

Länkspårning med Adobe Analytics-tillägget

Adobe Analytics-tillägget har en dedikerad plats där ett länkspårningsanrop kan ställas in.

Du kan inte ange några valfria argument i Analytics-tillägget.

s.tl()-metoden i AppMeasurementet och den anpassade kodredigeraren för Analytics-tillägget

Anropa metoden s.tl() när du vill skicka ett spårningsanrop till Adobe.

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

Länkobjekt (obligatoriskt)

Argumentet för läntobjekt avgör om webbläsaren väntar upp till 500 ms innan den navigerar bort från sidan. Om en bildbegäran skickas tidigare än 500 ms navigerar sidan direkt till den klickade länken.

// 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");

Länktyp (obligatoriskt)

Argumentet för länktyp är en sträng med ett tecken som avgör typen av anrop för länkspårning. Det finns tre giltiga värden.

// 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");

Länknamn (rekommenderas)

Argumentet för länknamn är en sträng som avgör dimensionsobjektet för länkspårning. När du använder dimensionerna Egen länk, Hämta länk eller Avsluta länk i rapporter innehåller den här strängen dimensionsobjektet. Om det här argumentet inte anges används variabeln 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");

Variabla åsidosättningar (valfritt)

Gör att du kan ändra variabelvärden för ett enskilt anrop. Mer information finns i Variabelåsidosättningar.

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

Exempel och användningsexempel

Skicka ett grundläggande länkspårningsanrop direkt i en HTML-länk:

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

Använd JavaScript för att göra ett grundläggande anrop för länkspårning med hjälp av metodargument:

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

Göra länkspårningsanrop i en anpassad funktion

Du kan sammanställa länkspårningskod i en fristående JavaScript-funktion. Anrop kan sedan göras i funktionen onClick för varje länk. Ange följande i en JavaScript-fil:

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

Du kan sedan anropa funktionen när du vill spåra en viss länk:

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

Undvik att spåra dubblettlänkar

Om trackDownloadLinks eller trackExternalLinks är aktiverade gör AppMeasurementet automatiskt ett länkspårningsanrop om rätt filter matchar. Om du även anropar s.tl() manuellt för de här länkklickningarna kan du skicka duplicerade data till Adobe. Duplicerade data ökar rapportnummer och gör dem mindre exakta.

Följande funktion skickar till exempel två länkspårningsanrop för samma länkklickning (manuella och automatiska hämtningslänkar):

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

Du kan förhindra dubblerade länkspårningsanrop genom att använda följande ändrade funktion. Först kontrolleras om ett läntobjekt finns och ett manuellt länkspårningsanrop skickas bara om läntobjektet är en tom sträng.

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

Använd metoden tl() med Activity Map

Du kan använda metoden tl() för att spåra anpassade element och för att konfigurera övertäckningsåtergivning för dynamiskt innehåll. Parametern linkName används också för att ställa in dimensionen Activity Map Link .

När metoden tl() anropas direkt från HTML-elementets on-click-händelse kan Activity Map visa en övertäckning för det elementet när webbsidan läses in. Exempel:

<a href="index.html" onclick="s.tl(this,'o','Example custom link');">Example link text</a>

När metoden tl() inte anropas direkt från elementets on-click-händelse kan Activity Map bara visa en övertäckning när du har klickat på det elementet. Exempel:

<a href="index.html" onclick="someFn(event);">Example link text</a>
<script>
  function someFn (event) {
    s.tl(event.srcElement,'o','Example custom link');
  }
</script>