Method: customers.generateIvtReport

Inicia la ejecución de una consulta para recuperar un resumen diario de los recuentos de tráfico no válido de una plataforma específica. Los resultados se escribirán en la tabla de destino de BigQuery especificada. El nombre de la operación que se muestra se puede usar para sondear el estado de finalización de la consulta.

La tabla de salida contiene 5 filas para cada día del período. 1 fila para cada uno de los 4 tipos de dispositivos y 1 fila para todos los tipos de dispositivo La fila Todos es la suma de los 4 tipos de dispositivos de ese día. Como resultado, cada columna contiene el doble de la cantidad total de impresiones. Si el CDA oculta las filas debido a restricciones de privacidad, el resumen de filas filtrados (la fila sin día) contendrá la suma de filas ocultas.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
name

string

Cliente del Centro de Datos de Anuncios que realiza la solicitud. Este formato tiene el formato 'customers/[customerId]' p. ej., &33;customers/123'.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación 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)

Es el ID de cliente del Centro de datos de anuncios vinculado que posee los datos de los anuncios.
startDate

object (Date)

El primer día del informe generado.
endDate

object (Date)

Es el último día del informe generado, inclusive.
timeZone

string

Opcional. Indica la zona horaria para las fechas de inicio y finalización del informe. Si no se especifica, el valor predeterminado es 'UTC'.
destTable

string

Tabla de destino de BigQuery para resultados de consulta con el formato 'project.dataset.table_name'. Si se especifica, el proyecto debe incluirse explícitamente en la lista blanca para la cuenta de ADH del cliente. Si no se especifica un proyecto, usa el proyecto predeterminado para el cliente proporcionado. Si no se especifica ni el proyecto ni el conjunto de datos, usa el proyecto y el conjunto de datos predeterminados.
Campo de unión platform_dimensions. La plataforma sobre la que se quiere crear informes mediante una división opcional específica. Si no seleccionas una plataforma, se producirá un error. Las direcciones (platform_dimensions) solo pueden ser una de las siguientes opciones:
googleAdsDimensions

object (GoogleAdsDimensions)

Informe sobre la plataforma de Google Ads
dv360YoutubeDimensions

object (Dv360Dimensions)

Informe sobre la plataforma DV360
ytReserveDimensions

object (YouTubeReserveDimensions)

Informe sobre la plataforma YTR

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Dimensiones de Google Ads

Filtra las dimensiones para la plataforma de Google Ads.

Representación JSON 
{
  "campaignIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Campos
campaignIds[]

string (int64 format)

ID opcionales de la campaña de Google Ads Si está vacía, informa sobre todas las campañas durante el período especificado.
metricType

enum (MetricType)

Designa la plataforma para realizar mediciones y generar informes.

MetricType

Designa la plataforma para realizar mediciones y generar informes.

Enumeradores
METRIC_TYPE_UNSPECIFIED Tipo de métrica no especificado.
METRIC_TYPE_IMPRESSION Datos de impresiones de Google Ads
METRIC_TYPE_YOUTUBE_VIEW Las vistas de YouTube, también conocidas como vistas TrueView

Dimensiones de DV360

Filtra las dimensiones para la plataforma DV360.

Representación JSON 
{
  "lineItemIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Campos
lineItemIds[]

string (int64 format)

ID de líneas de pedido de DV360 opcionales. Si está vacío, informa sobre todas las líneas de pedido durante el período especificado.
metricType

enum (MetricType)

Designa la plataforma para realizar mediciones y generar informes.

YouTubeReserveDimensions

Filtrado de dimensiones para la plataforma de YouTube Reserve.

Representación JSON 
{
  "orderIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Campos
orderIds[]

string (int64 format)

ID de pedido opcionales de YouTube Reserve. Si está vacío, informa sobre todos los pedidos durante el período especificado.
metricType

enum (MetricType)

Designa la plataforma para realizar mediciones y generar informes.