製作購買明細報表

產生購買明細變數的內容

下一個: 在 Floodlight 代碼或事件程式碼片段中新增購買明細變數

購買明細變數可提供特定交易中售出產品的相關資訊。您可以將這個變數加入 Floodlight 事件程式碼片段、Floodlight 代碼、Google 代碼管理工具資料層或 Google 代碼管理工具巨集。

請根據加入變數的方式，採用下列其中一種格式：

如果您使用的是 Google 代碼，請直接在 Floodlight 事件程式碼片段中將購買明細變數的格式設為 JSON 物件。
假如您使用的是 Floodlight iframe 或圖片代碼，或是想把資料以巨集形式傳送至 Google 代碼管理工具，則可將購買明細變數的格式設為細分成一組欄位的字串。
如果您想將資料推送至 Google 代碼管理工具的資料層，請將變數的格式設為內含購買明細欄位的 JSON 物件。

Floodlight 事件程式碼片段中的 JSON 格式相關規定

如果您使用 Google 代碼，應在事件程式碼片段中將購買明細指定為 JSON items 陣列，並加上 country 和 language 欄位。陣列中的每個項目包含以下欄位：

id
price
quantity

例如：

<script> gtag('event', 'purchase', { 'allow_custom_scripts': true, 'send_to': 'DC-1234567/group1/thank123+transactions', 'transaction_id': '012345', 'value': 129.97, 'items': [ { 'id': '123456755559', 'price': '19.99', 'quantity': 1 }, { 'id': '123456788889', 'price': '54.00', 'quantity': 2 } ], 'country': 'us', 'language': 'en' } ); </script> <noscript> <img src="https://ad.doubleclick.net/ddm/activity/src=1234567;type=group1;cat=thank123; qty=1;cost=129.97;dc_lat=;dc_rdid=;tag_for_child_directed_treatment=;tfua=;npa=; ord=012345;prd=i1:123456755559|p1:19.99|q1:1|i2:123456788889|p2:54.0|q2:2|c:us|l:en?" width="1" height="1" alt=""> </noscript>

注意：Search Ads 360 產生的事件程式碼均包括一個內含 Floodlight 圖片代碼的選用 <noscript> 代碼。系統會使用這個代碼，回報在不支援 JavaScript 的瀏覽器中所發生的轉換。

資料層中的 JSON 格式相關規定

如果您使用 Google 代碼管理工具，應將購買明細欄位指定為 JSON ecommerce.purchase.products 陣列中的元素：

'ecommerce':{ 'purchase':{ 'products': [{ 'id': 'String', 'price': 'Floating point', 'quantity': Integer, 'country': 'String', // Optional 'language': 'String', // Optional 'accountId': 'String' // Optional }, { … // Each SKU (product) in the transaction // is in its own array item. }] } }'

請注意，假如您要在 Floodlight 事件程式碼片段中加入購買明細變數，則此 JSON 物件的欄位名稱與您所用的 JSON 物件不同。

當您將購買明細推送至資料層時，實際上就是將資料儲存在 Google Analytics (分析) 用來製作產品報表的相同物件中，而且這些產品曾在您的網站上售出。也就是說，假如您同時使用 Search Ads 360 和 Google Analytics (分析) 製作購買明細報表，您的網頁開發人員可使用相同物件來儲存這兩項產品的資料。

字串格式的相關規定

在字串格式中，應以鍵/值組合形式指定購買明細欄位，格式如下：
[欄位 ID][索引]:[值]

[欄位 ID]：用於識別所回報的值類型。
[索引]：表示所回報的值屬於哪一個項目。
[值]：提供產品銷售相關資訊。

請以豎線符號 (「|」) 分隔各個欄位。例如：
i1:123456755559|p1:19.99|q1:1|i2:123456788889|p2:54.0|q2:2

購買明細欄位

欄位	字串格式的 ID	類型	是否為必填	說明
`ID`	`i`	字串	是	售出產品的 ID。這個編號必須與來自 Google Merchant Center 的項目編號相符。
`PRICE`	`p`	浮點值	是	售出產品的單價。請勿加上貨幣符號。
`QUANTITY`	`q`	整數	是	售出產品的數量。
`COUNTRY`	`c`	字串 (ISO 3166 國家/地區代碼)	否	為內含產品相關資料的 Merchant Center 動態饋給註冊的國家/地區。只有在多個 Merchant Center 動態饋給中重複使用項目 ID 時，才需要這個欄位。每項產品只需指定一次國家/地區 (這不是重複欄位)。如果未指定這個欄位，Search Ads 360 會選擇內含產品 ID 的 Merchant Center 動態饋給，並採用該動態饋給的屬性做為售出產品維度。
`LANGUAGE`	`l`	字串 (ISO 639 語言代碼)	否	為內含產品相關資料的 Merchant Center 動態饋給註冊的語言。只有在多個 Merchant Center 動態饋給中重複使用項目 ID 時，才需要這個欄位。如果未指定這個欄位，Search Ads 360 會選擇內含產品 ID 的 Merchant Center 動態饋給，並採用該動態饋給的屬性做為售出產品維度。

特殊字元與網址編碼

字串格式會使用「:」(冒號) 和「|」(豎線符號) 做為欄位分隔符號。即使您使用其中一種 JSON 格式，Search Ads 360 也無法接受欄位值含有這些字元的資料。

與所有 Floodlight 資料的處理方式相同，系統也不支援下列字元：

;、<、>、?

涉及多項產品的購買範例

假設某筆交易涉及下列項目：

項目 1
- 名稱：m-dress-orange-xl
- UPC：123456755559
- 項目單價：$19.99
- 數量：1
項目 2
- 名稱：m-polo-green-l
- UPC：123456788889
- 項目單價：$54
- 數量：2

事件程式碼片段中的購買明細變數會包含以下欄位：

'items': [ { 'id': '123456755559', 'price': '19.99', 'quantity': 1 }, { 'id': '123456788889', 'price': '54.00', 'quantity': 2 } ]

Floodlight iframe 代碼中購買明細變數的樣式如下：
i1:123456755559|p1:19.99|q1:1|i2:123456788889|p2:54.0|q2:2

除了購買明細變數之外，Floodlight 代碼或事件程式碼片段還會指定下列資料：

Floodlight 活動群組的 ID
Floodlight 活動的 ID
交易 ID (訂單 ID)
交易的總價值：$129.97 = (1*$19.99 + 2*$54)
數量：3 (您可定義此欄位的確切含義；建議您使用此欄位回報購物車中的項目總數)。
任何其他 Floodlight 自訂變數

包含事件程式碼片段的全域網站代碼最終可能如下所示：
  <script async src="https://www.googletagmanager.com/gtag/js?id=DC-1234567"></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments)}; gtag('js', new Date()); gtag('config', 'DC-1234567'); </script> 

下方範例是內含購買明細變數的 Floodlight iframe 代碼：

含有國家/地區和語言代碼的範例

您可以使用 Merchant Center，透過多個動態饋給提交產品，並替每個動態饋給指定特定語言和國家/地區。舉例來說，假如您在美加地區販售同一組產品，就可以針對美國地區適用的價格和說明設定一個動態饋給，針對加拿大地區適用的價格和說明以法文設定另一個動態饋給，再針對加拿大地區適用的價格和說明以英文設定第三個動態饋給。

提交含有相同產品 ID 但不同指定語言或國家/地區的多個動態饋給時，您需要在購買明細變數中加入語言代碼和國家/地區代碼。舉例來說，以下事件程式碼片段中的 items 陣列以及 country 和 language 欄位所記錄的購買活動是來自指定法裔加拿大人的動態饋給：

'items': [ { 'id': '123456788889', 'price': '19.99', 'quantity': 1 }, { 'id': '123456755559', 'price': '54.00', 'quantity': 2 } ], 'country': 'ca', 'language': 'fr'

請務必使用兩位數的 ISO 國家/地區代碼和語言代碼。

這對您有幫助嗎？

我們應如何改進呢？