新增基本代碼後,您就可以新增事件代碼,以追蹤網站上的特定轉換事件。
下表顯示您可以使用 Pinterest 標籤追蹤的事件,以及事件中是否包含和
活動 |
目的 |
目標對象建立 |
轉換率報告 |
Checkout |
追蹤完成交易的使用者 |
✔ |
✔ |
AddToCart |
追蹤新增項目到購物車的使用者 |
✔ |
✔ |
PageVisit |
追蹤瀏覽主頁面 (例如產品頁面或文章頁面) 的使用者 |
✔ |
✔ |
Signup |
追蹤註冊產品或服務的使用者 |
✔ |
✔ |
WatchVideo |
追蹤觀看影片的使用者 |
✔ |
✔ |
Lead |
追蹤對產品或服務有興趣的使用者 |
✔ |
✔ |
Search |
追蹤在網站上執行搜尋功能來尋找特定產品或商店位置的使用者 |
✔ |
✔ |
ViewCategory |
追蹤瀏覽分類頁面的使用者 |
✔ |
✔ |
Custom |
追蹤自訂事件。使用此事件名稱追蹤您想要加入轉換率報告的特定事件 |
✔ |
✔ |
[User-defined event] |
新增任何您以指定目標對象為目的而定義的額外事件。轉換率報告無法使用專屬事件。請注意,原始事件名稱中的空白字元在透過標籤傳遞時會遭到刪除 |
✔ |
版位
基本代碼和事件代碼都必須加入任何您想要追蹤轉換率的頁面。基本代碼應置放於您網站的所有頁面,而事件代碼則只需置放於您想要追蹤轉換率的頁面。基本代碼必須在事件代碼之前執行,因此請務必先置放基本代碼。
例如,如果您想追蹤成功的結帳作業,您必須在結帳確認頁面的 <head> 和 </head> 標籤之間先置放基本代碼,再置放結帳事件代碼。這種置放代碼的做法,可確保在頁面載入時便執行代碼。
另一方面,若使用者必須在頁面上採取特定行動 (例如按下按鈕或提交表格) 後才會觸發事件,那麼您應確定該事件代碼僅在行動後執行。因此您需要瞭解頁面的 JavaScript 代碼中現有事件處理常式。
事件資料
您可以附上包含事件資料的對象,以提供事件的額外資訊。
請注意,我們目前僅提供值和 order_quantity 資料的報告。任何額外的事件資料都可用於指定目標對象,但不提供給轉換率報告使用。
值應與相關貨幣代碼一併傳回。我們會使用轉換標籤中傳回的貨幣代碼以及您帳號貨幣之間的匯率,將廣告管理員轉換的值轉換為您帳號的貨幣。
事件資料 |
值的範例 |
類型 |
位置 |
目標對象建立 |
轉換率報告 |
---|---|---|---|---|---|
value |
100 |
數字 (整數或浮點數) |
頂層 |
✔ |
✔ |
order_quantity |
1 |
整數 |
頂層 |
✔ |
✔ |
product_ids | [ '1414', '1415' ] | 陣列 | 頂層 | ✔ | |
promo_code | WINTER10 | 字串 | 頂層 | ✔ | |
property | Athleta | 字串 | 頂層 | ✔ | |
search_query | 靴子 | 字串 | 頂層 | ✔ | |
video_title | 如何設定您的 Parker 靴子風格 | 字串 | 頂層 | ✔ | |
lead_type | 電子報 | 字串 | 頂層 | ✔ | |
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_price |
99.99 |
數字 (整數或浮點數) |
line_items array |
✔ |
|
product_variant |
紅色 |
字串 |
line_items array |
✔ |
|
product_quantity |
1 |
整數 |
line_items array |
✔ |
|
product_brand |
Parker |
字串 |
line_items array |
✔ |
|
currency | 美元 | AED、AMD、ARS、AUD、AZN、BAM、BGN、BHD、BMD、BND、BOB、BRL、BSD、CAD、CHF、CLP、CNY、COP、CRC、CZK、DKK、DOP、EGP、EUR、FJD、GBP、GEL、GIP、HKD、HNL、HRK、HUF、IDR、ILS、INR、ISK、JMD、JPY、KGS、KRW、KWD、KZT、MAD、MDL、MOP、MXN、MYR、NOK、NZD、OMR、PAB、PEN、PHP、PKR、PLN、QAR、RON、RSD、RUB、SAR、SEK、SGD、THB、TRY、TWD、UAH、USD、UYU、VND 或 ZAR 其中一項 | 頂層 | ✔ |
以下事件代碼範例追蹤結帳事件,其中包含描述購買兩項產品的事件資料。請注意,此範例為事件代碼的 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 確認您已正確執行標籤。