tl()
方法是 Adobe Analytics 的重要核心元件。它會使用頁面上定義的所有 Analytics 變數、編譯成影像要求,然後將該資料傳送至 Adobe 資料收集伺服器。它的作用與 t()
方法類似,不過此方法不會增加頁面瀏覽數。若要追蹤連結和其他不視為完整頁面載入的元素,這個方法非常有用。
如果 trackDownloadLinks
或 trackExternalLinks
已啟用,AppMeasurement 會自動呼叫 tl()
方法,以便傳送下載連結和退出連結追蹤資料。如果您的組織想進一步控制要追蹤的連結與其行為,可以手動呼叫 tl()
方法。自訂連結只能手動追蹤。
Web SDK不會區分頁面檢視呼叫和連結追蹤呼叫;兩者皆使用 sendEvent
命令。 如果您想要Adobe Analytics將指定的XDM事件計為連結追蹤呼叫,請確定您的XDM資料包含或已對應至 web.webInteraction.name
, web.webInteraction.URL
,和 web.webInteraction.type
.
web.webInteraction.name
.web.webInteraction.URL
.web.webInteraction.type
. 有效值包括 other
(自訂連結)、download
(下載連結) 和 exit
(退出連結)。alloy("sendEvent", {
"xdm": {
"web": {
"webInteraction": {
"name": "My Custom Link",
"URL": "https://example.com",
"type": "other"
}
}
}
});
Adobe Analytics擴充功能有可設定連結追蹤呼叫的專用位置。
s.tl()
選擇鈕。您無法在Analytics擴充功能中設定任何選用引數。
當您想要傳送追蹤呼叫至 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>
如果 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");
}
}