报告类型:访问

有关访问的原始事件数据。每当消费者点击广告并被重定向至着陆页时,即发生了一次访问。

只有异步请求(即通过 Reports.request() 方法)。

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

请求摘录

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

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

对于您想在报告中返回或过滤的每一列, 指定下表中列出的 columnName。 您还可以视需要指定 headerTextstartDate, 和 endDate。 请注意,有些列无法过滤;指“可过滤”。

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 网址错误的 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