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