Особенности работы с RTB Troubleshooting API

Небольшая доля сделок в рамках гарантированных кампаний с алгоритмической продажей выполняется в сервисе "Авторизованные покупатели" не полностью из-за того, что данные о числе оплачиваемых показов в нем и на платформе покупателя различаются.

Чтобы выявить сделки с ошибками, воспользуйтесь RTB Troubleshooting API. С его помощью вы сможете получить данные о числе оплачиваемых показов и, сопоставив отчеты в сервисе "Авторизованные покупатели" и на платформе покупателя, определить сделки с наибольшим количеством расхождений. Оплачиваемыми называются показы, за выполнение которых с покупателя взимается плата.

Чтобы рассчитать сумму расходов, умножьте число оплачиваемых показов на цену за тысячу показов, заданную для сделки.

Шаг 1

При помощи метода bidders.accounts.filterSets.create создайте набор фильтров, предназначенный для аккаунта с данным идентификатором.

1. Установите нужные значения для параметров ownerName, isTransient и filterSet в запросе (см. пример ниже).

Пример ownerName -> "bidders/48446606/accounts/48446606" isTransient -> true filterSet -> {   "dealId": 12345,   "relativeDateRange": {     "durationDays": 30,     "offsetDays": 0   },   "name": "bidders/48446606/filterSets/12345",   "timeSeriesGranularity": "HOURLY" }

Если набор фильтров предназначен для кратковременного использования, установите для параметра isTransient значение true. 

2. Для фильтрации внутри набора фильтров установите параметр dealId.

3. Установите для параметра relativeDateRange значение в пределах 30 дней.

RTB Troubleshooting API поддерживает только показатели за период не дольше 30 дней.

4. Для разбивки результатов по часу или дню используйте параметр timeSeriesGranularity.

5. Запишите название набора фильтров сразу после того, как создадите его.

Шаг 2

Запросите показатели ставок с помощью метода bidders.accounts.filterSets.bidMetrics.list.

1. Укажите название набора фильтров из поля filterSet, который вы создали на шаге 1, например bidders/48446606/filterSets/12345. При необходимости укажите размер страницы.
2. Если значение параметра timeSeriesGranularity не задано, показатели ставок будут содержать одну строку. Если же для этого параметра будет указано несколько вариантов времени или дня, то данные о каждом варианте будут приведены в отдельной строке.

Например, при значении поля filterSet из шага 1 и значении pageSize, равном 2, ответ будет иметь следующий вид:

Пример

bid_metrics_rows {
  bids {
    value: 43731
  }
  bids_in_auction {
    value: 43731
  }
  impressions_won {
    value: 34369
  }
  billed_impressions {
    value: 31823
  }
  measurable_impressions {
    value: 31580
  }
  viewable_impressions {
    value: 22820
  }
  row_dimensions {
    time_interval {
      start_time {
        seconds: 1627023600

      }
      end_time {
        seconds: 1627027200
      }
    }
  }
  reached_queries {
    value: 34646
  }
}
bid_metrics_rows {
  bids {
    value: 37903
  }
  bids_in_auction {
    value: 37903
  }
  impressions_won {
    value: 30041
  }
  billed_impressions {
    value: 27974
  }
  measurable_impressions {
    value: 27747
  }
  viewable_impressions {
    value: 20026
  }
  row_dimensions {
    time_interval {
      start_time {
        seconds: 1627027200
      }
      end_time {
        seconds: 1627030800
      }
    }
  }
  reached_queries {
    value: 30329
  }
}
next_page_token: "CAoQwJODrfuI8gIYvdPy4IyJ8gI="

 

Каждый параметр bid_metrics_rows содержит объединенные данные за время или день, указанные для параметра time_interval. Чтобы получить результаты для следующей страницы, используйте параметр next_page_token.