有关转化的原始事件数据。
此报告只能通过异步请求(即通过 Reports.request() 方法)返回。
由于事件是在特定日期发生的,因此针对此报告的请求必须指定 timeRange。您可以指定以下任一选项:
请求摘录
请发送常规 Reports.request() 请求正文,但指定 "reportType": "conversion"
。
{ ... "reportType": "conversion", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
针对您要在报告中返回或过滤的每列,指定下表中列出的 columnName
。您还可以选择指定 headerText、startDate 和 endDate。
请注意,某些列无法过滤;请参阅下表中的“可过滤”。
columnName | 说明 | 行为 | 类型 | 可过滤 |
---|---|---|---|---|
status |
转化的状态:Active 或 Removed 。 |
特性 | Status |
兼容 |
deviceSegment |
转化归因于的设备细分:Desktop 、Mobile 、Tablet 或 Other 。 |
特性 | Device segment |
兼容 |
floodlightGroup |
Floodlight 活动组名称。 | 特性 | String |
兼容 |
floodlightGroupConversionType |
该组中 Floodlight 活动生成的转化类型:Action 或 Transaction 。 |
特性 | 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 AdWords 、Bing Ads 、Yahoo Japan Listing Ads 、Yahoo Search Marketing 、Yahoo Gemini 、Baidu 或 Comparison 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 |
关键字匹配类型:Broad 、Exact 、Phrase 或Content 。 |
特性 | 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 |
与转化相关联的产品的销售渠道:Online 或 Local 。 |
特性 | Product channel |
兼容 |
conversionId |
Search Ads 360 为每次转化生成的 ID。 | 特性 | ID |
兼容 |
advertiserConversionId |
对于线下转化,这是广告客户提供的 ID。如果广告客户未指定此类 ID,Search Ads 360 就会生成一个。对于在线转化,该值等于 conversionId 列或 FloodlightOrderId 列,具体取决于广告客户的 Floodlight 说明。 | 特性 | String |
兼容 |
conversionType |
转化类型:Action 或 Transaction 。 |
特性 | 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 |
归因于该转化的原因:Visit 或 Keyword+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 |
兼容 |