Method: customers.generateIvtReport

Inicia a execução de uma consulta para recuperar um resumo diário de contagens de tráfego inválido de uma plataforma específica. Os resultados serão gravados na tabela de destino especificada do BigQuery. O nome da operação retornada pode ser usado para pesquisar o status de conclusão da consulta.

A tabela de saída contém cinco linhas para cada dia no período. Uma linha para cada tipo de dispositivo e uma linha para todos os tipos de dispositivo. A linha "Todos" é a soma dos quatro tipos de dispositivo para esse dia. Como resultado, cada coluna contém o dobro do número de impressões. Se o ADH editar as linhas devido a restrições de privacidade, o resumo da linha filtrada (a linha sem dia) conterá a soma das linhas editadas.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Cliente do Ads Data Hub que faz a solicitação. Isto está no formato 'customers/[customerId]'. por exemplo, 'customers/123'.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação 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.
}
Campos
adsDataCustomerId

string (int64 format)

ID de cliente do Ads Data Hub vinculado que tem os dados dos anúncios.
startDate

object (Date)

O primeiro dia do relatório gerado.
endDate

object (Date)

O último dia do relatório gerado, inclusive.
timeZone

string

Opcional. Indica o fuso horário das datas de início e término do relatório. Se não for especificado, o padrão será 'UTC'
destTable

string

Tabela de destino do BigQuery para resultados da consulta com o formato 'project.dataset.table_name'. Se especificado, o projeto precisa estar explicitamente na lista de permissões da conta do ADH do cliente. Se o projeto não for especificado, o projeto padrão será usado para o cliente informado. Se nem o projeto nem o conjunto de dados forem especificados, usará o projeto e o conjunto de dados padrão.
Campo de união platform_dimensions. A plataforma para gerar relatórios com o fracionamento específico específico da plataforma. Não selecionar uma plataforma resultará em um erro. platform_dimensions pode ser apenas de um dos tipos a seguir:
googleAdsDimensions

object (GoogleAdsDimensions)

Gere relatórios sobre a plataforma Google Ads.
dv360YoutubeDimensions

object (Dv360Dimensions)

Gerar relatórios sobre a plataforma do DV360.
ytReserveDimensions

object (YouTubeReserveDimensions)

Relatório sobre YTR da plataforma.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Dimensões do Google Ads

Filtrar dimensões para a plataforma do Google Ads.

Representação JSON 
{
  "campaignIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Campos
campaignIds[]

string (int64 format)

IDs de campanhas do Google Ads opcionais. Se estiver vazio, informará todas as campanhas no período especificado.
metricType

enum (MetricType)

Designa a plataforma para a medição e o relatório.

MetricType

Designa a plataforma para a medição e o relatório.

Enums
METRIC_TYPE_UNSPECIFIED Tipo de métrica não especificado.
METRIC_TYPE_IMPRESSION Dados de impressão do Google Ads
METRIC_TYPE_YOUTUBE_VIEW Visualizações do YouTube, também conhecidas como TrueView.

Dimensões do DV360

Filtrar dimensões para a plataforma do DV360.

Representação JSON 
{
  "lineItemIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Campos
lineItemIds[]

string (int64 format)

Códigos opcionais do item de linha do DV360. Se estiver vazio, gerará relatórios sobre todos os itens de linha do período especificado.
metricType

enum (MetricType)

Designa a plataforma para a medição e o relatório.

Dimensões de reserva do YouTube

Filtragem de dimensões para a plataforma YouTube Reserve.

Representação JSON 
{
  "orderIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Campos
orderIds[]

string (int64 format)

Códigos de pedidos opcionais do YouTube Reserve. Se estiver vazio, informará todos os pedidos do período especificado.
metricType

enum (MetricType)

Designa a plataforma para a medição e o relatório.