Method: customers.generateIvtReport

Belirli bir platforma ait geçersiz trafik sayılarının günlük özetini almak için bir sorgunun yürütülmesini başlatır. Sonuçlar, belirtilen BigQuery hedef tablosuna yazılır. Döndürülen işlem adı, sorgu tamamlanma durumunu yoklamak için kullanılabilir.

Sonuç tablosunda, tarih aralığındaki her gün için 5 satır bulunur. 4 cihaz türünün her biri için 1 satır ve tüm cihaz türleri için 1 satır. Tümü satırı o gün için 4 cihaz türünün toplamıdır. Sonuç olarak her bir sütun, toplam gösterim sayısının iki katını içerir. ADH, gizlilik kısıtlamaları nedeniyle satırları çıkarırsa filtrelenmiş satır özeti (gün içermeyen satır), çıkartılan satırların toplamını içerir.

HTTP isteği

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

URL, gTB Kod Geçişi söz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

İstekte bulunan Ads Data Hub müşterisi. Bu, 'customers/[customerId]' biçimindedir; ör. 'customers/123'.

İstek metni

İstek gövdesi aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi 
{
  "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.
}
Alanlar
adsDataCustomerId

string (int64 format)

Reklam verilerinin sahibi olan bağlı Ads Data Hub müşteri kimliği.
startDate

object (Date)

Oluşturulan raporun ilk günü.
endDate

object (Date)

Oluşturulan raporun son günü (dahil.
timeZone

string

İsteğe bağlı. Raporun başlangıç ve bitiş tarihlerinin saat dilimi. Belirtilmezse varsayılan olarak 'UTC' değerine ayarlanır.
destTable

string

Sorgu sonuçları için 'proje.veri_kümesi.tablo_adı' biçiminde Hedef BigQuery tablosu. Belirtilirse proje, müşterinin ADH hesabı için açık bir şekilde beyaz listeye eklenmelidir. Proje belirtilmezse sağlanan müşteri için varsayılan projeyi kullanır. Proje veya veri kümesi belirtilmemişse varsayılan proje ya da veri kümesi kullanılır.
Birlik alanı platform_dimensions. İsteğe bağlı platforma özel dilimlemenin kullanılacağı platform. Platform seçilmezse hata oluşur. platform_dimensions aşağıdakilerden yalnızca biri olabilir:
googleAdsDimensions

object (GoogleAdsDimensions)

Google Ads platformu hakkında rapor oluşturun.
dv360YoutubeDimensions

object (Dv360Dimensions)

DV360 platformu hakkında rapor oluşturun.
ytReserveDimensions

object (YouTubeReserveDimensions)

YTR platformu hakkında rapor oluşturun.

Yanıt metni

Başarılıysa yanıt metni, Operation öğesinin bir örneğini içerir.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

GoogleAdsBoyutlar

Google Ads platformu için boyutları filtreleme.

JSON gösterimi 
{
  "campaignIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Alanlar
campaignIds[]

string (int64 format)

İsteğe bağlı Google Ads kampanya kimlikleri. Boşsa, belirtilen dönem için tüm kampanyalar raporlanır.
metricType

enum (MetricType)

Ölçülecek ve raporlanacak platformu belirler.

Metrik Türü

Ölçülecek ve raporlanacak platformu belirler.

Sıralamalar
METRIC_TYPE_UNSPECIFIED Belirtilmemiş metrik türü.
METRIC_TYPE_IMPRESSION Google Ads gösterim verileri.
METRIC_TYPE_YOUTUBE_VIEW YouTube görüntülemelerine TrueView görüntülemeleri adı verilir.

Dv360Boyutlar

DV360 platformu için filtreleme boyutları.

JSON gösterimi 
{
  "lineItemIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Alanlar
lineItemIds[]

string (int64 format)

İsteğe bağlı DV360 satır öğesi kimlikleri. Boşsa, belirtilen dönem için tüm satır öğeleri raporlanır.
metricType

enum (MetricType)

Ölçülecek ve raporlanacak platformu belirler.

YouTube Reserve Boyutları

YouTube Reserve platformu için filtreleme boyutları.

JSON gösterimi 
{
  "orderIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Alanlar
orderIds[]

string (int64 format)

İsteğe bağlı YouTube Reserve sipariş kimlikleri. Boş bırakılırsa belirtilen dönem için tüm siparişler hakkında rapor oluşturulur.
metricType

enum (MetricType)

Ölçülecek ve raporlanacak platformu belirler.