資料和計算狀態

Adobe使用者端資料層(ACDL)會合併您推送至稱為​ 計算狀態 ​之單一物件的每個資料物件。 任何指令碼都可以使用getState()隨時讀取計算狀態。 您可以一次推送所有資料,或透過不同指令碼進行多次小型推送。 無論是哪一種方式,運算狀態都相同。

window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push({ page: { title: "Getting started" } });
window.adobeDataLayer.push({ component: { "hero-1": { title: "Learn more", link: "learn-more.html" } } });
window.adobeDataLayer.push({ page: { language: "en" } });

在這些推播之後,adobeDataLayer.getState()會傳回下列物件:

{
  "page": {
    "title": "Getting started",
    "language": "en"
  },
  "component": {
    "hero-1": {
      "title": "Learn more",
      "link": "learn-more.html"
    }
  }
}

事件物件也可以攜帶資料。 ACDL會合併事件物件中除了event和eventInfo之外的每個索引鍵,這些索引鍵絕不會儲存在計算狀態中。 檢視事件。

合併規則 merge-rules

當您推送資料時,ACDL會將推送物件中的每個索引鍵與計算狀態做比較:

已推送的值
處於計算狀態的結果
不存在於計算狀態的索引鍵
新增索引鍵及其值。
物件,其計算狀態也儲存物件
合併兩個物件。 您未推送的鍵會保留其目前值。 此規則適用於每個巢狀層級。
字串、數字或布林值
取代目前的值。
陣列
取代目前的值。 請參閱陣列。
null或 undefined
刪除金鑰。 請參閱刪除資料。

例如,下方的第二個推播只會變更page.title。 page.language金鑰會保留其值:

adobeDataLayer.push({ page: { title: "Home", language: "en" } });
adobeDataLayer.push({ page: { title: "Products" } });
adobeDataLayer.getState("page");
// { title: "Products", language: "en" }

刪除資料 delete

若要刪除金鑰,請將null或undefined推入為其值:

adobeDataLayer.push({ page: { title: "Products", language: "en" }, user: { id: "123" } });
adobeDataLayer.push({ page: { language: null }, user: null });
adobeDataLayer.getState();
// { page: { title: "Products" } }

刪除物件內的最後一個索引鍵會留下空白物件。 若要一併刪除物件,請推播物件本身的null。

adobeDataLayer.push({ page: { title: null } });
adobeDataLayer.getState();
// { page: {} }

當您刪除該路徑上的索引鍵或包含該路徑的任何物件時,會呼叫使用path選項的接聽程式。

陣列 arrays

陣列會儲存為單一值。 當您將陣列推送到已容納陣列的索引鍵時,ACDL會取代整個陣列。 若要新增專案,請使用新專案推送完整陣列:

adobeDataLayer.push({ cart: { skus: ["a-100", "b-200"] } });
adobeDataLayer.push({ cart: { skus: ["a-100", "b-200", "c-300"] } });
adobeDataLayer.getState("cart.skus");
// ["a-100", "b-200", "c-300"]

ACDL會從您推送的陣列中移除null和undefined專案:

adobeDataLayer.push({ cart: { skus: ["a-100", null, "c-300"] } });
adobeDataLayer.getState("cart.skus");
// ["a-100", "c-300"]
NOTE
ACDL 2.x會依位置合併陣列,而非取代陣列。 在2.x中,將["c"]推播到["a", "b"]結果上,結果為["c", "b"]。 若要在兩個版本中取得相同的結果,請一律推送完整的陣列。

變更值的型別 change-type

您可以使用字串、數字、布林值或陣列來取代物件。 然而,在ACDL 3.x中,將物件推送至目前儲存字串、數字、布林值或陣列的索引鍵時,並不會取代值。 如果目前值為0、false或空字串,則會改為刪除索引鍵。

若要將值變更為物件,請先刪除索引鍵,然後推送物件:

adobeDataLayer.push({ product: "a-100" });
adobeDataLayer.push({ product: null });
adobeDataLayer.push({ product: { sku: "a-100", price: 25 } });
adobeDataLayer.getState("product");
// { sku: "a-100", price: 25 }

為避免這種情況,請在資料層設計中保持每個索引鍵的型別一致。

值型別 value-types

在資料層中使用與JSON相容的值:字串、數字、布林值、null、純物件和陣列。 ACDL在合併其他物件時,會轉換這些物件:

值
儲存為
Date物件
空白物件({})。 將日期儲存為字串(例如new Date().toISOString())或數字。
函數
空白物件({})。
Map或 Set
空白物件({})。
類別的實體
只包含執行個體本身可列舉屬性的純物件。
空白物件、空白陣列、空白字串、0和false
原樣儲存。

僅推送純物件。 當您直接推送其他值(例如字串、數字和陣列)時,ACDL會拒絕這些值。 請參閱push()。

副本,而非引用 copies

計算狀態與您推送的物件無關。 在推入物件後變更該物件不會變更計算狀態:

const page = { title: "Home" };
adobeDataLayer.push({ page: page });
page.title = "Changed";
adobeDataLayer.getState("page.title");
// "Home"

同樣地,getState()會傳回覆本。 變更傳回的物件不會變更資料層。 若要變更計算狀態,請一律推送變更。

recommendation-more-help
experience-platform-help-collection