报告类型:访问

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

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

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

请求摘录

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

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

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

columnName说明行为类型可过滤
status 访问的状态。访问是不可变的,因此始终为 Active。 属性 Status 是
deviceSegment 访问所归因的设备细分:Desktop、Mobile、Tablet 或 Other。 属性 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 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 网址错误的 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 获得点击的商品的销售渠道:Online 或 Local。 属性 Product channel 是
visitId DS 访问 ID。 属性 ID 是
visitSearchQuery 促成本次访问的搜索查询。 属性 String 是
visitDate 访问发生的日期(采用引擎账号时区)。此日期用于汇总访问次数。例如,当 DS 汇总 5 月 1 日的访问次数时,也会统计 visitDate 为 5 月 1 日的所有访问次数。 属性 Date 是
visitTimestamp 访问发生时的世界协调时间 (UTC) 时间戳。 属性 Timestamp 是
visitNetworkType 促成本次访问的广告联盟:Content、Search 或 Other。 属性 Network type 是
visitReferrer 访问的引荐来源网址。 属性 String 是
visitExternalClickId 作为 gclid 网址参数传递给着陆页的每次访问的唯一字符串。仅对集成了 Conversion API 或 Google Analytics 的广告客户启用。 属性 String 是
feedItemId 与本次访问相关联的 Feed 项行的 ID。 属性 ID 是
feedId 与本次访问相关联的 Feed 表格的 ID。 属性 ID 是
feedType 与本次访问相关的 Feed 类型。 属性 Feed type 是