Show Menu
主題×

products

products 變數會追蹤產品與相連結的屬性。此變數通常會設定在個別產品頁面、購物車頁面和購買確認頁面上。此變數為多值變數,這表示您可以在相同點擊中傳送多個產品,而Adobe會將值剖析為個別的維度項目。
If this variable is set in a hit without a shopping cart event in the events variable, the Product Views metric increments by 1. 請確定您使用變數在每次點擊上設定了適當的購物車 products 事件。

Adobe Experience Platform Launch 中的產品

Launch 中沒有專用欄位可設定此變數。不過,有多個第三方擴充功能可提供協助。
  1. 使用您的 AdobeID 憑證登入 launch.adobe.com
  2. 按一下所需的屬性。
  3. 前往擴充功能標籤,然後按一下「目錄」檢視所有可用的擴充功能。
  4. 搜尋 "product" 一字,幾個可用來協助設定此變數的擴充功能隨即會顯示。
您可以使用其中一個擴充功能,或依照下方的 AppMeasurement 語法使用自訂程式碼編輯器。

AppMeasurement 和 Launch 自訂程式碼編輯器中的 s.products

s.products 變數是字串,其中包含每個產品個別擁有的多個分隔欄位。每個產品在所有欄位中最多可包含 100 個位元組。在字串中以分號 ( ; ) 分隔每個欄位。
  • 類別 (選用):包羅萬象的產品類別。產品的分門別類由貴組織決定。
  • 產品名稱 (必要):產品的名稱。
  • 數量 (選用):此產品在購物車內的數量有多少。此欄位僅適用於購買事件的點擊。
  • 價格 (選用):小數形式的產品總價。如果數量超過一個,請將價格設定為總價,而非個別產品價格。調整此值的貨幣,使其與 currencyCode 變數相符。請勿在此欄位中加入貨幣符號。此欄位僅適用於購買事件的點擊。
  • 事件 (選用):與產品相連結的事件。請使用垂直號 ( | ) 分隔多個事件。如需詳細資訊,請參閱 事件
  • eVar (選用):與產品相連結的銷售 eVar。請使用垂直號 ( | ) 分隔多個銷售 eVar。如需詳細資訊,請參閱 銷售 eVar
// Set a single product using all available fields
s.products = "Example category;Example product;1;3.50;event1=4.99|event2=5.99;eVar1=Example merchandising value 1|eVar2=Example merchandising value 2";

此變數支援同一個點擊中的多個產品,因此對於購物車和包含多種產品的購買活動非常有價值。雖然每項產品有 100 個位元組的限制,但 products 變數的總長度為 64K。請在字串中以逗號 ( , ) 分隔每項產品。
// Set multiple products - useful for when a visitor views their shopping cart
s.products = "Example category 1;Example product 1;1;3.50,Example category 2;Example product 2,1,5.99";

請移除產品名稱、類別和銷售 eVar 值中的所有分號、逗號和垂直號。如果產品名稱包含逗號,AppMeasurement 會將其解析為新產品的開頭。這個錯誤的解析會拋出產品字串剩餘的部分,導致維度和報表中的資料不正確。

範例

在省略欄位及納入多個產品時, products 變數是有彈性的。這種彈性可能會導致您很容易遺漏分隔字元,致使實施傳送錯誤的資料給 Adobe。
// Include only product and category. Common on individual product pages
s.products = "Example category;Example product";

// Include only product name if you do not want to use product category
s.products = ";Example product";

// One product has a category, the other does not. Note the comma and adjacent semicolon to omit category
s.products = "Example category;Example product 1,;Example product 2";

// A visitor purchases a single product; record quantity and price
s.events = "purchase";
s.products = "Example category;Example product;1;6.99";

// A visitor purchases multiple products with different quantities
s.events = "purchase";
s.products = "Example category;Example product 1;9;26.91,Example category;Example product 2;4;9.96";

// Attribute currency event1 only to product 2 and not product 1
s.events = "event1";
s.products = "Example category 1;Example product 1;1;1.99,Example category 2;Example product 2;1;2.69;event1=1.29";

// Use multiple numeric events in the product string
s.events = "event1,event2";
s.products = "Example category;Example product;1;4.20;event1=2.3|event2=5";

// Use merchandising eVars without any events. Note the adjacent semicolons to skip events
s.products = "Example category;Example product;1;6.69;;eVar1=Merchandising value";

// Use merchandising eVars without category, quantity, price, or events
s.products = ";Example product;;;;eVar1=Merchandising value";

// Multiple products using multiple different events and multiple different merchandising eVars
s.events = "event1,event2,event3,event4,purchase";
s.products = "Example category 1;Example product 1;3;12.60;event1=1.4|event2=9;eVar1=Merchandising value|eVar2=Another merchandising value,Example category 2;Example product 2;1;59.99;event3=6.99|event4=1;eVar3=Merchandising value 3|eVar4=Example value four";