На этой странице представлены примечания к выпуску 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 Запросы запросы Отчеты запросы.отчеты Методы были переименованы следующим образом:
Добавлены следующие методы:
Услуга Метод(ы) запросы.отчеты получать Следующие методы имеют новое тело ответа:
Метод Новый объект тела ответа запросы.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 для устаревших версий, ознакомьтесь с нашими архивными примечаниями к выпуску .