动态再营销参数

gtag.js 提供了一个灵活的数据模型,让您在调用 event 命令时可以提供标准数据参数,也可以提供自定义数据参数。

在定义用户列表成员资格规则时,既可以使用标准参数,也可以使用自定义参数。此外,AdWords 也会使用标准参数,根据用户在以前访问您的网站期间互动过的具体商品或服务来动态调整向他们展示的广告内容。这些参数还为我们的出价优化算法提供了重要的参考依据。

有关如何将参数作为事件数据对象的一部分进行传递的一般说明,请参阅此文档

本文档包含根据网站业务类型推荐的标准参数的完整列表。

零售网站

以下参数适用于在自己网站上销售商品并使用 Google Merchant Center (GMC) Feed 的典型在线零售商,例如服装零售商、电子商品零售商或食品杂货零售商。

参数 说明
ecomm_prodid 必选。这是当前页面上所示商品的商品 ID - 此处使用的 ID 应与 GMC Feed 中的 ID 匹配。

ecomm_pagetypeproductcart 时,应该传递此参数。在 product 页面上,通常只显示单个商品,因此仅需传递单个字面值;在 cart 页面上,如果存在多个商品(即用户购物车中的商品在一个以上),则会传递一组值。

数字值和字母数字值均受支持,例如 34592212'23423-131-12''gp232123-19a'。请注意,如果您的商品 ID 不是数字,则需将其当作字符串处理,并用引号引起来。

在包含单个商品的页面上的用法示例:

gtag('event', event_name, {
  ecomm_prodid: 34592212
});
在包含多个商品的购物车页面上的用法示例:

gtag('event', event_name, {
  ecomm_prodid: [34592212, '23423-131-12', 'gp232123-19a']
});
ecomm_pagetype 表示代码所在页面的类型。有效值:
  • home 表示代码在您网站的首页或着陆页上使用。
  • searchresults 表示代码在显示用户搜索结果的页面上使用。
  • category 表示代码在列出同属于一个类别的多个商品的页面上使用,例如显示给定款式所有鞋子的页面。
  • product 表示代码在包含单个商品的页面上使用。
  • cart 表示代码在购物车/购物篮/结帐页面上使用。
  • purchase 表示代码在用户出手购买(因而也完成了转化)后随即显示的页面(例如致谢页或确认页)上使用。
  • other 表示代码在不属于以上各种页面类型的页面(例如“联系我们”或“关于我们”页面)上使用。
用法示例:

gtag('event', event_name, {
  ecomm_pagetype: 'searchresults'
});
ecomm_totalvalue 此参数应在 productcartpurchase 类型的页面上使用,应包含 product 页面上单个商品的价值或 cartpurchase 页面上一个或多个商品的价值总和。该值应该作为 javascript Number 传递,不应包含任何货币符号。

例如,如果 product 页面上一件商品价值 9.99 美元,用法如下:

gtag('event', event_name, {
  ecomm_totalvalue: 9.99
});
如果 cartpurchase 页面上的用户购物车中包含 3 件价值分别为 29.99 美元、50 美元和 9.99 美元的商品,则用法示例如下:

gtag('event', event_name, {
  ecomm_totalvalue: 89.98
});
在适当的情况下应提供小数值。当传递整数值时,完全可以忽略小数部分。

例如,如果购物篮中的商品价值总计为 110.00 美元,用法如下:

gtag('event', event_name, {
  ecomm_totalvalue: 110
});
ecomm_category 该参数包含一个字符串,用于指定当前查看的 productcategory 页面的类别。该字符串可以是任何值,并且不需要遵守任何特定命名惯例。

以“家庭与园艺”类别中的商品为例,用法如下

gtag('event', event_name, {
  ecomm_category: 'Home & Garden'
});

以上所有参数都可以根据需要组合起来使用,并可以与您的业务所需的任何其他自定义参数混搭使用。

如果一个商品使用自定义参数“isSaleItem”来表示该商品是否在售,则可参考如下完整代码示例。

gtag('event', 'page_view', {
  ecomm_pagetype: 'product',
  ecomm_prodid: 34592212,
  ecomm_totalvalue: 29.99,
  ecomm_category: 'Home & Garden',
  isSaleItem: false
});

购物车页面自定义参数的示例如下:

gtag('event', 'page_view', {
  ecomm_pagetype: 'cart',
  ecomm_prodid: [34592212, '23423-131-12'],
  ecomm_totalvalue: 57.98,
});

酒店网站(使用酒店价格广告 Feed)

以下参数适用于使用酒店价格广告 (HPA) Feed 销售酒店客房的旅游网站。HPA Feed 并不是在 AdWords 商家数据的共享库中配置的。如果您的 Feed 是在 AdWords 商家数据的共享库中配置的,则说明您使用的不是 HPA,您需要使用“酒店及房屋租赁网站”一节中介绍的参数。

<tr>
  <td><code>hotel_checkindate</code></td>
  <td>The date when the booking is to begin from. Note that this should be in the YYYY-MM-DD
    format.<br><br>Example usage:
    <pre class="prettyprint">gtag('event', event_name, {

hotel_checkindate: '2014-04-20' });

参数 说明
hotel_hotelid 必选。此参数是用户当前在 property 类型的网页中查看的酒店或客房的 ID。此 ID 必须与 HPA Feed 中“hotel_hotelid”中的值匹配,可以是数字或字母数字。

用法示例:

gtag('event', event_name, {
  hotel_hotelid: 'gb197'
});
hotel_pagetype 表示代码所在页面的类型。有效值:
  • home 表示代码在您网站的首页或着陆页上使用。
  • searchresults 表示代码在显示用户搜索结果的页面上使用。
  • property 表示代码在显示酒店或其他客房的详细信息的页面上使用。
  • cart 表示代码在购物车/购物篮/结帐页面上使用。
  • purchase 表示代码在用户出手购买(因而也完成了转化)后随即显示的页面(例如致谢页或确认页)上使用。
  • cancel 表示代码在用户取消预订的页面上使用。
  • other 表示代码在不属于以上各种页面类型的页面(例如“联系我们”或“关于我们”页面)上使用。
用法示例:

gtag('event', event_name, {
  hotel_pagetype: 'property'
});
hotel_checkoutdate 预订结束的日期。请注意,应采用 YYYY-MM-DD 格式。

用法示例:

gtag('event', event_name, {
  hotel_checkoutdate: '2014-04-21'
});
hotel_totalvalue 此参数应在 cartpurchase 类型的页面中使用,应包含用户购物车中所有客房的价值总和。其中不应包含任何货币符号。

以预订总额为 150 美元的情况为例,用法如下:

gtag('event', event_name, {
  hotel_pagetpe: 'purchase',
  hotel_hotelid: 'gb197',
  hotel_totalvalue: 150
});

以预订总额为 150 美元的情况为例,用法如下:

gtag('event', 'page_view', {
  hotel_pagetpe: 'purchase',
  hotel_hotelid: 'gb197',
  hotel_totalvalue: 150
});

教育网站

以下参数适用于在线销售培训课程的网站,例如使用相应 Feed 的大学或终身学习服务机构。如果您在设置教育 Feed 时需要帮助,请联系您的 Google 客户服务代表,他们可以提供帮助。

参数 说明
edu_pid 必选。此参数是用户当前在 programlead 类型的网页上查看的计划的 ID。此 ID 必须与 Feed 中“教育计划”的值匹配,可以是数字或字母数字。

用法示例:

gtag('event', event_name, {
  edu_pid: 'cs101'
});
edu_plocid 此参数是用户当前在 programlead 类型的网页上查看的计划的位置 ID。此 ID 必须与 Feed 中“地理位置 ID”的值匹配,可以是数字或字母数字。

用法示例:

gtag('event', event_name, {
  edu_plocid: 'london_campus'
});
edu_pagetype 表示代码所在页面的类型。有效值:
  • home 表示代码在您网站的首页或着陆页上使用。
  • searchresults 表示代码在显示用户搜索结果的页面上使用。
  • program 表示代码在显示单个课程或计划的详细信息的页面上使用。
  • lead 表示代码在潜在客户挖掘页面上使用,例如用户可以表达兴趣或请求更多信息的页面。
  • complete 表示代码在用户出手购买(因而也完成了转化)后随即显示的页面(例如致谢页或确认页)上使用。
  • other 表示代码在不属于以上各种页面类型的页面(例如“联系我们”或“关于我们”页面)上使用。
用法示例:

gtag('event', event_name, {
  edu_pagetype: 'program'
});

以上所有参数都可以根据需要组合起来使用,并可以与您的业务所需的任何其他自定义参数混搭使用。

以包含单个计划的页面为例,完整代码如下所示:

gtag('event', 'page_view', {
  edu_pagetype: 'program',
  edu_pid: 'cs101',
  edu_plocid: 'london_campus'
});

航班网站

以下参数适用于使用相应 Feed 销售航班的旅游网站。如果您在设置航班 Feed 时需要帮助,请联系您的 Google 客户服务代表,他们可以提供帮助。

参数 说明
flight_originid 此参数是用户在 searchresultscartpurchase 类型的页面上所查看的航班行程的出发地。此 ID 必须与 Feed 中的值匹配,可以是数字或字母数字,但我们建议使用三字母的机场代码。

用法示例:

gtag('event', event_name, {
  flight_originid: 'LHR'
});
flight_destid 必选。此参数是用户在 searchresultscartpurchase 类型的页面上所查看的航班行程的目的地。此 ID 必须与 Feed 中的值匹配,可以是数字或字母数字,但我们建议使用三字母的机场代码。

用法示例:

gtag('event', event_name, {
  flight_destid: 'LGA'
});
flight_pagetype 表示代码所在页面的类型。有效值:
  • home 表示代码在您网站的首页或着陆页上使用。
  • searchresults 表示代码在显示用户搜索结果的页面上使用。
  • offerdetail 表示代码在显示航班详细信息的页面上使用。
  • cart 表示代码在购物车/购物篮/结帐页面上使用。
  • purchase 表示代码在用户出手购买(因而也完成了转化)后随即显示的页面(例如致谢页或确认页)上使用。
  • cancel 表示代码在用户取消预订的页面上使用。
  • other 表示代码在不属于以上各种页面类型的页面(例如“联系我们”或“关于我们”页面)上使用。
用法示例:

gtag('event', event_name, {
  flight_pagetype: 'cart'
});
flight_totalvalue 此参数应在 cartpurchase 类型的页面上使用,应包含航班行程的价值总和。其中不应包含任何货币符号。

例如,在预订总额为 150 美元的情况下,用法如下:

gtag('event', event_name, {
  flight_totalvalue: 150
});
flight_startdate 航班行程开始日期。请注意,应采用 YYYY-MM-DD 格式。

用法示例:

gtag('event', event_name, {
  flight_startdate: '2014-04-20'
});
flight_enddate 航班行程结束日期。请注意,应采用 YYYY-MM-DD 格式。

用法示例:

gtag('event', event_name, {
  flight_enddate: '2014-04-21'
});

以上所有参数都可以根据需要组合起来使用,并可以与您的业务所需的任何其他自定义参数混搭使用。

以伦敦 (LHR) 到纽约 (LGA) 航班行程的购物车页面为例,完整代码如下:

gtag('event', 'page_view', {
  flight_originid: 'LHR',
  flight_destid: 'LGA',
  flight_startdate: '2014-04-20',
  flight_enddate: '2014-04-21',
  flight_pagetype: 'cart',
  flight_totalvalue: 679.34
});

酒店及房屋租赁网站

以下参数适用于使用在 AdWords 商家数据共享库中配置的 Feed 推广酒店和租赁房屋的旅游网站。如果您的酒店 Feed 不是在 AdWords 商家数据的共享库中配置的,则说明您使用的可能是酒店价格广告 Feed,因此您应使用“酒店网站(使用酒店价格广告 Feed)”一节中介绍的参数。

<tr>
  <td><code>hrental_startdate</code></td>
  <td>The date when the booking is to begin from. Note that this should be in the YYYY-MM-DD
    format.<br><br>Example usage:
    <pre class="prettyprint">gtag('event', event_name, {

hrental_startdate: '2014-04-20' });

参数 说明
hrental_id 必选。此参数是用户当前在 property 类型的页面中查看的酒店或出租房产的 ID。此 ID 必须与 Feed 中“hrental_id”的值匹配,可以是数字或字母数字。

用法示例:

gtag('event', event_name, {
  hrental_id: 'h213146'
});
hrental_pagetype 表示代码所在页面的类型。有效值:
  • home 表示代码在您网站的首页或着陆页上使用。
  • searchresults 表示代码在显示用户搜索结果的页面上使用。
  • offerdetail 表示代码在显示酒店或其他客房的详细信息的页面上使用。
  • conversionintent 表示代码在购物车/购物篮/结帐页面上使用。
  • conversion 表示代码在用户出手购买(因而也完成了转化)后随即显示的页面(例如致谢页或确认页)上使用。
  • other 表示代码在不属于以上各种页面类型的页面(例如“联系我们”或“关于我们”页面)上使用。
用法示例:

gtag('event', event_name, {
  hrental_pagetype: 'offerdetail'
});
hrental_enddate 预订结束的日期。请注意,应采用 YYYY-MM-DD 格式。

用法示例:

gtag('event', event_name, {
  hrental_enddate: '2014-04-21'
});
hrental_totalvalue 此参数适用于 conversionintentconversion 页面类型,应包含用户购物车中所有住房的价值总和。其中不应包含任何货币符号。

例如,预订总额为 650 美元时,用法如下:

gtag('event', event_name, {
  hrental_pagetpe: 'conversion',
  hrental_id: 'h213146',
  hrental_totalvalue: 650
});

预订总额为 650 美元时,用法如下:

gtag('event', 'page_view', {
  hrental_pagetpe: 'conversion',
  hrental_id: 'h213146',
  hrental_totalvalue: 650
});

求职招聘网站

以下参数适用于使用相应 Feed 发布招聘信息广告的网站。

参数 说明
job_id 必选。这个必需参数是用户在 searchresultsofferdetailconversionintentconversion 类型的页面上查看的职位空缺的 ID。此 ID 必须与 Feed 中的值匹配,可以是数字或字母数字。在只有一个职位 ID 的情况下(例如在 offerdetail 页面上),用法如下:

gtag('event', event_name, {
  job_id: 'GOOGUK2341'
});
在需要提供多个职位 ID 的情况下(例如,在 searchresults 页面上),用法如下:

gtag('event', event_name, {
  job_id: ['GOOGUK2341', 'GOOGUK12331', 'GOOGUK-L12']
});
job_locid 该参数表示位置 ID 或位置名称,在 Feed 中用于辅助匹配键,允许使用多个具有相同值的 job_id,但应分别使用不同的位置 ID。适用于 searchresultsofferdetailconversionintentconversion 页面类型。用法示例:

gtag('event', event_name, {
  job_locid: 'UK-LON'
});
job_pagetype 表示代码所在页面的类型。有效值:
  • home 表示代码在您网站的首页或着陆页上使用。
  • searchresults 表示代码在显示用户搜索结果的页面上使用。
  • offerdetail 表示代码在显示单个职位空缺详细信息的页面上使用。
  • conversionintent 表示代码在购物车/购物篮/结帐页面上使用。
  • conversion 表示代码在用户完成转化后随即显示的页面上使用。对于职位列表而言,这可能是用户申请职位的页面。
  • other 表示代码在不属于以上各种页面类型的页面(例如“联系我们”或“关于我们”页面)上使用。
用法示例:

gtag('event', event_name, {
  job_pagetype: 'searchresults'
});
job_totalvalue 此参数适用于 conversionintentconversion 页面类型,并应包含用户选择的职位列表的价值总和。其中不应包含任何货币符号。

以价值为 50 美元的职位列表为例,用法如下:

gtag('event', event_name, {
  job_totalvalue: 50
});

以上所有参数都可以根据需要组合起来使用,并可以与您的业务所需的任何其他自定义参数混搭使用。请注意,使用自定义参数时,您不得使用任何个人身份信息(例如求职者的个人详细信息)。

在只有单个职位列表的情况下,完整代码大致如下:

gtag('event', 'page_view', {
  job_id: 'GOOGUK2341',
  job_locid: 'UK-LON'
  job_pagetype: 'offerdetail'
});

本地优惠网站

以下参数适用于使用合适的 Feed 提供本地优惠信息的网站。

参数 说明
local_id 必选。此必需参数是用户在 searchresultsofferdetailconversionintentconversion 页面类型上查看的具体优惠商品或优惠信息的 ID。此 ID 必须与 Feed 中的值匹配,可以是数字或字母数字。用法示例:

gtag('event', event_name, {
  local_id: 'SPA6231'
});
local_pagetype 表示代码所在页面的类型。有效值:
  • home 表示代码在您网站的首页或着陆页上使用。
  • searchresults 表示代码在显示用户搜索结果的页面上使用。
  • offerdetail 表示代码在显示优惠商品详情的页面上使用。
  • conversionintent 表示代码在购物车/购物篮/结帐页面上使用。
  • conversion 表示代码在用户出手购买(因而也完成了转化)后随即显示的页面(例如致谢页或确认页)上使用。
  • other 表示代码在不属于以上各种页面类型的页面(例如“联系我们”或“关于我们”页面)上使用。
用法示例:

gtag('event', event_name, {
  local_pagetype: 'conversionintent'
});
local_totalvalue 此参数应在 conversionintentconversion 类型的页面上使用,应包含用户购买的优惠产品/服务的价值总和。其中不应包含任何货币符号。

下面以花 50 美元购买的优惠产品/服务为例显示了此参数的具体用法

gtag('event', event_name, {
  local_totalvalue: 50
});

以上所有参数都可以根据需要组合起来使用,还可以与您的业务所需的任何其他自定义参数混搭使用。

例如,对于标价为 50 美元、属性 ID 为“SPA6231”的优惠商品,完整代码如下所示:

gtag('event', 'page_view', {
  local_id: 'SPA6231',
  local_pagetype: 'offerdetail'
});

房地产网站

以下参数适用于使用相应 Feed 的房地产网站。

参数 说明
listing_id 必选。这个必需参数是用户在 searchresultsofferdetailconversionintentconversion 类型的页面上查看的房产 ID。此 ID 必须与 Feed 中的值匹配,可以是数字或字母数字。用法示例:

gtag('event', event_name, {
  listing_id: 'NYBRKLN123A'
});
listing_pagetype 表示代码所在页面的类型。有效值:
  • home 表示代码在您网站的首页或着陆页上使用。
  • searchresults 表示代码在显示用户搜索结果的页面上使用。
  • offerdetail 表示代码在显示房产详细信息的页面上使用。
  • conversionintent 表示代码在购物车/购物篮/结帐页面上使用。
  • conversion 表示代码在用户完成转化后随即显示的页面上使用。对于房地产而言,这可能是预约看房页面。
  • other 表示代码在不属于以上各种页面类型的页面(例如“联系我们”或“关于我们”页面)上使用。
用法示例:

gtag('event', event_name, {
  listing_pagetype: 'conversionintent'
});
listing_totalvalue 此参数适用于 conversionintentconversion 页面类型,并应包含房产的价值总和。不应包含任何货币符号。

以标价 1,000,000.00 美元的房产为例,用法如下:

gtag('event', event_name, {
  listing_totalvalue: 1000000
});

以上所有参数都可以根据需要组合起来使用,并可以与您的业务所需的任何其他自定义参数混搭使用。

以标价为 1,000,000.00 美元、房产 ID 为“NYBRKLN123A”的房产为例,完整代码如下所示:

gtag('event', 'page_view', {
  listing_id: 'NYBRKLN123A',
  listing_pagetype: 'offerdetail',
  listing_totalvalue: 1000000
});

旅游网站

以下参数适用于使用相应 Feed 的旅游网站。

参数 说明
travel_destid 必选。此参数是用户在 searchresultsconversionintentconversion 类型的页面上查看的旅游目的地的 ID。此 ID 必须与 Feed 中的值匹配,可以是数字或字母数字。用法示例:

gtag('event', event_name, {
  travel_destid: 'LON123A'
});
travel_originid 此可选参数是用户在 searchresultsconversionintentconversion 类型的页面上查看的旅游出发地的 ID。此参数可以是数字或字母数字,并且 travel_destid 和 travel_originid 的组合在您帐号的所有 Feed 中都应保持唯一性。

此值用作 Feed 中的辅助匹配键,不需要表示任何内容,但我们建议您使用三字母机场代码或双字母国家/地区代码。用法示例:

gtag('event', event_name, {
  travel_originid: 'LGW'
});
travel_pagetype 表示代码所在页面的类型。有效值:
  • home 表示代码在您网站的首页或着陆页上使用。
  • searchresults 表示代码在显示用户搜索结果的页面上使用。
  • offerdetail 表示代码在显示旅行产品详细信息的页面上使用。
  • conversionintent 表示代码在购物车/购物篮/结帐页面上使用。
  • conversion 表示代码在用户出手购买(因而也完成了转化)后随即显示的页面(例如致谢页或确认页)上使用。
  • cancel 表示代码在用户取消预订的页面上使用。
  • other 表示代码在不属于以上各种页面类型的页面(例如“联系我们”或“关于我们”页面)上使用。
用法示例:

gtag('event', event_name, {
  travel_pagetype: 'conversionintent'
});
travel_startdate 旅程开始的日期。请注意,应采用 YYYY-MM-DD 格式。

用法示例:

gtag('event', event_name, {
  travel_startdate: '2014-04-20'
});
travel_enddate 旅程结束的日期。请注意,应采用 YYYY-MM-DD 格式。

用法示例:

gtag('event', event_name, {
  travel_enddate: '2014-04-21'
});
travel_totalvalue 此参数适用于 conversionintentconversion 页面类型,并应包含旅程的价值总和。其中不应包含任何货币符号。

在预订总额为 549.99 美元的情况下,用法如下:

gtag('event', event_name, {
  travel_totalvalue: 549.99
});

以上所有参数都可以根据需要组合起来使用,并可以与您的业务所需的任何其他自定义参数混搭使用。

以从纽约出发、在 Feed 中 ID 为 LON123A 的房产住宿的旅程为例,购物车页面上使用的完整代码如下。

gtag('event', 'page_view', {
  travel_originid: 'LGA',
  travel_destid: 'LON123A',
  travel_startdate: '2014-04-20',
  travel_enddate: '2014-04-21',
  travel_pagetype: 'conversionintent',
  travel_totalvalue: 549.99
});

其他网站

以下参数适用于不属于本页中上述任何一种行业,但仍希望提供信息来开展动态再营销的网站。这些网站可以使用提供通用 Feed 的自定义 Feed 模板。

参数 说明
dynx_itemid 必选。此参数是用户在 searchresultsofferdetailconversionintentconversion 类型的页面中查看的商品的 ID。此 ID 必须与 Feed 中的值匹配,可以是数字或字母数字。用法示例:

gtag('event', event_name, {
  dynx_itemid: 'CORS9'
});
dynx_itemid2 此可选参数是用户在 searchresultsofferdetailconversionintentconversion 类型的页面上查看的商品的辅助 ID。此 ID 必须与 Feed 中的值匹配,可以是数字或字母数字。

此值在您的 Feed 中用作辅助匹配键,dynx_itemiddynx_itemid2 的组合在您帐号的所有 Feed 中应保持唯一性。用法示例:

gtag('event', event_name, {
  dynx_itemid2: '28'
});
dynx_pagetype 表示代码所在页面的类型。有效值:
  • home 表示代码在您网站的首页或着陆页上使用。
  • searchresults 表示代码在显示用户搜索结果的页面上使用。
  • offerdetail 表示代码在显示特定商品详细信息的页面上使用。
  • conversionintent 表示代码在购物车/购物篮/结帐页面上使用。
  • conversion 表示代码在用户出手购买(因而也完成了转化)后随即显示的页面(例如致谢页或确认页)上使用。
  • cancel 表示代码在用户取消预订的页面上使用。
  • other 表示代码在不属于以上各种页面类型的页面(例如“联系我们”或“关于我们”页面)上使用。
用法示例:

gtag('event', event_name, {
  dynx_pagetype: 'conversionintent'
});
dynx_totalvalue 此参数适用于 conversionintent 页面类型,并应包含用户购买的商品的价值总和。不应包含任何货币符号。

以花 30 美元购买的商品为例,用法如下

gtag('event', event_name, {
  dynx_totalvalue: 30
});

以上所有参数都可以根据需要组合起来使用,并可以与您的业务所需的任何其他自定义参数混搭使用。

以用户购买了两种商品的购物车页面为例,完整代码如下所示:

gtag('event', 'page_view', {
  dynx_itemid: ['CORS9', 'XSS7'],
  dynx_pagetype: 'conversionintent',
  dynx_totalvalue: 78.98
});