На этой странице представлены примечания к выпуску API Google Bid Manager.
Последняя версия API: v2.
20 ноября 2024 г.
Новые возможности
Запускается FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID
. Это позволяет включать данные с более низким уровнем достоверности для показателей со следующими префиксами:
-
METRIC_UNIQUE_REACH_
-
METRIC_VIRTUAL_PEOPLE_DUPLICATE_
-
METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_
-
METRIC_VIRTUAL_PEOPLE_OVERLAP_
При использовании этого фильтра необходимо включить одну из соответствующих метрик.
При запуске запросы, которые не включают этот фильтр, по умолчанию будут использовать предыдущее поведение по умолчанию, включающее только данные высокой достоверности. Начиная с 4 февраля 2025 г. , запросы, не включающие этот фильтр, по умолчанию будут включать данные с низким уровнем достоверности.
v2
Добавлены следующие фильтры:
Тип фильтра Доступные значения FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID
0
: Включить данные с низкой достоверностью. (По умолчанию после 4 февраля 2025 г. )1
: включать только данные высокой достоверности. (По умолчанию до 4 февраля 2025 г. )
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
заменен synchronous
asynchronous
Упрощен поиск отчетов за счет следующих изменений:
- Добавление метода
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 для устаревших версий, ознакомьтесь с нашими архивными примечаниями к выпуску .
,На этой странице представлены примечания к выпуску API Google Bid Manager.
Последняя версия API: v2.
20 ноября 2024 г.
Новые возможности
Запускается FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID
. Это позволяет включать данные с более низким уровнем достоверности для показателей со следующими префиксами:
-
METRIC_UNIQUE_REACH_
-
METRIC_VIRTUAL_PEOPLE_DUPLICATE_
-
METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_
-
METRIC_VIRTUAL_PEOPLE_OVERLAP_
При использовании этого фильтра необходимо включить одну из соответствующих метрик.
При запуске запросы, которые не включают этот фильтр, по умолчанию будут использовать предыдущее поведение по умолчанию, включающее только данные высокой достоверности. Начиная с 4 февраля 2025 г. , запросы, не включающие этот фильтр, по умолчанию будут включать данные с низким уровнем достоверности.
v2
Добавлены следующие фильтры:
Тип фильтра Доступные значения FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID
0
: Включить данные с низкой достоверностью. (По умолчанию после 4 февраля 2025 г. )1
: включать только данные высокой достоверности. (По умолчанию до 4 февраля 2025 г. )
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
заменен synchronous
asynchronous
Упрощен поиск отчетов за счет следующих изменений:
- Добавление метода
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 для устаревших версий, ознакомьтесь с нашими архивными примечаниями к выпуску .
,На этой странице представлены примечания к выпуску API Google Bid Manager.
Последняя версия API: v2.
20 ноября 2024 г.
Новые возможности
Запускается FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID
. Это позволяет включать данные с более низким уровнем достоверности для показателей со следующими префиксами:
-
METRIC_UNIQUE_REACH_
-
METRIC_VIRTUAL_PEOPLE_DUPLICATE_
-
METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_
-
METRIC_VIRTUAL_PEOPLE_OVERLAP_
При использовании этого фильтра необходимо включить одну из соответствующих метрик.
При запуске запросы, которые не включают этот фильтр, по умолчанию будут использовать предыдущее поведение по умолчанию, включающее только данные высокой достоверности. Начиная с 4 февраля 2025 г. , запросы, не включающие этот фильтр, по умолчанию будут включать данные с низким уровнем достоверности.
v2
Добавлены следующие фильтры:
Тип фильтра Доступные значения FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID
0
: Включить данные с низкой достоверностью. (По умолчанию после 4 февраля 2025 г. )1
: включать только данные высокой достоверности. (По умолчанию до 4 февраля 2025 г. )
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
заменен synchronous
asynchronous
Упрощен поиск отчетов за счет следующих изменений:
- Добавление метода
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 для устаревших версий, ознакомьтесь с нашими архивными примечаниями к выпуску .
,На этой странице представлены примечания к выпуску API Google Bid Manager.
Последняя версия API: v2.
20 ноября 2024 г.
Новые возможности
Запускается FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID
. Это позволяет включать данные с более низким уровнем достоверности для метрик со следующими префиксами:
-
METRIC_UNIQUE_REACH_
-
METRIC_VIRTUAL_PEOPLE_DUPLICATE_
-
METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_
-
METRIC_VIRTUAL_PEOPLE_OVERLAP_
При использовании этого фильтра необходимо включить одну из соответствующих метрик.
При запуске запросы, которые не включают этот фильтр, по умолчанию будут использовать предыдущее поведение по умолчанию, включающее только данные высокой достоверности. Начиная с 4 февраля 2025 г. , запросы, не включающие этот фильтр, по умолчанию будут включать данные с низким уровнем достоверности.
v2
Добавлены следующие фильтры:
Тип фильтра Доступные значения FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID
0
: Включить данные с низкой достоверностью. (по умолчанию после 4 февраля 2025 г. )1
: включать только данные высокой достоверности. (По умолчанию до 4 февраля 2025 г. )
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
заменен synchronous
asynchronous
Упрощен поиск отчетов за счет следующих изменений:
- Добавление метода
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 для устаревших версий, ознакомьтесь с нашими архивными примечаниями к выпуску .