Method: customers.generateIvtReport

Startet die Ausführung einer Abfrage, um eine tägliche Übersicht über die ungültigen Zugriffe für eine bestimmte Plattform abzurufen. Die Ergebnisse werden in die angegebene BigQuery-Zieltabelle geschrieben. Der zurückgegebene Vorgangsname kann zum Abfragen des Abfrageabschlussstatus verwendet werden.

Die Ausgabetabelle enthält 5 Zeilen für jeden Tag im Zeitraum. Eine Zeile für jeden der vier Gerätetypen und eine Zeile für alle Gerätetypen. Die Zeile „Alle“ enthält die Summe der vier Gerätetypen für diesen Tag. Daher enthält jede Spalte die doppelte Anzahl von Impressionen. Wenn ADH aufgrund von Datenschutzeinschränkungen Zeilen entfernt, enthält die Zusammenfassung der gefilterten Zeilen (die Zeile ohne Tag) die Summe der Zeilen mit entfernten Daten.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Ads Data Hub-Kunde, der die Anfrage stellt. Sie hat das Format „'customers/[customerId]'“, z. B. „##99customers/123'“.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "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.
}
Felder
adsDataCustomerId

string (int64 format)

Verknüpfte Ads Data Hub-Kundennummer, zu der die Anzeigendaten gehören.
startDate

object (Date)

Der erste Tag des generierten Berichts.
endDate

object (Date)

Der letzte Tag des generierten Berichts (einschließlich)
timeZone

string

Optional. Zeitzone für das Start- und Enddatum des Berichts Standardmäßig wird 'UTC' verwendet.
destTable

string

BigQuery-Zieltabelle für Abfrageergebnisse im Format 'project.dataset.table_name' Falls angegeben, muss das Projekt explizit auf die Zulassungsliste für das ADH-Konto des Kunden gesetzt werden. Wenn das Projekt nicht angegeben ist, wird das Standardprojekt für den angegebenen Kunden verwendet. Wenn weder Projekt noch Dataset angegeben ist, werden das Standardprojekt und das Dataset verwendet.
Union-Feld platform_dimensions. Die Plattform für die Berichterstellung mit optionaler plattformspezifischer Segmentierung. Wenn Sie keine Plattform auswählen, wird ein Fehler ausgegeben. Für platform_dimensions ist nur einer der folgenden Werte zulässig:
googleAdsDimensions

object (GoogleAdsDimensions)

Berichte zu Google Ads-Plattformen erstellen
dv360YoutubeDimensions

object (Dv360Dimensions)

Erstellen Sie einen Bericht für die DV360-Plattform.
ytReserveDimensions

object (YouTubeReserveDimensions)

Bericht zur Plattform YTR erstellen.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Google Ads-Dimensionen

Dimensionen für die Google Ads-Plattform filtern

JSON-Darstellung 
{
  "campaignIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Felder
campaignIds[]

string (int64 format)

Optionale Google Ads-Kampagnen-IDs. Wenn das Feld leer ist, werden alle Kampagnen im angegebenen Zeitraum berücksichtigt.
metricType

enum (MetricType)

Bezeichnet die Plattform für Messungen und Berichte in Berichten.

MetricType

Bezeichnet die Plattform für Messungen und Berichte in Berichten.

Enums
METRIC_TYPE_UNSPECIFIED Nicht angegebener Messwerttyp.
METRIC_TYPE_IMPRESSION Google Ads-Impressionsdaten
METRIC_TYPE_YOUTUBE_VIEW YouTube-Aufrufe, auch TrueView-Aufrufe genannt.

DV360-Abmessungen

Dimensionen für die DV360-Plattform filtern

JSON-Darstellung 
{
  "lineItemIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Felder
lineItemIds[]

string (int64 format)

Optionale DV360-Werbebuchungs-IDs. Wenn das Feld leer ist, werden alle Werbebuchungen im angegebenen Zeitraum berücksichtigt.
metricType

enum (MetricType)

Bezeichnet die Plattform für Messungen und Berichte in Berichten.

YouTube ReserveDimensionen

Dimensionen für die YouTube Reserve-Plattform filtern

JSON-Darstellung 
{
  "orderIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Felder
orderIds[]

string (int64 format)

Optionale YouTube Reserve-Bestell-IDs. Wenn das Feld leer ist, werden alle Aufträge für den angegebenen Zeitraum erfasst.
metricType

enum (MetricType)

Bezeichnet die Plattform für Messungen und Berichte in Berichten.