tl
The tl()
är en viktig komponent i Adobe Analytics. Den tar alla analysvariabler som definieras på sidan, kompilerar dem till en bildbegäran och skickar data till datainsamlingsservrarna i Adobe. Det fungerar på liknande sätt som t()
den här metoden ökar dock 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.
If trackDownloadLinks
eller trackExternalLinks
aktiveras, AppMeasurementet anropar automatiskt tl()
metod för att skicka hämtningslänk och avsluta länkspårningsdata. Om din organisation föredrar att ha större kontroll över länkarna och deras beteende kan du anropa tl()
-metoden 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 sendEvent
-kommando. Om du vill att Adobe Analytics ska räkna en viss XDM-händelse som ett länkspårningsanrop, kontrollerar du att dina XDM-data innehåller eller är mappade till web.webInteraction.name
, web.webInteraction.URL
och web.webInteraction.type
.
- Länka namnmappningar till
web.webInteraction.name
. - Länka URL-mappar till
web.webInteraction.URL
. - Länka typmappningar till
web.webInteraction.type
. Giltiga värden ärother
(Anpassade länkar),download
(Hämta länkar) ochexit
(Avsluta länkar).
alloy("sendEvent", {
"xdm": {
"web": {
"webInteraction": {
"name": "My Custom Link",
"URL": "https://example.com",
"type": "other"
}
}
}
});
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.
- Logga in på Adobe Experience Platform Data Collection med inloggningsuppgifterna för ditt AdobeID.
- Klicka på den önskade taggegenskapen.
- Gå till Rules och sedan klicka på önskad regel (eller skapa en regel).
- Under Actionsklickar du på önskad åtgärd eller klickar på '+' om du vill lägga till ett funktionsmakro.
- Ange Extension nedrullningsbar lista till Adobe Analytics och Action Type till Send Beacon.
- Klicka på
s.tl()
alternativknapp.
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
Ring 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.
useBeacon
variabel för att avsluta länkar, vilket gör att det här argumentet inte längre behövs i moderna webbläsare. Detta argument användes oftare i tidigare versioner av AppMeasurement.this
: Vänta upp till 500 ms för att ge AppMeasurementet tid att skicka en bildbegäran. Standardvärde.true
: Vänta inte.
// 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.
o
: Länken är en Egen länk.d
: Länken är en Hämta länk.e
: Länken är en Avsluta länk.
// 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 Egen länk, Hämta länk, eller Avsluta länk dimensioner i rapportering, den här strängen innehåller dimensionsobjektet. Om det här argumentet inte anges visas linkURL -variabeln används.
// 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. Se variabelåsidosättningar för mer information.
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 metodargument:
s.tl(true,"o","Example link");
Göra länkspårningsanrop i en anpassad funktion
Du kan konsolidera länkspårningskod i en fristående JavaScript-funktion som definieras på sidan eller i en länkad JavaScript-fil. 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
If trackDownloadLinks
eller trackExternalLinks
om de är aktiverade, gör AppMeasurementet automatiskt ett länkspårningsanrop om rätt filter matchar. Om du även ringer manuellt s.tl()
för dessa länkklick 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");
}
}