Method: customers.generateIvtReport

開始執行查詢，以便擷取特定平台的無效流量數量每日摘要。系統會將結果寫入指定的 BigQuery 目的地資料表。傳回的作業名稱可用來輪詢查詢完成狀態。

輸出表格內有日期範圍內每一天的 5 列。4 種裝置類型各 1 列，所有裝置類型各 1 列。「所有」列是當天 4 種裝置類型的總和。因此，每個資料欄都包含曝光總數的兩倍。如果 ADH 因隱私權限製而遮蓋資料列，篩選後的資料列摘要 (不含資料列) 就會納入遮蓋的資料列總和。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

廣告資料中心客戶提出要求。的形式為 'customers/[customerId]'。例如 'customers/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 資料表，格式為「##9;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 Reserve 平台的篩選維度。

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

string (int64 format)

(選填) YouTube Reserve 訂單 ID。如果留空，表示指定時間範圍內的所有訂單報表。
metricType

enum (MetricType)

指定要評估及製作報表的平台。