事件代码

你正从暂不支持 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

派克靴

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

派克

line_items 数组

 

promo_code

WINTER10

字符串

 

property

Athleta

字符串

 

search_query

靴子

字符串

 

video_title

如何搭配你的派克靴子

字符串

 

lead_type

新闻邮件

字符串

 
currency USD 下列之一: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 与值是静态的,但您可以选择动态传回这些值。

请参阅以下价值与数量事件数据部分,查看动态价值与数量的示例。

 

<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 标签助手来确认您是否正确添加了标签。

仍需要帮助?
联系我们