tl

Laatst bijgewerkt: 17 juli 2024
  • Onderwerpen:

Gemaakt voor:

  • Beheerder
  • Ontwikkelaar

De methode tl() is een belangrijke kerncomponent voor Adobe Analytics. Het neemt alle variabelen die van Analytics op de pagina worden bepaald, compileert hen in een beeldverzoek, en verzendt die gegevens naar de servers van de de gegevensinzameling van de Adobe. Deze methode werkt op ongeveer dezelfde manier als de methode t() , maar bij deze methode worden de paginaweergaven niet vergroot. Het is handig voor het bijhouden van koppelingen en andere elementen die niet als een volledige pagina worden geladen.

Als trackDownloadLinks of trackExternalLinks zijn ingeschakeld, roept het AppMeasurement automatisch de methode tl() aan om de downloadkoppeling te verzenden en de gegevens voor het bijhouden van koppelingen af te sluiten. Als uw organisatie liever meer controle heeft over de koppelingen en het gedrag ervan, kunt u de methode tl() handmatig aanroepen. U kunt aangepaste koppelingen alleen handmatig bijhouden.

Koppelingen bijhouden met de SDK van het web

De SDK van het Web maakt geen onderscheid tussen de vraag van de paginamening en verbinding het volgen vraag; allebei gebruiken het sendEvent bevel.

Als u een XDM-object gebruikt en Adobe Analytics een bepaalde gebeurtenis wilt tellen als een aanroep voor het bijhouden van koppelingen, moet u ervoor zorgen dat uw XDM-gegevens:

  • Koppelingsnaam: toegewezen aan xdm.web.webInteraction.name .
  • URL van koppeling: toegewezen aan xdm.web.webInteraction.URL .
  • Koppelingstype: toegewezen aan xdm.web.webInteraction.type . Geldige waarden zijn other (Aangepaste koppelingen), download (Koppelingen downloaden) en exit (Koppelingen afsluiten).
alloy("sendEvent", {
  "xdm": {
    "web": {
      "webInteraction": {
        "name": "My Custom Link",
        "URL": "https://example.com",
        "type": "other"
      }
    }
  }
});

Als u een gegevensobject gebruikt en Adobe Analytics een bepaalde gebeurtenis wilt laten tellen als een aanroep voor het bijhouden van koppelingen, moet u ervoor zorgen dat het gegevensobject de volgende gegevens bevat:

  • Koppelingsnaam: toegewezen aan data.__adobe.analytics.linkName .
  • URL van koppeling: toegewezen aan data.__adobe.analytics.linkURL .
  • Koppelingstype: toegewezen aan data.__adobe.analytics.linkType . Geldige waarden zijn o (Aangepaste koppelingen), d (Koppelingen downloaden) en e (Koppelingen afsluiten).
alloy("sendEvent", {
  "data": {
    "__adobe": {
      "analytics": {
        "linkName": "My custom link",
        "linkURL": "https://example.com",
        "linkType": "o"
      }
    }
  }
});

Koppelingen bijhouden met de Adobe Analytics-extensie

De extensie Adobe Analytics heeft een specifieke locatie om een aanroep voor het bijhouden van koppelingen in te stellen.

  1. Login aan de Inzameling van Gegevens van Adobe Experience Platformgebruikend uw geloofsbrieven van AdobeID.
  2. Klik op de gewenste tageigenschap.
  3. Ga naar het tabblad Rules en klik vervolgens op de gewenste regel (of maak een regel).
  4. Klik onder Actions op de gewenste actie of klik op het pictogram '+' om een actie toe te voegen.
  5. Stel de vervolgkeuzelijst Extension in op Adobe Analytics en de vervolgkeuzelijst op Action Type op Send Beacon .
  6. Klik op het keuzerondje s.tl() .

U kunt geen optionele argumenten instellen in de extensie Analytics.

s.tl()-methode in AppMeasurement en de aangepaste code-editor van de extensie Analytics

Roep de methode s.tl() aan wanneer u een volgende vraag naar Adobe wilt verzenden.

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

Koppelingsobject (vereist)

Het argument voor het koppelingsobject bepaalt of de browser tot 500 ms wacht voordat er vanaf de pagina wordt genavigeerd. Als een verzoek om een afbeelding eerder dan 500 ms wordt verzonden, navigeert de pagina direct naar de aangeklikte koppeling.

NOTE
Met AppMeasurement wordt de variabele useBeacon automatisch ingeschakeld voor afsluitkoppelingen, waardoor dit argument niet langer nodig is in moderne browsers. Dit argument werd vaker gebruikt in vorige versies van AppMeasurement.
  • this: wacht tot 500 ms om AppMeasurement tijd te geven om een afbeeldingsverzoek te verzenden. Standaardwaarde.
  • true: wacht niet.
// 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");

Koppelingstype (vereist)

Het koppelingstype argument is een enig-karakterkoord dat het type van verbinding het volgen vraag bepaalt. Er zijn drie geldige waarden.

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

Koppelingsnaam (aanbevolen)

Het argument van de verbindingsnaam is een koord dat het verbinding volgende afmetingspunt bepaalt. Wanneer het gebruiken van de Verbinding van de Douane, Verbinding van de Download, of Verbinding van de Uitgangdimensies in het melden, bevat dit koord het afmetingspunt. Als dit argument niet wordt geplaatst, wordt de linkURLvariabele gebruikt.

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

Variabele overschrijvingen (optioneel)

Laat u veranderlijke waarden voor één enkele vraag veranderen. Zie veranderlijke met voeten treedtvoor meer informatie.

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

Voorbeelden en gebruiksgevallen

Verzend een basisverbinding het volgen vraag direct binnen een verbinding van HTML:

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

JavaScript gebruiken om een eenvoudige aanroep voor het bijhouden van koppelingen te maken met behulp van methodeargumenten:

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

Koppelingen bijhouden aanroepen maken binnen een aangepaste functie

U kunt code voor het bijhouden van koppelingen consolideren in een zelfstandige JavaScript-functie. Aanroepen kunnen vervolgens worden uitgevoerd in de functie onClick van elke koppeling. Stel het volgende in een JavaScript-bestand in:

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

Vervolgens kunt u de functie aanroepen wanneer u een bepaalde koppeling wilt bijhouden:

<!-- Use wherever you want to track links -->
<a href="example.html" onClick="trackClickInteraction('Example link');">Click here</a>
NOTE
Door de methode tl() indirect aan te roepen, kunt u de rapportage van Activity Map-overlays minder handig maken. U moet op elke koppeling klikken om de functie te registreren bij het koppelingselement. Activity Mappen in Workspace worden echter op dezelfde manier bijgehouden.

Dubbele koppelingen niet bijhouden

Als trackDownloadLinks of trackExternalLinks zijn ingeschakeld, wordt door het AppMeasurement automatisch een aanroep naar het bijhouden van koppelingen gemaakt als de juiste filters overeenkomen. Als u ook handmatig s.tl() voor deze koppeling aanroept, kunt u gedupliceerde gegevens naar de Adobe verzenden. Met dubbele gegevens worden de rapportnummers opgevoerd en minder nauwkeurig gemaakt.

De volgende functie verzendt bijvoorbeeld twee aanroepen voor het bijhouden van koppelingen naar dezelfde link (handmatige en automatische downloadkoppelingen):

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

U kunt helpen dubbele verbinding het volgen vraag verhinderen door de volgende gewijzigde functie te gebruiken. Het controleert eerst of een verbindingsvoorwerp bestaat, en verzendt slechts een handvraag van het verbinden het volgen als het verbindingsvoorwerp een lege koord is.

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

De methode tl() met Activity Map gebruiken

Met de methode tl() kunt u aangepaste elementen bijhouden en de rendering van bedekkingen configureren voor dynamische inhoud. De linkName parameter wordt ook gebruikt om de Activity Map 2} dimensie van de Verbinding te plaatsen.

Wanneer de methode tl() rechtstreeks wordt aangeroepen vanuit de klikgebeurtenis van het HTML-element, kan de Activity Map een bedekking voor dat element weergeven wanneer de webpagina wordt geladen. Bijvoorbeeld:

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

Wanneer de methode tl() niet rechtstreeks wordt aangeroepen vanuit de klikgebeurtenis van het HTML-element, kan de Activity Map alleen een bedekking weergeven wanneer op dat element is geklikt. Bijvoorbeeld:

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

Analytics