Method: customers.generateIvtReport

Starts the execution of a query to retrieve a day-by-day summary of invalid traffic counts for a specific platform. The results will be written to the specified BigQuery destination table. The returned operation name can be used to poll for query completion status.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Ads Data Hub customer making the request. This is in the form of 'customers/[customerId]'. e.g. 'customers/123'.

Request body

The request body contains data with the following structure:

JSON representation
{
  "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.
}
Fields
adsDataCustomerId

string (int64 format)

Linked Ads Data Hub customer ID that owns the ads data.

startDate

object (Date)

The first day of the generated report.

endDate

object (Date)

The last day of the generated report, inclusive.

timeZone

string

Optional. The time zone for the report start and end dates. If not specified, defaults to 'UTC'.

destTable

string

Destination BigQuery table for query results with the format 'project.dataset.table_name'. If specified, the project must be explicitly whitelisted for the customer's ADH account. If project is not specified, uses default project for the provided customer. If neither project nor dataset is specified, uses the default project and dataset.

Union field platform_dimensions. The platform to report on with optional platform-specific slicing. Not selecting a platform will result in an error. platform_dimensions can be only one of the following:
googleAdsDimensions

object (GoogleAdsDimensions)

Report on platform Google Ads.

dv360YoutubeDimensions

object (Dv360Dimensions)

Report on platform DV360.

ytReserveDimensions

object (YouTubeReserveDimensions)

Report on platform YTR.

Response body

If successful, the response body contains an instance of Operation.

Authorization Scopes

Requires the following OAuth scope:

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

GoogleAdsDimensions

Filtering dimensions for Google Ads platform.

JSON representation
{
  "campaignIds": [
    string
  ]
}
Fields
campaignIds[]

string (int64 format)

Optional Google Ads campaign ids. If empty, reports on all campaigns for the specified time period.

Dv360Dimensions

Filtering dimensions for DV360 platform.

JSON representation
{
  "lineItemIds": [
    string
  ]
}
Fields
lineItemIds[]

string (int64 format)

Optional DV360 line item ids. If empty, reports on all line items for the specified time period.

YouTubeReserveDimensions

Filtering dimensions for YouTube Reserve platform.

JSON representation
{
  "orderIds": [
    string
  ]
}
Fields
orderIds[]

string (int64 format)

Optional YouTube Reserve order ids. If empty, reports on all orders for the specified time period.