Method: customers.generateIvtReport

Запускает выполнение запроса для получения ежедневной сводки о количестве недействительного трафика для определенной платформы. Результаты будут записаны в указанную целевую таблицу BigQuery. Возвращенное имя операции можно использовать для опроса статуса завершения запроса.

Выходная таблица содержит 5 строк для каждого дня в диапазоне дат. По 1 строке для каждого из 4 типов устройств и по 1 строке для всех типов устройств. Строка All представляет собой сумму 4 типов устройств за этот день. В результате каждый столбец содержит удвоенное общее количество показов. Если ADH редактирует строки из-за ограничений конфиденциальности, сводка отфильтрованных строк (строка без дня) будет содержать сумму отредактированных строк.

HTTP-запрос

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

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
name

string

Клиент Ads Data Hub, делающий запрос. Это в форме «клиенты/[customerId]». например, «клиенты/123».

Тело запроса

Тело запроса содержит данные со следующей структурой:

Представление 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.
}
Поля
adsDataCustomerId

string ( int64 format)

Идентификатор клиента Linked Ads Data Hub, которому принадлежат рекламные данные.

startDate

object ( Date )

Первый день сформированного отчета.

endDate

object ( Date )

Последний день сформированного отчета включительно.

timeZone

string

По желанию. Часовой пояс для дат начала и окончания отчета. Если не указано, по умолчанию используется «UTC».

destTable

string

Целевая таблица BigQuery для результатов запроса в формате «project.dataset.table_name». Если указано, проект должен быть явно внесен в белый список для учетной записи ADH клиента. Если проект не указан, используется проект по умолчанию для указанного клиента. Если ни проект, ни набор данных не указаны, используются проект и набор данных по умолчанию.

Объединение полей platform_dimensions . Платформа для создания отчета с дополнительной нарезкой для конкретной платформы. Невыбор платформы приведет к ошибке. platform_dimensions может быть только одним из следующих:
googleAdsDimensions

object ( GoogleAdsDimensions )

Отчет по платформе Google Ads.

dv360YoutubeDimensions

object ( Dv360Dimensions )

Отчет по платформе DV360.

ytReserveDimensions

object ( YouTubeReserveDimensions )

Отчет на платформе YTR.

Тело ответа

В случае успеха тело ответа содержит экземпляр Operation .

Области авторизации

Требуется следующая область действия OAuth:

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

GoogleAdsDimensions

Параметры фильтрации для платформы Google Ads.

Представление JSON
{
  "campaignIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Поля
campaignIds[]

string ( int64 format)

Необязательные идентификаторы кампаний Google Рекламы. Если пусто, отчеты по всем кампаниям за указанный период времени.

metricType

enum ( MetricType )

Назначает платформу для измерения и отчета.

Тип Метрики

Назначает платформу для измерения и отчета.

перечисления
METRIC_TYPE_UNSPECIFIED Неуказанный тип метрики.
METRIC_TYPE_IMPRESSION Данные о показах Google Ads.
METRIC_TYPE_YOUTUBE_VIEW Просмотры YouTube, также известные как просмотры TrueView.

Dv360Размеры

Измерения фильтрации для платформы DV360.

Представление JSON
{
  "lineItemIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Поля
lineItemIds[]

string ( int64 format)

Необязательные идентификаторы позиций DV360. Если пусто, отчеты по всем позициям за указанный период времени.

metricType

enum ( MetricType )

Назначает платформу для измерения и отчета.

YouTubeReserveDimensions

Параметры фильтрации для платформы YouTube Reserve.

Представление JSON
{
  "orderIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Поля
orderIds[]

string ( int64 format)

Необязательные идентификаторы заказов YouTube Reserve. Если пусто, сообщает обо всех заказах за указанный период времени.

metricType

enum ( MetricType )

Назначает платформу для измерения и отчета.