資料和計算狀態
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"]
["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()會傳回覆本。 變更傳回的物件不會變更資料層。 若要變更計算狀態,請一律推送變更。