s_gi

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

使用Web SDK擴充功能實例化追蹤物件

Web SDK擴充功能會為您實例化及管理追蹤物件。 不過，您可以在擴充功能設定中自訂追蹤物件名稱：

  1. 使用您的 AdobeID 認證登入 Adobe Experience Platform 資料彙集。
  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 如需詳細資訊，請參閱網頁SDK檔案。

使用Adobe Analytics擴充功能實例化追蹤物件

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

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

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

AppMeasurement和Analytics擴充功能自訂程式碼編輯器中的s_gi()

呼叫 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();

本頁內容