tl

De tl() Deze methode is een belangrijk kernonderdeel van 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. Het werkt op dezelfde manier als de t() Deze methode verhoogt de paginaweergaven echter niet. Het is handig voor het bijhouden van koppelingen en andere elementen die niet als een volledige pagina worden geladen.

Indien trackDownloadLinks of trackExternalLinks worden toegelaten, roept het AppMeasurement automatisch tl() methode voor het verzenden van de downloadkoppeling en het afsluiten van koppelingsvolggegevens. Als uw organisatie liever meer controle heeft over de koppelingen en het gedrag ervan, kunt u de tl() handmatig. U kunt aangepaste koppelingen alleen handmatig bijhouden.

Koppelingen bijhouden met de SDK van het web

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

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.
  • Koppeling-URL: 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.
  • Koppeling-URL: 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. Aanmelden bij Adobe Experience Platform-gegevensverzameling met uw Adobe-id-referenties.
  2. Klik op de gewenste tageigenschap.
  3. Ga naar de Rules klikt u op de gewenste regel (of maakt u een regel).
  4. Onder Actions, klikt u op de gewenste handeling of klikt u op de knop '+' pictogram om een handeling toe te voegen.
  5. Stel de Extension vervolgkeuzelijst naar Adobe Analytics en de Action Type tot Send Beacon.
  6. Klik op de knop s.tl() keuzerondje.

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 s.tl() methode 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
AppMeasurement schakelt automatisch het useBeacon variabele voor exit links, waardoor dit argument niet langer nodig is in moderne browsers. Dit argument werd vaker gebruikt in vorige versies van AppMeasurement.
  • this: Wacht tot maximaal 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 u de opdracht Aangepaste koppeling, Koppeling downloaden, of Koppeling afsluiten afmetingen in het rapporteren, bevat dit koord het afmetingspunt. Als dit argument niet is ingesteld, wordt linkURL variable wordt 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 variabele overschrijvingen voor 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>

Gebruik JavaScript om een basisvraag van het verbinden het volgen te maken gebruikend methodeargumenten:

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

Koppelingen bijhouden aanroepen maken binnen een aangepaste functie

U kunt koppelingsvolgcode verenigen in een zelfstandige JavaScript-functie die op de pagina of in een gekoppeld JavaScript-bestand is gedefinieerd. De vraag kan dan in de onClick functie van elke verbinding worden gemaakt. 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>

Dubbele koppelingen niet bijhouden

Indien trackDownloadLinks of trackExternalLinks worden toegelaten, maakt het AppMeasurement automatisch een verbinding het volgen vraag als de correcte filters aanpassen. Als u ook handmatig s.tl() voor deze koppeling klikt u op dubbele gegevens naar de Adobe. 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");
  }
}
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690