s_gi
s_gi()
函數會依據報表套裝 ID 將 AppMeasurement 的例項實例化或尋找例項。AppMeasurement 可追蹤已建立的所有例項,而 s_gi()
會傳回報表套裝的現有例項 (若存在)。如果例項不存在,則會建立新例項。
使用 Web SDK 擴充功能實例化追蹤物件
Web SDK 擴充功能會替您將追蹤物件實例化並進行管理。但是,您可以在擴充功能設定中自訂追蹤物件名稱:
- 使用您的 AdobeID 認證登入 Adobe Experience Platform 資料彙集。
- 按一下所需的標籤屬性。
- 前往「擴充功能」索引標籤,然後按一下 Adobe Experience Platform Web SDK 下的 「設定」 按鈕。
- 將名稱欄位變更為所需的值。其預設值為
alloy
。
實例化手動實作 Web SDK 的追蹤物件
以下程式碼會載入 Web SDK 並實例化追蹤物件。將內嵌指令碼尾端的字串 "alloy"
變更為所需的值,即可自訂追蹤物件名稱。
<script>
!function(n,o){o.forEach(function(o){n[o]||((n.__alloyNS=n.__alloyNS||
[]).push(o),n[o]=function(){var u=arguments;return new Promise(
function(i,l){n[o].q.push([i,l,u])})},n[o].q=[])})}
(window,["alloy"]);
</script>
<script src="https://cdn1.adoberesources.net/alloy/2.6.4/alloy.min.js" async></script>
如需詳細資訊,請參閱 Web SDK 文件中的安裝 SDK。
使用 Adobe Analytics 擴充功能實例化追蹤物件
Analytics 擴充功能會替您將追蹤物件實例化或進行管理。不過,在設定 Adobe Analytics 擴充功能時,您也可以在「資料庫管理」摺疊式功能表中設定全域追蹤物件。
- 使用您的 AdobeID 認證登入 Adobe Experience Platform 資料彙集。
- 按一下所需的標籤屬性。
- 前往擴充功能標籤,然後按一下 Adobe Analytics 底下的 「設定」 按鈕。
- 展開「資料庫管理」摺疊式功能表,接著選取「為我管理資料庫」以外的任何選擇鈕。
全域變數文字欄位可讓您設定自訂追蹤物件。其預設值為 s
。
AppMeasurement 和 Analytics 擴充功能自訂程式碼編輯器中的 s_gi()
呼叫 s_gi()
函數將追蹤物件實例化。其唯一引數包含以逗號分隔的報表套裝 ID 字串。報表套裝 ID 引數為必要項目。
TIP
Adobe 建議使用
s
變數作為追蹤物件。Adobe 在自己的文件、實施範例和外掛程式中都使用 s
。然而,只要在網站上保持一致,您可以使用任何變數。// Instantiate the tracking object with a single report suite
var s = s_gi("examplersid");
// Instantiate the tracking object to send to multiple report suites
var s = s_gi("examplersid1,examplersid2");
CAUTION
以下章節和範例包含複雜的實施作業主題。請徹底測試您的實施,以及追蹤貴組織解決方案設計文件中的重要自訂項目。
使用不同的追蹤物件來管理多個實施
如果您將多個追蹤物件實例化,可以傳送不同的資料至不同的報表套裝。這兩個追蹤物件彼此獨立運作。
// Instantiate two separate tracking objects to two different report suites
var s = s_gi('examplersid1');
var z = s_gi('examplersid2');
// The s object and z object contain their own independent Analytics variables simultaneously
s.pageName = "Example page name 1";
z.pageName = "Example page name 2";
// Send data to the examplersid1 report suite
s.t();
// Send data to the examplersid2 report suite
z.t();
覆寫 s 物件後還原 AppMeasurement 變數
某些協力廠商工具可能也會使用 JavaScript s
物件。如果您不小心覆寫網站上的 s
物件,可以呼叫 s_gi
並搭配相同的 RSID 字串引數,還原所有遭到覆寫的變數和方法。
// Step 1: Instantiate the tracking object
var s = s_gi("examplersid");
// Step 2: Set eVar1
s.eVar1 = "Example value";
// Step 3: Accidentally overwrite the tracking object
s = "3rd party tool";
// Step 4: If you attempt to send a tracking call, an error is returned. Instead, re-instantiate the tracking object
s = s_gi("examplersid");
// Step 5: The previous values of all variables are preserved. You can send a tracking call and eVar1 is correctly set
s.t();
使用多個變數參考相同的追蹤物件
如果兩變數透過相同的報表套裝參考相同的 s_gi()
函數,您可以交互使用變數。
// If the RSID is the same, any variables set in the 's' tracking object also get set in 'z' tracking object
var s = s_gi('examplersid');
var z = s_gi('examplersid');
s.eVar1 = "Shared tracking object value";
// This tracking call contains the above eVar1 value
z.t();
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690