你正从暂不支持 Pinterest 标签功能的地区查看此内容。查看哪些地区的 Pinterest Business 帐户支持 Pinterest 标签功能。 了解更多

通过事件代码,你可以衡量 Pinterest 广告对网站上特定行为的影响。发布能自动优化特定事件的推广计划(例如转化推广计划或动态重新定位广告)时,也需要事件代码。此外,你还需要事件代码才能访问转化分析信息加入经过验证的商家计划

添加基本代码后,你就可以添加事件代码来跟踪网站上的特定转化。基本代码必须置于你网站的每个页面中,事件代码则只需置于你要跟踪特定转化的页面中。投放不同的广告推广计划并使用特定功能需要不同的事件代码。

事件代码类型

下表显示了你可以使用 Pinterest 标签跟踪的事件。你可以使用 Pinterest 标签创建广告定位受众,同时你可以在广告管理工具中查看相关的付费和自然转化报告。注意:报告不适用于用户定义的事件。

事件 目的
结账 跟踪完成交易的用户。
AddToCart 跟踪将商品放入购物车的用户。
网页访问 跟踪查看主要页面(如产品页面和文章页面)的用户。
Signup 跟踪注册你的产品或服务的用户。
WatchVideo 跟踪观看视频的用户。
Lead 跟踪对你的产品或服务感兴趣的用户。
搜索 跟踪在你的网站上搜索特定产品或实体店位置的用户。
ViewCategory 跟踪查看类别页面的用户。
Custom 跟踪自定义事件。使用此事件名来跟踪你想包括在转换报告中的特殊事件。
[User-defined event] 添加你出于受众定位目的而定义的任何其他事件。独有的事件不适用于转化报告。请注意,自定义事件名称中的任何空格通过标签传递时会被自动移除。
广告推广计划的必需和推荐事件

根据你决定投放的广告推广计划,有必需事件和推荐事件。

推广计划类型 必需事件 推荐事件 必需事件数据 推荐事件数据
品牌认知度
  • 网页访问
  • Checkout
  • AddToCart
  • Lead
  • Signup
增强匹配
目录销售
  • 网页访问
  • AddToCart
  • Checkout
  • Signup
  • Lead
  • 产品 ID
  • 订单编号
  • Value
  • 货币(添加到购物车和结账时必填)
  • 产品类别
  • 增强匹配
钟意程度
  • 网页访问
  • Checkout
  • AddToCart
  • Lead
  • Signup
增强匹配
转化

至少以下事件之一:

  • Signup
  • Lead
  • AddToCart
  • Checkout
  • 产品 ID
  • 订单编号
  • Value
  • 增强匹配
  • 产品类别
  • 货币
  • 增强匹配
视频播放量 增强匹配
功能的必需和推荐事件

根据你要使用的功能,有必需事件和推荐事件。

功能 必需事件 推荐事件 必需事件数据 推荐事件数据
转化分析
  • 网页访问
  • AddToCart
  • Checkout
货币
经过验证的商家计划 (VMP)
  • 网页访问
  • AddToCart
  • Checkout
货币
动态重新定位
  • 网页访问
  • AddToCart
  • Checkout
  • 产品 ID
  • Value
  • 货币
将事件代码添加到你的网站中

如果你决定手动设置,则必须自行将事件代码添加到你的网站。使用手动设置选项的用户可以按以下步骤操作。

  1. 从电脑端登录 Pinterest 企业帐户
  2. 点击页面左上角的 汉堡图标
  3. 企业下,点击转化
  4. 点击开始
  5. 选择仅限 Pinterest 标签,然后点击继续
  6. 点击屏幕右下角的跳过
  7. 点击跳至手动设置
  8. 复制基本代码,然后点击继续
  9. 选择是否启用自动增强匹配,然后点击继续
  10. 在灰色框下方,点击你要添加的事件代码旁边的复制代码
  11. 打开你要跟踪事件的网站页面的代码。
  12. 将事件代码粘贴到应该发生事件的页面上(请务必将示例值替换为适合你网站的值)。如此一来,只要加载该页面就会触发相应事件。
  13. 点击完成

注意:如果某个事件仅当用户在页面上执行特定操作(例如点击按钮或提交表单)后才会触发,请确保事件代码仅在此操作后运行。这需要了解页面 JavaScript 代码中的现有事件处理程序。

添加事件数据

你可以通过附加包含事件数据的对象来提供关于某一事件的额外信息。所有事件数据均适用于受众定位,但仅价值和 order_quantity 事件数据适用于付费和自然转化报告。

事件数据 样本价值 类型
value 100.00 数字(整数或浮点)
event_id eventId0001

字符串(唯一标识事件的 id 字符串)

注意:此 id 可在以下任何字段名称下发送,并且全部区分大小写:

  • eventID
  • event_id
  • eid
  • order_quantity 1 整数
    order_id 1234OrderID 字符串(转化分析报告要求 order_id)
    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 字符串
    属性 Athleta 字符串
    search_query 靴子 字符串
    video_title 如何搭配你的派克靴子 字符串
    lead_type 新闻邮件 字符串
    货币 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。

    注意:当你通过标签事件提供货币时,我们将计算汇率以匹配你的广告主帐户货币。

    在 IMG 标签中包含事件数据

    IMG 标签是 Pinterest 标签中的一段代码,可作为备份,以防用户在其浏览器中禁用了 JavaScript。我们建议你在 IMG 标签中也添加事件数据,这样可以更好地进行用户定位。你可以选择仅使用 IMG 标签,而不使用 JavaScript 标签,但必须从代码中移除 <noscript> 标签

    下面提供了各个事件类型的示例,以便你直接将其复制粘贴到你的网站上。请注意,你必须将示例中的值替换为适用于你网站的动态变量

    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。

    请务必为你的网站输入正确的货币代码

    网页访问

     <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

    事件类型必须自定义调回—否则广告管理工具不会报告标签追踪的转化。

     <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=custom&noscript=1"/>

    事件数据:

    动态传递价值和 order_quantity 事件数据

    价值和 order_quantity 是适用于付费和自然转化报告的两个事件数据。如需添加价值和数量,你可以将其动态传回。动态价值可以根据用户在你网站上进行的操作而变化。如果你选择传回价值和 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 回调函数

    除事件数据之外,你还可以传回 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>
    事件代码示例

    对于转化跟踪和报告,你必须在事件代码中指定 9 项事件类型中的其中一项。此外,你必须将 YOUR_TAG_ID 替换为你的 Pinterest 转化标签 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。

    请确保根据你的网站输入正确的货币代码。

    网页访问

    <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

    事件类型必须为自定义,否则广告管理工具不会报告标签跟踪的转化。

    <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>
    下一步是什么?

    验证 Pinterest 标签以确保一切正常。

    End of Other articles Links
    仍需要帮助? 联系我们
    User feedback
    本文对您有帮助吗?

    collection_fields

    我们可以如何优化本文?