报告类型:转化

有关转化的原始事件数据。

此报告只能通过异步请求(即通过 Reports.request() 方法)返回。

由于事件是在特定日期发生的,因此针对此报告的请求必须指定 timeRange。您可以指定以下任一选项:

请求摘录

请发送常规 Reports.request() 请求正文,但指定 "reportType": "conversion"

{
...
  "reportType": "conversion",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

针对您要在报告中返回或过滤的每列,指定下表中列出的 columnName。您还可以选择指定 headerTextstartDateendDate。 请注意,某些列无法过滤;请参阅下表中的“可过滤”。

columnName说明行为类型可过滤
status 转化的状态:ActiveRemoved 特性 Status 兼容
deviceSegment 转化归因于的设备细分:DesktopMobileTabletOther 特性 Device segment 兼容
floodlightGroup Floodlight 活动组名称。 特性 String 兼容
floodlightGroupConversionType 该组中 Floodlight 活动生成的转化类型:ActionTransaction 特性 Conversion type 兼容
floodlightGroupId DS Floodlight 活动组 ID。 特性 ID 兼容
floodlightGroupTag Floodlight 活动组代码。 特性 String 兼容
floodlightActivity Floodlight 活动名称。 特性 String 兼容
floodlightActivityId DS Floodlight 活动 ID。 特性 ID 兼容
floodlightActivityTag Floodlight 活动代码。 特性 String 兼容
agency 代理机构名称。 特性 String 兼容
agencyId DS 代理机构 ID。 特性 ID 兼容
advertiser 广告客户名称。 特性 String 兼容
advertiserId DS 广告客户 ID。 特性 ID 兼容
account 引擎帐号名称。 特性 String 兼容
accountId DS 引擎帐号 ID。 特性 ID 兼容
accountEngineId 外部引擎帐号中的帐号 ID。 特性 String 兼容
accountType 引擎帐号类型:Google AdWordsBing AdsYahoo Japan Listing AdsYahoo Search MarketingYahoo GeminiBaiduComparison Shopping 特性 Engine type 兼容
campaign 广告系列名称。 特性 String 兼容
campaignId DS 广告系列 ID。 特性 ID 兼容
campaignStatus 包含此项的广告系列的状态。 特性 Status 兼容
adGroup 广告组名称。 特性 String 兼容
adGroupId DS 广告组 ID。 特性 ID 兼容
adGroupStatus 包含此项的广告组的状态。 特性 Status 兼容
keywordId DS 关键字 ID。值 0 表示关键字未归因。 特性 ID 兼容
keywordMatchType 关键字匹配类型:BroadExactPhraseContent 特性 Match type 兼容
keywordText 关键字文本。 特性 String 兼容
productTargetId DS 主推产品组 ID。 特性 ID 兼容
productGroupId 与此转化相关联的产品组 ID。只有购物广告系列带来的转化才包含产品组 ID。不应将产品组 ID 用于合并。 特性 ID 兼容
ad 广告名称。 特性 String 兼容
adId DS 广告 ID。值 0 表示未归因该广告。 特性 ID 兼容
isUnattributedAd 指明此行中的指标是否无法归因于特定广告。例如,如果广告的格式不受支持或 Clickserver 网址不正确,就会阻止 DS 将指标归因于广告。 特性 Boolean 兼容
inventoryAccountId 包含与转化相关联的产品的 DS 广告资源帐号 ID。当您在 DS 中关联产品目录帐号时,DS 会生成此 ID。 特性 ID 兼容
productId 与此转化相关联的产品的 ID。 特性 String 兼容
productCountry 为包含与此转化相关联的产品的产品目录 Feed 注册的国家/地区(ISO 3166 格式)。 特性 String 兼容
productLanguage 与此转化相关联的产品的语言 (ISO 639-1)。 特性 String 兼容
productStoreId 与转化相关联的本地产品目录广告中的商店。这应与本地商品 Feed 中使用的商店 ID 一致。 特性 String 兼容
productChannel 与转化相关联的产品的销售渠道:OnlineLocal 特性 Product channel 兼容
conversionId Search Ads 360 为每次转化生成的 ID。 特性 ID 兼容
advertiserConversionId 对于线下转化,这是广告客户提供的 ID。如果广告客户未指定此类 ID,Search Ads 360 就会生成一个。对于在线转化,该值等于 conversionId 列或 FloodlightOrderId 列,具体取决于广告客户的 Floodlight 说明。 特性 String 兼容
conversionType 转化类型:ActionTransaction 特性 Conversion type 兼容
conversionRevenue 转化带来的总金额(美元)。 特性 Money 兼容
conversionQuantity 转化记录的商品数量,由 qty 参数确定。广告客户负责动态填充该参数(例如,转化中销售的商品数量),否则该参数默认为 1。 特性 Number 兼容
conversionDate 转化发生的日期(采用 Campaign Manager 广告资源网时区)。此日期用于汇总转化指标。例如,当 DS 汇总 5 月 1 日的操作时,会统计 conversionDate 为 5 月 1 日的所有操作转化。 特性 Date 兼容
conversionTimestamp 发生转化时的 UTC 时间戳。 特性 Timestamp 兼容
conversionLastModifiedTimestamp 转化最近一次修改的世界协调时间 (UTC) 时间戳。 特性 Timestamp 兼容
conversionAttributionType 归因于该转化的原因:VisitKeyword+Ad 特性 Conversion attribution type 兼容
conversionVisitId 转化归因于的 DS 访问 ID。 特性 ID 兼容
conversionVisitTimestamp 转化归因于的访问的世界协调时间 (UTC) 时间戳。 特性 Timestamp 兼容
conversionVisitExternalClickId 转化所归因于的访问的唯一字符串,该字符串将作为 gclid 网址参数传递到着陆页。仅为已集成 Conversion API 或 Google Analytics(分析)的广告客户启用。 特性 String 兼容
conversionSearchTerm 促成转化的搜索字词。 特性 String 兼容
floodlightOriginalRevenue 与 Floodlight 事件相关联的、未更改的原始收入(以当前报告的货币为单位),修改 Floodlight 货币说明之前。 特性 Money 兼容
floodlightEventRequestString 转化的 Floodlight 请求字符串。 特性 String 兼容
floodlightReferrer 转化的 Floodlight 引荐来源网址。 特性 String 兼容
floodlightOrderId 广告客户为转化提供的 Floodlight 订单 ID。 特性 String 兼容
feedItemId 与此转化相关联的 Feed 项行的 ID。 特性 ID 兼容
feedId 与此转化相关联的 Feed 表格的 ID。 特性 ID 兼容
feedType 与此转化相关联的 Feed 的类型。 特性 Feed type 兼容