事件代碼可讓您衡量 Pinterest 廣告對站內特定動作的影響。若要啟動將特定事件自動最佳化的宣傳活動 (例如轉換宣傳活動或動態重新鎖定廣告),就必須使用事件代碼。此外,您也需要使用事件代碼,才能
以下表格顯示您可透過 Pinterest 標籤追蹤的事件。您可使用這些標籤來
事件 | 目的 |
---|---|
Checkout | 追蹤完成交易的使用者。 |
AddToCart | 追蹤新增品項到購物車的使用者。 |
PageVisit | 追蹤瀏覽主頁面 (例如產品頁面或文章頁面) 的使用者。 |
Signup | 追蹤註冊產品或服務的使用者。 |
Watchvideo | 追蹤觀看影片的使用者。 |
Lead | 追蹤對產品或服務有興趣的使用者。 |
搜尋 | 追蹤在網站上搜尋特定產品或商店位置的使用者。 |
Viewcategory | 追蹤瀏覽分類頁面的使用者。 |
Custom | 追蹤自訂事件。您可使用此事件名稱來追蹤您想要加入轉換率報告的特定事件。 |
[User-defined event] | 新增您基於指定目標對象目的而定義的任何其他事件。不重複事件不會產生轉換率報告。請注意,自訂事件名稱中的空格在透過標籤傳遞時會自動遭到刪除。 |
根據所要執行的廣告宣傳活動不同,必要事件和建議事件也會有所差異,如下所示。
宣傳活動類型 | 必要事件 | 建議事件 | 必要事件資料 | 建議事件資料 |
---|---|---|---|---|
打響品牌知名度 | 無 |
|
無 | 加強比對 |
目錄銷售 |
|
|
|
|
考慮觀望 | 無 |
|
無 | 加強比對 |
轉換率 |
使用以下至少一項:
|
|
無 |
|
影片觀看次數 | 無 | 無 | 無 | 加強比對 |
根據所要使用的功能不同,必要事件和建議事件也會有所差異,如下所示。
功能 | 必要事件 | 建議事件 | 必要事件資料 | 建議事件資料 |
---|---|---|---|---|
轉換率深入分析 |
|
無 | 幣別 | 無 |
已驗證商家計畫 (VMP) |
|
無 | 幣別 | 無 |
動態重新鎖定 |
|
無 |
|
無 |
如果您決定要手動設定,請先自行將事件代碼新增到您的網站。以下步驟適用於使用手動設定選項的使用者。
- 以桌上型電腦登入您的 Pinterest 企業帳號。
- 按一下頁面左上方的
選單圖示 - 按一下「企業」下方的「轉換」。
- 按一下「開始使用」。
- 選取「「Pinterest 標籤」,然後按一下「繼續」。
- 按一下畫面底部的「略過」。
- 按一下「直接前往手動設定」。
- 複製基本代碼,然後按一下「繼續」。
- 選擇是否啟用自動加強比對,然後按一下「繼續」。
- 在要新增的事件代碼旁,按一下灰色方塊下方的「複製代碼」。
- 針對您要追蹤事件的網頁,開啟該網頁的程式碼。
- 在發生事件的頁面貼上事件代碼,並務必將範例的值改成適合您網站的值。換句話說,每當網頁載入就會觸發事件。
- 點按完成。
注意:若使用者必須在頁面上執行特定動作才會觸發事件 (例如按下按鈕或提交表單),務必確保該事件代碼只會在該動作發生後執行。也就是說,您必須瞭解頁面的 JavaScript 程式碼中現有的事件處理常式。
您可以附上包含事件資料的對象,以提供關於事件的額外資訊。所有事件資料都可用於指定目標對象,但只有「value」和「order_quantity」事件資料會提供付費和自然生成轉換率報告。
事件資料 | 值的範例 | 類型 |
---|---|---|
value | 100.00 | 數字 (整數或浮點數) |
event_id | eventId0001 |
字串 (識別個別事件的 ID 字串) 請注意:此 ID 可隨附於以下欄位名稱中傳送,且必須區分大小寫: |
order_quantity | 1 | 整數 |
order_id | 1234OrderID | 字串 (必須有 order_id 才能產生轉換率分析報告) |
product_name | Parker 靴子 | line_items 陣列、字串 |
product_id | 1414 | line_items 陣列、字串 |
product_category | 鞋子 | line_items 陣列、字串 |
product_variant_id | 1414-紅色 | line_items 陣列、字串 |
product_variant | 紅色 | line_items 陣列、字串 |
product_price | 99.99 | 數字 (整數或浮點值)、line_items 陣列、字串 |
product_quantity | 1 | 整數、line_items 陣列、字串 |
product_brand | Parker | line_items 陣列、字串 |
promo_code | WINTER10 | 字串 |
property | Athleta | 字串 |
search_query | 靴子 | 字串 |
video_title | 如何設定您的 Parker 靴子風格 | 字串 |
lead_type | 電子報 | 字串 |
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。 注意:當您在標記事件中提供幣別,系統會依據您廣告客戶帳號所使用的幣別計算匯率。 |
IMG 標籤是 Pinterest 標籤內的一段程式碼,萬一使用者停用瀏覽器的 JavaScript 時可供備用。建議您也在 IMG 標籤中加入事件資料,以達到更好的使用者目標鎖定效果。您可選擇只使用 IMG 標籤,不使用 JavaScript 標籤,但您必須從程式碼中
以下提供各事件類型的範例,您可直接複製並貼到自己的網站。請注意,務必將範例值改成網站的動態變數。
Checkout
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=checkout&ed[event_id]=YOUR_EVENT_ID&ed[value]=10.00&ed[order_quantity]=2&noscript=1" />
事件資料:event_id、value、order_quantity 和 currency
請務必為您的網站輸入正確的貨幣代碼。
AddToCart
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=AddToCart&ed[value]=10.00&ed[order_quantity]=2&noscript=1"/>
事件資料:value、order_quantity 和 currency。
務必為您的網站輸入正確的幣別代碼。
PageVisit
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=pagevisit&noscript=1"/>
事件資料:無
Signup
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=signup&noscript=1"/>
事件資料:無
Watchvideo
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=watchvideo&ed[video_title]=My+Product+Video+01&noscript=1"/>
事件資料:video_title
Lead
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=lead&ed[lead_type]=Newsletter&noscript=1"/>
事件資料:lead_type
搜尋
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=search&ed[search_query]=horse&noscript=1"/>
事件資料:search_query
Viewcategory
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=viewcategory&noscript=1"/>
事件資料:無
Custom
事件類型必須為 custom—否則廣告管理員將不會回報標籤所追蹤的轉換率。
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=custom&noscript=1"/>
事件資料:無
Value 和 order_quantity 是適用於付費和自然生成轉換率報告的兩種事件資料。如果您要加入值和數量,可以動態方式將它們傳回。動態值可根據您網站上採取的行動而變更。如果您選擇回傳 value 和 order_quantity,這就會是您的網站和您記錄銷售方式的專屬資料。產品的值和數量會通常隨著在您網站上的個別訂單而異。
<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]={{EnhancedTransaction 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',
event_id: 'eventId0001',
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 轉換標籤 ID 來替代 YOU_TAG_ID。請謹記,除了以下顯示的範例之外,您還可以根據事件加入任何事件資料組合。
此區段提供各種事件類型的範例,其格式完整可供複製,方便您直接套用到網站。每個範例都會指出開始追蹤網站活動所需的事件資料。請注意,您必須將範例值改成您網站的適當靜態值或動態變數。舉例來說,您可能會想動態追蹤訂單金額,因為每筆訂單的金額會因使用者購買的商品而有所不同。不過,如果使用者只在特定一個頁面下訂單,您就可以為事件資料 lead_type 指派靜態值。
Checkout
<script>
pintrk('track', 'checkout', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
事件資料:value、order_quantity、currency 和 event_id。
請務必為您的網站輸入正確的貨幣代碼。
AddToCart
<script>
pintrk('track', 'addtocart', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
事件資料:value、order_quantity 和 currency。
請務必為您的網站輸入正確的貨幣代碼。
PageVisit
<script>
pintrk('track', 'pagevisit', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Signup
<script>
pintrk('track', 'signup', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Watchvideo
<script>
pintrk('track', 'watchvideo', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
事件資料:Video_title
Lead
<script>
pintrk('track', 'lead', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
事件資料:lead_type
搜尋
<script>
pintrk('track', 'search', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
事件資料:search_query
Viewcategory
<script>
pintrk('track', 'viewcategory', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
使用者定義的事件
<script>
pintrk('track', 'user_defined_event_name', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Custom
事件類型必須為「custom」,否則廣告管理員不會回報標籤所追蹤的轉換事件。
<script>
pintrk('track', 'custom', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
以下是一些基本代碼結合事件代碼的範例。別忘了確保事件代碼是在基本代碼之後置放到網站上。
轉換標籤 ID 範例:123456789 (改為您的 Pinterest 轉換標籤 ID)
事件代碼範例:Pagevisit
<head>
<script type="text/javascript">
!function(e){if(!window.pintrk){window.pintrk=function(){window.pintrk.queue.push(
Array.prototype.slice.call(arguments))};var
n=window.pintrk;n.queue=[],n.version="3.0";var
t=document.createElement("script");t.async=!0,t.src=e;var
r=document.getElementsByTagName("script")[0];r.parentNode.insertBefore(t,r)}}
("https://s.pinimg.com/ct/core.js"); pintrk('load', '123456789'); pintrk('page');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&noscript=1" />
</noscript>
<script>
pintrk('track', 'pagevisit');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=pagevisit&noscript=1"/>
</noscript>
</head>
轉換標籤 ID 範例:123456789 (改為您的 Pinterest 轉換標籤 ID)
事件代碼範例:Pagevisit 和 addtocart
<head>
<script type="text/javascript">
!function(e){if(!window.pintrk){window.pintrk=function(){window.pintrk.queue.push(
Array.prototype.slice.call(arguments))};var
n=window.pintrk;n.queue=[],n.version="3.0";var
t=document.createElement("script");t.async=!0,t.src=e;var
r=document.getElementsByTagName("script")[0];r.parentNode.insertBefore(t,r)}}
("https://s.pinimg.com/ct/core.js");pintrk('load', '123456789'); pintrk('page');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&noscript=1"/>
</noscript>
<script>
pintrk('track', 'pagevisit');
pintrk('track', 'addtocart');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=pagevisit&noscript=1"/>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=addtocart&noscript=1"/>
</noscript>
</head>