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

На этой странице представлены примечания к выпуску 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
  Запросы	запросы
  Отчеты	запросы.отчеты

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

  метод 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 для устаревших версий, ознакомьтесь с нашими архивными примечаниями к выпуску .