Примечания к выпускам

На этой странице представлены примечания к выпуску API Google Bid Manager.

Последняя версия API: v2.

1 октября 2024 г.

Новые возможности

Никто.

Известные проблемы

v2

Прекращение действия отчетного параметра анонимного моделирования запасов (AIM)

Измерение FILTER_ANONYMOUS_INVENTORY_MODELING — это закат.

Создание или запуск ресурсов Query с использованием значений заката в params.groupBy возвращает ошибку 400 .

Показатели DST/ROC (регуляторные эксплуатационные расходы) и общая стоимость рекламы стали несовместимы с отчетами YOUTUBE .

Следующие значения показателей больше нельзя использовать в отчетах YOUTUBE :

• METRIC_TOTAL_MEDIACOST_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPC_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPAPC_USD
• METRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPV_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPAPV_USD
• METRIC_TOTAL_MEDIACOST_ECPA_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPA_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPA_USD
• METRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPCV_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPCV_USD
• METRIC_TOTAL_MEDIACOST_ECPC_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPC_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPC_USD
• METRIC_TOTAL_MEDIACOST_ECPM_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPM_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPM_USD
• METRIC_TOTAL_MEDIACOST_PARTNER
• METRIC_TOTAL_MEDIACOST_USD
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISER
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNER
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USD
• METRIC_FEE32_ADVERTISER
• METRIC_FEE32_PARTNER
• METRIC_FEE32_USD

Создание или запуск ресурсов Query с params.type YOUTUBE и соответствующим значением метрики в params.metrics возвращает ошибку 400 .

1 мая 2024 г.

Новые возможности

Никто.

Известные проблемы

v2

Прекращение поддержки отчетов о полном пути и атрибуции пути

Отчеты «Полный путь» и «Атрибуция пути» больше не поддерживаются. Получение или создание ресурсов Query и Report этих типов приводит к ошибке.

Следующие значения ReportType устарели:

• FULL_PATH
• PATH_ATTRIBUTION

Поле pathQueryOptions объекта Options также устарело.

28 февраля 2024 г.

Новые возможности

Никто.

Известные проблемы

v2

Прекращение действия значений показателей конверсии в результате взаимодействий на нескольких устройствах.

Показатели конверсии между устройствами устарели. Включены следующие значения показателей Bid Manager API:

• METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENT
• METRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENT
• METRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENT
• METRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENT
• METRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT

6 июля 2022 г.

Новые возможности

Выпущен Bid Manager API v2.

Внесены структурные изменения в API, включая обновление конечной точки службы и переименование служб и методов.

Значительно обновлены ресурсы запросов и отчетов за счет удаления ненужных полей, реорганизации существующих полей и изменения типов полей. Это включает в себя изменение типов полей для использования именованных объектов вместо общего определения «вложенного объекта».

Требуется выполнять специальные запросы с использованием метода queries.run вместо их автоматического запуска после создания.

Параметр запроса queries.run заменен asynchronous synchronous .

Упрощен поиск отчетов за счет следующих изменений:

• Добавление метода queries.reports.get .
• Добавление параметра запроса orderBy в queries.reports.list .
• Обновление тела ответа queries.run с пустого объекта на экземпляр созданного ресурса Report .

Обновлены сообщения об ошибках, возвращаемые API, чтобы быть более конкретными и предоставлять более предписывающие решения.

Следуйте инструкциям, представленным в Руководстве по миграции версии 2, для перехода с версии 1.1 на версию 2.

v2

• Конечная точка службы была изменена:

  конечная точка службы v1	конечная точка службы v2
  https://www.googleapis.com/doubleclickbidmanager	https://doubleclickbidmanager.googleapis.com

• Службы переименованы следующим образом:

  v1 сервис	служба v2
  Запросы	запросы
  Отчеты	запросы.отчеты

• Методы были переименованы следующим образом:

  метод v1	метод v2
  Запросы.createquery	запросы.создать
  Запросы.deletequery	запросы.удалить
  Запросы.getquery	запросы.get
  Запросы.listqueries	запросы.список
  Запросы.runquery	запросы.run
  Отчеты.listreports	запросы.reports.list

• Добавлены следующие методы:

  Услуга	Метод(ы)
  запросы.отчеты	получать

• Следующие методы имеют новое тело ответа:

  Метод	Новый объект тела ответа
  запросы.run	Отчет

• Следующие поля были удалены:

  Ресурс	Поле(а)
  queries.list Тело ответа	добрый
  queries.reports.list Тело ответа	добрый
  Запрос	добрый отчетдатаендтимемс отчетдатастарттимемс часовой поясКод
  Запустить запросрекуест	отчетдатаендтимемс отчетдатастарттимемс часовой поясКод

• Тип объекта следующих полей был изменен на следующий:

  Ресурс	Поле(а)	Тип объекта
  Запрос	метаданные параметры расписание	Метаданные запроса Параметры Расписание запросов
  Отчет	ключ метаданные параметры	Ключ отчета Метаданные отчета Параметры
  Запустить запросрекуест	диапазон данных	Диапазон данных

• Были добавлены следующие параметры запроса метода:

  Метод	Параметры запроса
  запросы.список	заказать по
  запросы.reports.list	заказать по
  запросы.run	синхронный

• Следующие параметры запроса метода были удалены:

  Метод	Параметры запроса
  запросы.создать	асинхронный
  запросы.run	асинхронный

• Были добавлены следующие значения фильтра:

  Значение фильтра
  FILTER_INVENTORY_MEDIA_COST_TYPE
  FILTER_TARGETING_EXPANSION

• Следующие значения фильтра были удалены:

  Значение фильтра
  FILTER_TRUEVIEW_IAR_REGION

• Были добавлены следующие значения Метрики:

  Значение показателя
  METRIC_STORE_VISIT_VIEW_THROUGH_CONVERSIONS
  METRIC_UNIQUE_REACH_AVERAGE_VIEWABLE_IMPRESSION_FREQUENCY
  METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_CROSS_STACK_FCAP
  METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_PG_FMGMT
  METRIC_UNIQUE_REACH_INCREMENTAL_CLICK_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_IMPRESSION_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_TOTAL_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_VIEWABLE_IMPRESSION_REACH
  METRIC_UNIQUE_REACH_VIEWABLE_IMPRESSION_REACH

Известные проблемы

Никто.

Предыдущие выпуски

Чтобы узнать о предыдущих выпусках API Bid Manager для устаревших версий, ознакомьтесь с нашими архивными примечаниями к выпуску .