事件代碼
新增基本代碼後，您就可以新增事件代碼，以追蹤網站上的特定轉換率事件。
下表顯示您可以使用 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-Red |
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>