事件代碼
新增基本代碼後，您就可以新增事件代碼，以追蹤網站上的特定轉換事件。
下表顯示您可以使用 Pinterest 標籤追蹤的事件，以及事件中是否包含目標對象建立和轉換率報告。
|
活動 |
目的 |
目標對象建立 |
轉換率報告 |
|
Checkout |
追蹤完成交易的使用者 |
✔ |
✔ |
|
AddToCart |
追蹤新增項目到購物車的使用者 |
✔ |
✔ |
|
PageVisit |
追蹤瀏覽主頁面 (例如產品頁面或文章頁面) 的使用者 |
✔ |
✔ |
|
Signup |
追蹤註冊產品或服務的使用者 |
✔ |
✔ |
|
WatchVideo |
追蹤觀看影片的使用者 |
✔ |
✔ |
|
Lead |
追蹤對產品或服務有興趣的使用者 |
✔ |
✔ |
|
Search |
追蹤在網站上執行搜尋功能來尋找特定產品或商店位置的使用者 |
✔ |
✔ |
|
ViewCategory |
追蹤瀏覽分類頁面的使用者 |
✔ |
✔ |
|
Custom |
追蹤自訂事件。使用此事件名稱追蹤您想要加入轉換率報告的特定事件 |
✔ |
✔ |
|
[User-defined event] |
新增任何您以指定目標對象為目的而定義的額外事件。轉換率報告無法使用專屬事件。請注意，原始事件名稱中的空白字元在透過標籤傳遞時會遭到刪除 |
✔ |
版位
基本代碼和事件代碼都必須加入任何您想要追蹤轉換率的頁面。基本代碼應置放於您網站的所有頁面，而事件代碼則只需置放於您想要追蹤轉換率的頁面。基本代碼必須在事件代碼之前執行，因此請務必先置放基本代碼。
例如，如果您想追蹤成功的結帳作業，您必須在結帳確認頁面的 <head> 和 </head> 標籤之間先置放基本代碼，再置放結帳事件代碼。這種置放代碼的做法，可確保在頁面載入時便執行代碼。
另一方面，若使用者必須在頁面上採取特定行動 (例如按下按鈕或提交表格) 後才會觸發事件，那麼您應確定該事件代碼僅在行動後執行。因此您需要瞭解頁面的 JavaScript 代碼中現有事件處理常式。
事件資料
您可以附上包含事件資料的對象，以提供事件的額外資訊。
請注意，我們目前僅提供值和 order_quantity 資料的報告。任何額外的事件資料都可用於指定目標對象，但不提供給轉換率報告使用。
值應與相關貨幣代碼一併傳回。我們會使用轉換標籤中傳回的貨幣代碼以及您帳號貨幣之間的匯率，將廣告管理員轉換的值轉換為您帳號的貨幣。
|
事件資料 |
值的範例 |
類型 |
目標對象建立 |
轉換率報告 |
|
value |
100.00 |
數字 (整數或浮點數) |
✔ |
✔ |
|
order_quantity |
1 |
整數 |
✔ |
✔ |
|
currency |
美元 |
下列其中之一：美元、英鎊、加元、歐元、澳元、紐元 |
✔ |
|
|
product_name |
Parker 靴子 |
line_items array |
✔ |
|
|
product_id |
1414 |
line_items array |
✔ |
|
|
product_category |
鞋子 |
line_items array |
✔ |
|
|
product_variant_id |
1414-紅色 |
line_items array |
✔ |
|
|
product_variant |
紅色 |
line_items array |
✔ |
|
|
product_price |
99.99 |
數字 (整數或浮點數)、line_items array |
✔ |
|
|
product_quantity |
1 |
整數，line_items array |
✔ |
|
|
product_brand |
Parker |
line_items array |
✔ |
|
|
promo_code |
WINTER10 |
字串 |
✔ |
|
|
property |
Athleta |
字串 |
✔ |
|
|
search_query |
靴子 |
字串 |
✔ |
|
|
video_title |
如何設定您的 Parker 靴子風格 |
字串 |
✔ |
|
|
lead_type |
電子報 |
字串 |
✔ |
以下事件代碼範例追蹤結帳事件，其中包含描述購買兩項產品的事件資料。請注意，此範例為事件代碼的 JavaScript 部分。在此範例中，order_quantity 和 value 為靜態，但您可以選擇動態回傳這些值。
請參閱以下的值和數量事件資料版面，以瞭解動態值和數量的範例。
<script>
pintrk('track', 'checkout', {
value: 10.00,
order_quantity: 2,
currency: 'USD',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_price: 5.00,
product_quantity: 1
},
{
product_name: 'Parker Sandals',
product_id: 'ABC',
product_price: 5.00,
product_quantity: 1
}
]
});
</script>值和數量事件資料
值和訂單數量是轉換率報告提供的兩種事件資料。如果您想新增值和數量，可以使用靜態值或動態傳回。如果您想按照推薦方式動態傳回值和數量，這會隨您的網站以及記錄銷售的方式而有所不同。通常來說，產品的值和數量會隨著在您網站上的個別訂單而異。因此，若要準確追蹤銷售總值，我們建議使用動態變數來追蹤轉換標籤中的數量和值。
硬式編碼值和數量範例：
<script>
pintrk('track', 'checkout', {
value: 10.00, // Read this value (must be a number)
order_quantity: 5 // Read this quantity (must be an integer)
});
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=checkout&ed[value]=10.00&ed[order_quantity]=5&noscript=1"/>
</noscript>報告的值：10.00
檢舉的數量：5
動態值和數量範例：
<script>
pintrk('track', 'checkout', {
value: {{Enhanced Transaction Revenue}},
order_quantity: {{item.quantity}}
});
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=checkout&ed[value]={{Enhanced Transaction Revenue}}&ed[order_quantity]={{item.quantity}}&noscript=1" />
</noscript>報告的值：動態購買金額和對應的結帳資料
檢舉的數量：使用對應結帳購買的動態數量
請注意，動態訂單數量和值的設定步驟為您的網站專屬。
回呼
除了事件資料以外，您可以傳送 JavaScript 回呼函式，作為函式 pintrk() 的選項引數。此回呼函式會在每次事件追蹤呼叫 (函式 pintrk()) 觸發時執行。
回呼函式會採用下列兩種引數：
function(didInit, error) {}-
didInit：第一個引數會接收布林值，若事件追蹤呼叫已成功建構，則值為 True；若執行事件追蹤呼叫時偵測到錯誤，則值為 False。
-
error：第二個引數會接收字串，若 didInit 傳回 False，則該字串會描述此錯誤；若 didInit 傳回 True，則此字串尚未定義。
範例
<script>
pintrk('track', 'checkout', {
value: 10.00,
order_quantity: 2,
currency: 'USD',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_price: 5.00,
product_quantity: 1
},
{
product_name: 'Parker Sandals'
product_id: 'ABC',
product_price: 5.00,
product_quantity: 1
}
]
}, function(didInit, error) { if (!didInit) { console.log(error); }
});
</script>下一步
您可以在此檢視更多範例。新增基本和事件代碼後，您可以使用 pinterest tag helper 確認您已正確執行標籤。