tl

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

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

使用 Adobe Experience Platform 中的標記的連結追蹤呼叫

資料收集 UI 有一個專用位置可設定連結追蹤呼叫。

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

您無法在資料收集 UI 中設定任何選用引數。

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

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

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

連結物件 (必要)

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

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

連結類型 (必填)

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

• o：連結是自訂連結。
• d：連結是下載連結。
• e：連結是退出連結。

// 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>

避免追蹤重複的連結

如果 trackDownloadLinks 或 trackExternalLinks 已啟用，而且如果正確的篩選器相符，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");
  }
}