事件代碼

您似乎在未提供 Pinterest 標籤的地區瀏覽此內容。 請查看可供 Pinterest Business 帳號使用 Pinterest 標籤的地區。

瞭解詳情

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

下表顯示您可以使用 Pinterest 標籤追蹤的事件,以及事件中是否包含

活動

目的

目標對象建立

轉換率報告

Checkout

追蹤完成交易的使用者

AddToCart

追蹤新增項目到購物車的使用者

PageVisit

追蹤瀏覽主頁面 (例如產品頁面或文章頁面) 的使用者

Signup

追蹤註冊產品或服務的使用者

WatchVideo

追蹤觀看影片的使用者

Lead

追蹤對產品或服務有興趣的使用者

Search

追蹤在網站上執行搜尋功能來尋找特定產品或商店位置的使用者

ViewCategory

追蹤瀏覽分類頁面的使用者

Custom

追蹤自訂事件。使用此事件名稱追蹤您想要加入轉換率報告的特定事件

[User-defined event]

新增任何您以指定目標對象為目的而定義的額外事件。轉換率報告無法使用專屬事件。請注意,原始事件名稱中的空白字元在透過標籤傳遞時會遭到刪除

 

版位

基本代碼和事件代碼都必須加入任何您想要追蹤轉換率的頁面。基本代碼應置放於您網站的所有頁面,而事件代碼則只需置放於您想要追蹤轉換率的頁面。基本代碼必須在事件代碼之前執行,因此請務必先置放基本代碼。

例如,如果您想追蹤成功的結帳作業,您必須在結帳確認頁面的 <head> 和 </head> 標籤之間先置放基本代碼,再置放結帳事件代碼。這種置放代碼的做法,可確保在頁面載入時便執行代碼。

另一方面,若使用者必須在頁面上採取特定行動 (例如按下按鈕或提交表格) 後才會觸發事件,那麼您應確定該事件代碼僅在行動後執行。因此您需要瞭解頁面的 JavaScript 代碼中現有事件處理常式。

事件資料

您可以附上包含事件資料的對象,以提供事件的額外資訊。

請注意,我們目前僅提供值和 order_quantity 資料的報告。任何額外的事件資料都可用於指定目標對象,但不提供給轉換率報告使用。

值應與相關貨幣代碼一併傳回。我們會使用轉換標籤中傳回的貨幣代碼以及您帳號貨幣之間的匯率,將廣告管理員轉換的值轉換為您帳號的貨幣。

事件資料

值的範例

類型

目標對象建立

轉換率報告

value

100.00

數字 (整數或浮點數)

order_quantity

1

整數

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

電子報

字串

 
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 確認您已正確執行標籤。

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