Method: customers.generateIvtReport

开始执行查询，以检索特定平台的无效流量每天数据摘要。结果将写入指定的 BigQuery 目标表。返回的操作名称可用于轮询查询完成状态。

输出表格中的日期范围为每天的 5 行。4 个设备类型各占 1 行，所有设备类型各占 1 行。“所有”行是当天 4 种设备类型的总和。因此，每列包含总展示次数的两倍。如果 ADH 因隐私保护限制而隐去了行，则过滤后的行摘要（不含日期的行）将包含被隐去的行的总和。

HTTP 请求

POST https://adsdatahub.googleapis.com/v1/{name=customers/*}:generateIvtReport

网址采用 gRPC 转码语法。

路径参数

参数
name

string

发出请求的广告数据中心客户。格式为“客户/[客户 ID]”。例如“客户/123”。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "adsDataCustomerId": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "timeZone": string,
  "destTable": string,

  // Union field platform_dimensions can be only one of the following:
  "googleAdsDimensions": {
    object (GoogleAdsDimensions)
  },
  "dv360YoutubeDimensions": {
    object (Dv360Dimensions)
  },
  "ytReserveDimensions": {
    object (YouTubeReserveDimensions)
  }
  // End of list of possible types for union field platform_dimensions.
}
字段
adsDataCustomerId

string (int64 format)

拥有广告数据的关联广告数据中心客户 ID。
startDate

object (Date)

所生成报告的第一天。
endDate

object (Date)

所生成报告的最后一天（含）。
timeZone

string

（可选）报表开始日期和结束日期的时区。如果未指定，则默认为 'UTC'。
destTable

string

查询结果的 BigQuery 表，格式为 'project.dataset.table_name'。如果指定，则必须为客户的 ADH 帐号明确将项目列入白名单。如果未指定项目，则对提供的客户使用默认项目。如果未指定项目和数据集，则使用默认项目和数据集。
联合字段 platform_dimensions。使用可选平台专用切片进行报告的平台。不选择平台将导致错误。platform_dimensions 只能是下列其中一项：
googleAdsDimensions

object (GoogleAdsDimensions)

生成 Google Ads 平台报告。
dv360YoutubeDimensions

object (Dv360Dimensions)

针对 DV360 平台生成报表。
ytReserveDimensions

object (YouTubeReserveDimensions)

生成有关 YTR 平台的报告。

响应正文

如果成功，响应正文将包含一个 Operation 实例。

授权范围

需要以下 OAuth 作用域：

  • https://www.googleapis.com/auth/adsdatahub

Google Ads 维度

Google Ads 平台的过滤维度。

JSON 表示法 
{
  "campaignIds": [
    string
  ],
  "metricType": enum (MetricType)
}
字段
campaignIds[]

string (int64 format)

可选的 Google Ads 广告系列 ID。如果留空，则系统会报告指定时间段内的所有广告系列。
metricType

enum (MetricType)

指定要衡量和生成报告的平台。

MetricType

指定要衡量和生成报告的平台。

枚举
METRIC_TYPE_UNSPECIFIED 未指定的指标类型。
METRIC_TYPE_IMPRESSION Google Ads 展示数据。
METRIC_TYPE_YOUTUBE_VIEW YouTube 观看次数，也称为 TrueView 观看次数。

DV360 维度

DV360 平台的过滤维度。

JSON 表示法 
{
  "lineItemIds": [
    string
  ],
  "metricType": enum (MetricType)
}
字段
lineItemIds[]

string (int64 format)

可选的 DV360 订单项 ID。如果留空，则系统会为指定时间段内的所有订单项生成报表。
metricType

enum (MetricType)

指定要衡量和生成报告的平台。

YouTube 预订型广告资源

YouTube 预订型广告资源平台的过滤维度。

JSON 表示法 
{
  "orderIds": [
    string
  ],
  "metricType": enum (MetricType)
}
字段
orderIds[]

string (int64 format)

可选的 YouTube 预订型广告资源订单 ID。如果留空，则系统会报告指定时间段内的所有订单。
metricType

enum (MetricType)

指定要衡量和生成报告的平台。