Method: customers.generateIvtReport

Memulai eksekusi kueri untuk mengambil ringkasan jumlah hari tidak valid dari hari ke hari untuk platform tertentu. Hasilnya akan ditulis ke tabel tujuan BigQuery yang ditentukan. Nama operasi yang ditampilkan dapat digunakan untuk memeriksa status penyelesaian kueri.

Tabel output berisi 5 baris untuk setiap hari dalam rentang tanggal. 1 baris untuk masing-masing dari 4 jenis perangkat, dan 1 baris untuk semua jenis perangkat. Baris Semua adalah jumlah dari 4 jenis perangkat untuk hari tersebut. Hasilnya, setiap kolom berisi total jumlah tayangan dua kali lipat. Jika ADH menyamarkan baris karena batasan privasi, ringkasan baris yang difilter (baris tanpa hari) akan berisi jumlah baris yang disamarkan.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Pelanggan Ads Data Hub yang membuat permintaan. Ini dalam bentuk 'pelanggan/[pelangganId]'. mis. 'pelanggan/123'.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi 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.
}
Kolom
adsDataCustomerId

string (int64 format)

ID pelanggan Ads Data Hub tertaut yang memiliki data iklan.
startDate

object (Date)

Hari pertama laporan yang dibuat.
endDate

object (Date)

Hari terakhir laporan yang dibuat, inklusif.
timeZone

string

Opsional. Zona waktu untuk tanggal mulai dan akhir laporan. Jika tidak ditentukan, setelan defaultnya adalah 'UTC'.
destTable

string

Tabel BigQuery tujuan untuk hasil kueri dengan format 'project.dataset.table_name'. Jika ditentukan, project harus diizinkan secara eksplisit untuk akun ADH pelanggan. Jika project tidak ditentukan, project default akan digunakan untuk pelanggan yang disediakan. Jika project atau set data tidak ditentukan, project dan set data default akan digunakan.
Kolom union platform_dimensions. Platform yang akan dilaporkan dengan pemotongan khusus platform opsional. Tidak memilih platform akan menghasilkan error. platform_dimensions hanya dapat berupa salah satu dari berikut:
googleAdsDimensions

object (GoogleAdsDimensions)

Laporan tentang platform Google Ads.
dv360YoutubeDimensions

object (Dv360Dimensions)

Laporan tentang platform DV360.
ytReserveDimensions

object (YouTubeReserveDimensions)

Laporan terkait platform YouTubeR.

Isi respons

Jika berhasil, isi respons memuat instance Operation.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut ini:

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

DimensiGoogleAds

Memfilter dimensi untuk platform Google Ads.

Representasi JSON 
{
  "campaignIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Kolom
campaignIds[]

string (int64 format)

ID kampanye Google Ads opsional. Jika kosong, melaporkan semua kampanye untuk jangka waktu tertentu.
metricType

enum (MetricType)

Menetapkan platform untuk diukur dan dilaporkan.

Jenis Metrik

Menetapkan platform untuk diukur dan dilaporkan.

Enumerasi
METRIC_TYPE_UNSPECIFIED Jenis metrik belum ditetapkan.
METRIC_TYPE_IMPRESSION Data tayangan Google Ads.
METRIC_TYPE_YOUTUBE_VIEW Penayangan YouTube alias penayangan TrueView.

Dv360Dimensi

Memfilter dimensi untuk platform DV360.

Representasi JSON 
{
  "lineItemIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Kolom
lineItemIds[]

string (int64 format)

ID item baris DV360 opsional. Jika kosong, melaporkan semua item baris untuk jangka waktu tertentu.
metricType

enum (MetricType)

Menetapkan platform untuk diukur dan dilaporkan.

YouTubeReserveDimension

Memfilter dimensi untuk platform YouTube Reserve.

Representasi JSON 
{
  "orderIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Kolom
orderIds[]

string (int64 format)

ID pesanan YouTube Reserve opsional. Jika kosong, akan melaporkan semua pesanan untuk jangka waktu yang ditentukan.
metricType

enum (MetricType)

Menetapkan platform untuk diukur dan dilaporkan.