事件代碼

新增基本代碼後,您就可以新增事件代碼,以追蹤網站上的特定轉換事件。

下表顯示您可以使用 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 確認您已正確執行標籤。

仍需要協助?
請與我們聯繫