tl

tl() 方法是 Adobe Analytics 的重要核心元件。它會使用頁面上定義的所有 Analytics 變數、編譯成影像要求,然後將該資料傳送至 Adobe 資料收集伺服器。它的作用與 t() 方法類似,不過此方法不會增加頁面檢視。若要追蹤連結和其他不視為完整頁面載入的元素,這個方法非常有用。

如果 trackDownloadLinkstrackExternalLinks 已啟用,AppMeasurement 會自動呼叫 tl() 方法,以便傳送下載連結和退出連結追蹤資料。如果您的組織想進一步控制要追蹤的連結與其行為,可以手動呼叫 tl() 方法。自訂連結只能手動追蹤。

Adobe Experience Platform Launch 中的連結追蹤呼叫

Launch 有設定連結追蹤呼叫的專用位置。

  1. 使用您的 AdobeID 憑證登入 launch.adobe.com
  2. 按一下所需的屬性。
  3. 前往規則標籤,然後按一下所需的規則 (或建立規則)。
  4. 在「動作」下方按一下「+」圖示
  5. 將「擴充功能」下拉式清單設為「Adobe Analytics」,再將「動作類型」設為「傳送信標」。
  6. 按一下 s.tl() 選擇鈕。

您不能在 Launch 中設定任何選用引數。

AppMeasurement 和 Launch 自訂程式碼編輯器中的 s.tl() 方法

當您想要傳送追蹤呼叫至 Adobe 時,請呼叫 s.tl() 方法。

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

連結物件 (必要)

連結物件引數決定在離開頁面進行導覽前,瀏覽器是否最多等候 500 毫秒。如果影像要求在 500 毫秒內傳送,頁面會立即導覽至點按的連結。

注意

AppMeasurement 會自動針對退出連結啟用 useBeacon 變數,因此現代瀏覽器不再需要該引數。此引數在舊版 AppMeasurement 中較常使用。

  • this:等候最多 500 毫秒,讓 AppMeasurement 有時間傳送影像要求。預設值。
  • true:請勿等候。
// 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");

連結類型 (必填)

連結類型引數是個單一字元的字串,用於判斷連結追蹤呼叫的類型。 有三個有效值。

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

連結名稱(建議)

連結名稱引數是決定連結追蹤維度項目的字串。在報告中使用自訂連結下載連結、或退出連結維度時,該字串包含維度項目。如果此引數未經設定,則會使用 linkURL 變數。

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

變數覆寫(可選擇使用)

可讓您變更單一呼叫的變數值。如需詳細資訊,請參閱變數覆寫

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

範例和使用案例

直接在 HTML 連結內傳送基本連結追蹤呼叫:

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

使用 JavaScript,以使用方法引數進行基本連結追蹤呼叫:

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

在自訂函數中進行連結追蹤呼叫

您可以將連結追蹤程式碼併入頁面上或連結 JavaScript 檔案中所定義的獨立 JavaScript 函數。接著,即可在每個連結的 onClick 函數中發出呼叫。在 JavaScript 檔案中設定下列項目:

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

之後,每當想要追蹤指定連結時,就可以呼叫函數:

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

避免追蹤重複的連結

如果 trackDownloadLinkstrackExternalLinks 已啟用,而且如果正確的篩選器相符,AppMeasurement 就會自動進行連結追蹤呼叫。如果您也手動針對這些連結點擊呼叫 s.tl(),可以將重複資料傳送至 Adobe。重複資料會增加報表數量,降低精確度。

例如,以下函數會針對相同的連結點擊傳送兩個連結追蹤呼叫 (手動和自動下載連結):

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

您可以使用以下經過修改的函數,協助預防重複的連結追蹤呼叫。它會先檢查連結物件是否存在,並僅在連結物件為空字串時傳送手動連結追蹤呼叫。

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

本頁內容