Method: customers.generateIvtReport

Avvia l'esecuzione di una query per recuperare un riepilogo giornaliero dei conteggi del traffico non valido per una piattaforma specifica. I risultati verranno scritti nella tabella di destinazione BigQuery specificata. Il nome dell'operazione restituito può essere utilizzato per eseguire il polling dello stato di completamento della query.

La tabella di output contiene 5 righe per ogni giorno nell'intervallo di date. 1 riga per ciascuno dei 4 tipi di dispositivo e 1 riga per tutti i tipi di dispositivi. La riga Tutti è la somma dei 4 tipi di dispositivi per quel giorno. Di conseguenza, ogni colonna contiene il doppio del numero totale di impressioni. Se ADH oscura le righe a causa dei vincoli di privacy, il riepilogo di righe filtrate (la riga senza giorno) conterrà la somma di righe oscurate.

Richiesta HTTP

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

L'URL utilizza la sintassi gRPC Transcoding.

Parametri del percorso

Parametri
name

string

Cliente di Ads Data Hub che effettua la richiesta. nel formato di 'customers/[customerId]'. ad es. 'customers/123'.

Corpo della richiesta

Il corpo della richiesta contiene i dati con la seguente struttura:

Rappresentazione 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.
}
Campi
adsDataCustomerId

string (int64 format)

ID cliente Ads Data Hub collegato a cui appartengono i dati pubblicitari.
startDate

object (Date)

Il primo giorno del report generato.
endDate

object (Date)

L'ultimo giorno del report generato, inclusi.
timeZone

string

(Facoltativo) Il fuso orario per le date di inizio e di fine del report. Se non specificato, il valore predefinito è 'UTC'.
destTable

string

Tabella BigQuery di destinazione per i risultati della query con il formato 'project.dataset.table_name'. Se specificato, il progetto deve essere autorizzato in modo esplicito per l'account ADH del cliente. Se il progetto non è specificato, utilizza il progetto predefinito per il cliente fornito. Se non vengono specificati né il progetto né il set di dati, vengono utilizzati il progetto e il set di dati predefiniti.
Campo unione platform_dimensions. La piattaforma su cui si esegue il reporting con suddivisione facoltativa specifica per piattaforma. Se non selezioni una piattaforma, verrà visualizzato un errore. platform_dimensions può essere solo uno dei seguenti:
googleAdsDimensions

object (GoogleAdsDimensions)

Report sulla piattaforma Google Ads
dv360YoutubeDimensions

object (Dv360Dimensions)

Report sulla piattaforma DV360
ytReserveDimensions

object (YouTubeReserveDimensions)

Report sulla piattaforma YTR.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Dimensioni Google Ads

Filtrare le dimensioni della piattaforma Google Ads.

Rappresentazione JSON 
{
  "campaignIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Campi
campaignIds[]

string (int64 format)

ID campagne Google Ads facoltativi. Se vuoto, genera report su tutte le campagne per il periodo di tempo specificato.
metricType

enum (MetricType)

Indica la piattaforma su cui misurare e generare report.

MetricType

Indica la piattaforma su cui misurare e generare report.

Enum
METRIC_TYPE_UNSPECIFIED Tipo di metrica non specificato.
METRIC_TYPE_IMPRESSION Dati sulle impressioni di Google Ads.
METRIC_TYPE_YOUTUBE_VIEW Visualizzazioni di YouTube, note anche come TrueView.

Dimensioni Dv360

Dimensioni dei filtri per la piattaforma DV360.

Rappresentazione JSON 
{
  "lineItemIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Campi
lineItemIds[]

string (int64 format)

ID elementi pubblicitari DV360 facoltativi. Se viene lasciato vuoto, genera report su tutti gli elementi pubblicitari per il periodo di tempo specificato.
metricType

enum (MetricType)

Indica la piattaforma su cui misurare e generare report.

Dimensioni prenotazione YouTube

Filtrare le dimensioni della piattaforma YouTube Reserve.

Rappresentazione JSON 
{
  "orderIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Campi
orderIds[]

string (int64 format)

ID ordine di YouTube Reserve facoltativi. Se vuoto, genera report su tutti gli ordini per il periodo di tempo specificato.
metricType

enum (MetricType)

Indica la piattaforma su cui misurare e generare report.