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

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

Перейдите на нашу главную страницу примечаний к выпуску для всех выпусков и живых версий.

15 апреля 2021 г.

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

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

v1.1

Прекращение использования служб SDF и отдельных позиций

Службы SDF и отдельных позиций больше не поддерживаются.

Пользователи, которые хотят загружать файлы структурированных данных или управлять позициями, должны вместо этого использовать API Display & Video 360 .

Известные вопросы

Никто.

6 августа 2020 г.

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

v1.1

Отчеты о пути и атрибуции пути

report types TYPE_PATH и TYPE_PATH_ATTRIBUTION теперь доступны.

Сюда входит добавление нового поля params.options.pathQueryOptions (которое содержит поля pathFilters и channelGrouping ) для query ресурсов и report .

Добавлены новые Filters :

  • FILTER_CHANNEL_GROUPING
  • FILTER_EVENT_TYPE
  • FILTER_PATH_EVENT_INDEX
  • FILTER_PATH_PATTERN_ID

Добавлены новые Metrics :

  • METRIC_ACTIVITY_REVENUE
  • METRIC_CONVERTING_PATHS
  • METRIC_EXPOSURE_CONVERSION_RATE
  • METRIC_LAST_TOUCH_CLICK_THROUGH_CONVERSIONS
  • METRIC_LAST_TOUCH_TOTAL_CONVERSIONS
  • METRIC_LAST_TOUCH_VIEW_THROUGH_CONVERSIONS
  • METRIC_PATH_CONVERSION_RATE
  • METRIC_PROVISIONAL_IMPRESSIONS
  • METRIC_TOTAL_EXPOSURES
  • METRIC_TOTAL_PATHS

Известные вопросы

Никто.

20 марта 2020 г.

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

v1.1

Асинхронный запуск запроса

Методы Queries.createquery и Queries.runquery теперь позволяют выполнять запросы асинхронно.

Дополнительные сведения см. в новом asynchronous параметре в createquery и runquery .

Известные вопросы

Никто.

14 января 2020 г.

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

v1.1

Время начала расписания запроса

Метод Queries.createquery теперь позволяет указать дату начала расписания выполнения запроса.

Дополнительные сведения см. в новом поле schedule.startTimeMs .

Известные вопросы

Никто.

8 января 2020 г.

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

v1.1

Переключить данные списков целевой аудитории

Метод Queries.createquery теперь позволяет указать, следует ли ограничивать данные списка аудитории конкретными заказами на размещение или позициями.

Дополнительные сведения см. в новом поле params.options.includeOnlyTargetedUserLists .

Известные вопросы

Никто.

19 ноября 2019 г.

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

v1.1

Фильтр «один к одному» для отображения сопоставления столбцов отчета

Фильтры, сопоставленные с несколькими столбцами отчета, теперь сопоставляются с отдельными столбцами.

Например, в версии 1 включение фильтра FILTER_ADVERTISER дает отчет со столбцами «Рекламодатель» в дополнение к «Идентификатор рекламодателя». В версии 1.1 все столбцы отчета имеют собственные фильтры. Например, новый фильтр FILTER_ADVERTISER_NAME соответствует «Рекламодателю». Чтобы получить в отчетах столбцы «Идентификатор рекламодателя» и «Рекламодатель», в запросы Queries.createquery необходимо включить оба фильтра FILTER_ADVERTISER и FILTER_ADVERTISER_NAME соответственно.

Более конкретно, запрос createquery :

{
...
"params": {
  ...
  "groupBys": ["FILTER_ADVERTISER"],
  "metrics": ["METRIC_IMPRESSIONS"],
  ...
}
...
}

генерирует файл отчета со следующими заголовками в версии 1:

Advertiser,Advertiser ID,Advertiser Status,Advertiser Integration Code,Impressions

и следующие заголовки в версии 1.1:

Advertiser,Impressions

Следующий код версии 1 используется для получения столбцов отчета:

List<String> groupBys = new ArrayList<>();
groupBys.add("FILTER_ADVERTISER");
List<String> metrics = new ArrayList<>();
metrics.add("METRIC_IMPRESSIONS");
com.google.api.services.doubleclickbidmanager.model.Parameters createQueryParameters =
    new com.google.api.services.doubleclickbidmanager.model.Parameters()
        .setGroupBys(groupBys)
        .setMetrics(metrics);

необходимо будет изменить аналогично следующему в версии 1.1 (примечание о порядке фильтров):

List<String> groupBys = new ArrayList<>();
groupBys.add("FILTER_ADVERTISER_NAME");
groupBys.add("FILTER_ADVERTISER");
groupBys.add("FILTER_ADVERTISER_INTEGRATION_STATUS");
groupBys.add("FILTER_ADVERTISER_INTEGRATION_CODE");
List<String> metrics = new ArrayList<>();
metrics.add("METRIC_IMPRESSIONS");
com.google.api.services.doubleclickbidmanager.model.Parameters createQueryParameters =
    new com.google.api.services.doubleclickbidmanager.model.Parameters()
        .setGroupBys(groupBys)
        .setMetrics(metrics);
Оригинальный фильтр Добавлены фильтры
FILTER_ADVERTISER FILTER_ADVERTISER_NAME
FILTER_ADVERTISER_INTEGRATION_CODE
FILTER_ADVERTISER_INTEGRATION_STATUS
FILTER_AD_POSITION FILTER_AD_POSITION_NAME
FILTER_CARRIER FILTER_CARRIER_NAME
FILTER_CHANNEL_ID FILTER_CHANNEL_NAME
FILTER_CITY FILTER_CITY_NAME
FILTER_COMPANION_CREATIVE_ID FILTER_COMPANION_CREATIVE_NAME
FILTER_DMA FILTER_DMA_NAME
FILTER_INSERTION_ORDER FILTER_INSERTION_ORDER_NAME
FILTER_PARTNER FILTER_PARTNER_NAME
FILTER_PARTNER_STATUS
FILTER_REGION FILTER_REGION_NAME
FILTER_TRUEVIEW_DMA FILTER_TRUEVIEW_DMA_NAME
FILTER_TRUEVIEW_IAR_REGION FILTER_TRUEVIEW_IAR_REGION_NAME
FILTER_USER_LIST_FIRST_PARTY FILTER_USER_LIST_FIRST_PARTY_NAME
FILTER_USER_LIST_THIRD_PARTY FILTER_USER_LIST_THIRD_PARTY_NAME
Пагинация

Версия 1.1 добавляет нумерацию страниц в методы Queries.listqueries и Reports.listreports .

В версии 1.1 количество результатов, возвращаемых этими методами, равно недавно добавленному параметру pageSize (по умолчанию оно равно 100 , если не указано иное). Ответы содержат недавно добавленное поле nextPageToken , которое можно использовать для получения следующего набора результатов. Это поле пустое, если результаты исчерпаны.

Следующий код версии 1 для получения всех отчетов, принадлежащих определенному запросу:

public class GetReports {
  public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
    ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();

    return reportListResponse.getReports();
  }
}

необходимо будет изменить аналогично следующему в версии 1.1, чтобы продолжить получение всех отчетов:

public class GetReports {
  public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
    ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();

    List<Report> reports = new ArrayList<>(reportListResponse.getReports());
    while (reportListResponse.getNextPageToken() != null
        && reportListResponse.getNextPageToken().length() > 0) {
      // Get next set, or page, of results.
      reportListResponse =
          service
              .reports()
              .listreports(queryId)
              .setPageToken(reportListResponse.getNextPageToken())
              .execute();
      reports.addAll(reportListResponse.getReports());
    }

    return reports;
  }
}

Дополнительные сведения см. в документации по методам Queries.listqueries и Reports.listreports .

Известные вопросы

Никто.