tl

Die tl()-Methode ist eine wichtige Kernkomponente von Adobe Analytics. Sie nimmt alle auf der Seite definierten Analytics-Variablen, kompiliert sie in eine Bildanforderung und sendet diese Daten an die Adobe-Datenerfassungs-Server. Sie funktioniert ähnlich wie die t()-Methode, allerdings inkrementiert diese Methode keine Seitenansichten. Sie ist nützlich, um Links und andere Elemente zu verfolgen, die nicht als vollständige Seitenladung betrachtet werden.

Wenn trackDownloadLinks oder trackExternalLinks aktiviert ist, ruft AppMeasurement automatisch die tl()-Methode auf, um Download- und Exitlinktracking-Daten zu senden. Wenn Ihr Unternehmen mehr Kontrolle über die zu verfolgenden Links und deren Verhalten haben möchte, können Sie die tl()-Methode manuell aufrufen. Benutzerspezifische Links können nur manuell verfolgt werden.

Linktracking mit dem Web SDK

Das Web SDK unterscheidet nicht zwischen Seitenansichtsaufrufen und Linktracking-Aufrufen. Beide verwenden die Variable sendEvent Befehl. Wenn Sie möchten, dass Adobe Analytics ein bestimmtes XDM-Ereignis als Linktracking-Aufruf zählt, stellen Sie sicher, dass Ihre XDM-Daten enthalten oder zugeordnet sind zu web.webInteraction.name, web.webInteraction.URL, und web.webInteraction.type.

  • Linkname wird zugeordnet zu web.webInteraction.name.
  • Link-URL wird zugeordnet zu web.webInteraction.URL.
  • Link-Typ wird zugeordnet web.webInteraction.type. Gültige Werte sind other (benutzerspezifische Links), download (Downloadlinks) und exit (Exitlinks).
alloy("sendEvent", {
  "xdm": {
    "web": {
      "webInteraction": {
        "name": "My Custom Link",
        "URL": "https://example.com",
        "type": "other"
      }
    }
  }
});

Linktracking mit der Adobe Analytics-Erweiterung

Die Adobe Analytics-Erweiterung verfügt über einen speziellen Speicherort, um einen Linktracking-Aufruf festzulegen.

  1. Melden Sie sich bei der Adobe Experience Platform-Datenerfassung mit Ihren Adobe ID-Anmeldeinformationen an.
  2. Klicken Sie auf die gewünschte Tag-Eigenschaft.
  3. Gehen Sie zur Registerkarte „Regeln“ und klicken Sie dann auf die gewünschte Regel (oder erstellen Sie eine Regel).
  4. under Aktionen, klicken Sie auf die gewünschte Aktion oder klicken Sie auf die '+' -Symbol, um eine Aktion hinzuzufügen.
  5. Legen Sie die Erweiterung Dropdown-Liste zu Adobe Analytics und die Aktionstyp nach Beacon senden.
  6. Klicken Sie auf die Optionsschaltfläche s.tl().

Sie können keine optionalen Argumente in der Analytics-Erweiterung festlegen.

s.tl()-Methode in AppMeasurement und im benutzerdefinierten Code-Editor der Analytics-Erweiterung

Rufen Sie die s.tl()-Methode auf, wenn Sie einen Tracking-Aufruf an Adobe senden möchten.

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

Das Link-Objekt-Argument bestimmt, ob der Browser bis zu 500 ms wartet, bevor er von der Seite weg navigiert. Wenn eine Bildanforderung früher als 500 ms gesendet wird, navigiert die Seite sofort zum geklickten Link.

NOTE
AppMeasurement aktiviert automatisch die useBeacon-Variable für Exitlinks, sodass dieses Argument in modernen Browsern nicht mehr benötigt wird. Dieses Argument wurde in früheren Versionen von AppMeasurement häufiger verwendet.
  • this: Warten Sie bis zu 500 ms, damit AppMeasurement Zeit zum Senden einer Bildanforderung hat. Standardwert.
  • true: Nicht warten.
// 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");

Das Link-Typ-Argument ist eine aus einem einzigen Buchstaben bestehende Zeichenfolge, die den Typ des Linktracking-Aufrufs bestimmt. Es gibt drei gültige Werte.

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

Das Link-Name-Argument ist eine Zeichenfolge, die das Linktracking-Dimensionselement bestimmt. Bei Verwendung der Dimensionen Benutzerspezifischer Link, Downloadlink oder Exitlink beim Reporting enthält diese Zeichenfolge das Dimensionselement. Wird dieses Argument nicht festgelegt, dann wird die Variable linkURL verwendet.

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

Variablenüberschreibungen (optional)

Ermöglicht die Änderung von Variablenwerten für einen einzelnen Aufruf. Weitere Informationen finden Sie unter Variablenüberschreibungen.

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

Beispiele und Anwendungsfälle

Senden Sie einen einfachen Linktracking-Aufruf direkt innerhalb eines HTML-Links:

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

Verwenden Sie JavaScript, um einen einfachen Linktracking-Aufruf mithilfe von Methodenargumenten durchzuführen:

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

Linktracking-Aufrufe innerhalb einer benutzerdefinierten Funktion

Sie können den Linktracking-Code in einer eigenständige JavaScript-Funktion zusammenfassen, die auf der Seite oder in einer verknüpften JavaScript-Datei definiert ist. Aufrufe können dann in der onClick-Funktion jedes Links erfolgen. Legen Sie Folgendes in einer JavaScript-Datei fest:

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

Sie können die Funktion dann immer dann aufrufen, wenn Sie einen bestimmten Link verfolgen möchten:

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

Wenn trackDownloadLinks oder trackExternalLinks aktiviert ist, führt AppMeasurement automatisch einen Linktracking-Aufruf durch, wenn die richtigen Filter übereinstimmen. Wenn Sie s.tl() auch manuell für diese Link-Klicks aufrufen, können Sie doppelte Daten an Adobe senden. Doppelte Daten überhöhen die Berichtsnummern auf und machen sie weniger genau.

Beispielsweise sendet die folgende Funktion zwei Linktracking-Aufrufe für denselben Link-Klick (manuelle und automatische Downloadlinks):

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

Mithilfe der folgenden geänderten Funktion können Sie doppelte Linktracking-Aufrufe vermeiden. Sie prüft zunächst, ob ein Link-Objekt existiert, und sendet nur dann einen manuellen Linktracking-Aufruf, wenn das Link-Objekt eine leere Zeichenfolge ist.

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