Method: customers.generateIvtReport

Rozpoczynanie wykonywania zapytania w celu pobrania z każdego dnia podsumowania nieprawidłowego ruchu dla konkretnej platformy. Wyniki zostaną zapisane w określonej tabeli docelowej BigQuery. Zwracana nazwa operacji może służyć do sprawdzania stanu ukończenia zapytania.

Tabela wyjściowa zawiera 5 wierszy na każdy dzień w zakresie dat. Po 1 wierszu na każdy z 4 typów urządzeń i 1 wiersz na wszystkie typy urządzeń. Wiersz Wszystko to suma 4 rodzajów urządzeń danego dnia. W efekcie każda kolumna zawiera 2 razy łączną liczbę wyświetleń. Jeśli CDR usunie wiersze z powodu ograniczeń dotyczących prywatności, poddane filtrowaniu wiersza (wiersz bez daty) będzie zawierać sumę usuniętych wierszy.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

Klient Ads Data Hub wysyłający żądanie. Ma to format 'klienci/[identyfikator klienta]'. np. 'klienci/123'.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis 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.
}
Pola
adsDataCustomerId

string (int64 format)

Połączony identyfikator klienta Centrum danych reklam, do którego należą dane reklam.
startDate

object (Date)

Pierwszy dzień wygenerowanego raportu.
endDate

object (Date)

Ostatni dzień wygenerowanego raportu, włącznie.
timeZone

string

Opcjonalne. Strefa czasowa daty rozpoczęcia i zakończenia raportu. Jeśli nie zostaną podane, domyślnie przyjmuje on 'UTC'.
destTable

string

Docelowa tabela BigQuery dla wyników zapytania w formacie 'project.dataset.table_name'. Jeśli projekt zostanie określony, konto musi być wyraźnie umieszczone na białej liście na koncie CDR klienta. Jeśli projekt nie został określony, używany jest domyślny projekt dla podanego klienta. Jeśli nie określono żadnego projektu ani zbioru danych, używany jest domyślny projekt i zbiór danych.
Pole związkowe platform_dimensions. Platforma, której dotyczy raport, z opcją podziału na segmenty według platformy. Jeśli nie wybierzesz platformy, wystąpi błąd. platform_dimensions może mieć tylko jedną z tych wartości:
googleAdsDimensions

object (GoogleAdsDimensions)

Raportowanie platformy Google Ads.
dv360YoutubeDimensions

object (Dv360Dimensions)

Raport o platformie DV360.
ytReserveDimensions

object (YouTubeReserveDimensions)

Raport o YTR platformy.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Operation.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Wymiary Google Ads

Filtrowanie wymiarów na platformie Google Ads.

Zapis JSON 
{
  "campaignIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Pola
campaignIds[]

string (int64 format)

Opcjonalne identyfikatory kampanii Google Ads. Jeśli ta kolumna jest pusta, zawiera raporty o wszystkich kampaniach w wybranym okresie.
metricType

enum (MetricType)

Określa platformę do pomiaru i raportowania.

Typ metryki

Określa platformę do pomiaru i raportowania.

Wartości w polu enum
METRIC_TYPE_UNSPECIFIED Nieokreślony typ danych.
METRIC_TYPE_IMPRESSION danych o wyświetleniach Google Ads.
METRIC_TYPE_YOUTUBE_VIEW Obejrzenia w YouTube (lub inaczej) TrueView

DV360 – Wymiary

Filtrowanie wymiarów na platformie DV360.

Zapis JSON 
{
  "lineItemIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Pola
lineItemIds[]

string (int64 format)

Opcjonalne identyfikatory elementów zamówienia w DV360. Jeśli to pole jest puste, zawiera raporty o wszystkich elementach zamówienia w danym okresie.
metricType

enum (MetricType)

Określa platformę do pomiaru i raportowania.

Wymiary YouTube Reserve

Filtrowanie wymiarów na platformie YouTube Reserve.

Zapis JSON 
{
  "orderIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Pola
orderIds[]

string (int64 format)

Opcjonalne identyfikatory zamówień YouTube Reserve. Jeśli ta kolumna jest pusta, zawiera wszystkie zamówienia z wybranego okresu.
metricType

enum (MetricType)

Określa platformę do pomiaru i raportowania.