报告类型:访问

有关访问的原始事件数据。每当消费者点击广告并被重定向到着陆页时,就计为一次访问。

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

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

请求摘录

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

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

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

columnName说明行为类型可过滤
status 访问的状态。访问是不可变的,因此始终为 Active 特性 Status 兼容
deviceSegment 访问归因于的设备细分:DesktopMobileTabletOther 特性 Device segment 兼容
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 为包含商品数据的数据的 Merchant Center Feed 设置的语言 (ISO 639-1)。 特性 String 兼容
productStoreId 用户点击本地商品目录广告中的商店。这应与本地商品 Feed 中使用的商店 ID 一致。 特性 String 兼容
productChannel 获得点击的商品的销售渠道:OnlineLocal 特性 Product channel 兼容
visitId DS 访问 ID。 特性 ID 兼容
visitSearchQuery 产生此访问的搜索查询。 特性 String 兼容
visitDate 访问发生的日期(采用引擎帐号所在时区)。此日期用于汇总访问数据。例如,当 DS 汇总 5 月 1 日的访问次数时,会统计 visitDate 为 5 月 1 日的所有访问。 特性 Date 兼容
visitTimestamp 访问发生时的 UTC 时间戳。 特性 Timestamp 兼容
visitNetworkType 促成此访问的广告联盟:ContentSearchOther 特性 Network type 兼容
visitReferrer 访问的引荐来源网址。 特性 String 兼容
visitExternalClickId 作为 gclid 网址参数传递给着陆页的每个访问的唯一字符串。仅为已集成 Conversion API 或 Google Analytics(分析)的广告客户启用。 特性 String 兼容
feedItemId 与此访问相关联的 Feed 项行的 ID。 特性 ID 兼容
feedId 与此访问相关联的 Feed 表的 ID。 特性 ID 兼容
feedType 与此访问相关联的 Feed 的类型。 特性 Feed type 兼容