s_gi

s_gi() 函數會依據報表套裝 ID 將 AppMeasurement 的例項實例化或尋找例項。AppMeasurement 可追蹤已建立的所有例項,而 s_gi() 會傳回報表套裝的現有例項 (若存在)。如果例項不存在,則會建立新例項。

使用Web SDK擴展實例化跟蹤對象

Web SDK擴展為您實例化和管理跟蹤對象。 但是,可以在擴展設定中自定義跟蹤對象名稱:

  1. 登錄到 Adobe Experience Platform資料收集 使用AdobeID憑據。
  2. 按一下所需的標記屬性。
  3. 轉到 擴展 ,然後按一下 配置 按鈕。
  4. 更改 名稱 欄位。 其預設值為 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>

請參閱 安裝SDK 的子菜單。

使用Adobe Analytics擴展實例化跟蹤對象

Analytics 擴充功能會替您將追蹤物件實例化或進行管理。不過,在設定 Adobe Analytics 擴充功能時,您也可以在「資料庫管理」摺疊式功能表中設定全域追蹤物件。

  1. 登錄到 Adobe Experience Platform資料收集 使用AdobeID憑據。
  2. 按一下所需的標記屬性。
  3. 前往擴充功能標記,然後按一下 Adobe Analytics 底下的​「設定」​按鈕。
  4. 展開「資料庫管理」摺疊式功能表,接著選取「為我管理資料庫」以外的任何選擇鈕。

全域變數文字欄位可讓您設定自訂追蹤物件。其預設值為 s

s_gi()在AppMeasurement和Analytics擴展自定義代碼編輯器中

呼叫 s_gi() 函數將追蹤物件實例化。其唯一引數包含以逗號分隔的報表套裝 ID 字串。報表套裝 ID 引數為必要項目。

秘訣

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");
注意

以下章節和範例包含複雜的實施作業主題。請徹底測試您的實施,以及追蹤貴組織解決方案設計文件中的重要自訂項目。

使用不同的追蹤物件來管理多個實施

如果您將多個追蹤物件實例化,可以傳送不同的資料至不同的報表套裝。這兩個追蹤物件彼此獨立運作。

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

本頁內容