Пример отчета о статистике кампании

Ниже показан пример отчета в формате XML.

<?xml version="1.0" encoding="UTF-8" ?>
<report> 
   <reportID>1234</reportID>
   <campaignID>1234567</campaignID>
   <startDate>2013-05-01</startDate>
   <endDate>2013-05-31</endDate>
   <phrasesDict>
      <phrase type="phrase" phraseID="2" value="морозильное оборудование" />
      <phrase type="retargeting" DictID="912" value="ретаргетинг: незавершенный заказ" />
   </phrasesDict>
   <stat>
      <row bannerID="123456"
           phraseID{stat}="2"
           statDate="2013-05-15"
           sum_search="10"
           sum_context="2"
           shows_search="1000"
           shows_context="123"
           clicks_search="100"
           clicks_context="23"
           sum="12"
           shows="1234"
           clicks="123"
           regionID="1"
           placeName="Яндекс"
           placeType="search"
           goal_id="18565"
           goal_conversion="25.91"
           goal_cost="1.54"
           session_depth="9.35"
           goal_conversions_num="28"  
           position_type="premium"
           stat_type="Text"
           shows_average_position="4.87"
           clicks_average_position="4.95"/>
      <row bannerID="123457"
           DictID{stat}="912"
           RetargetingID="3097"  
           statDate="2013-05-25"
           sum_search="0"
           sum_context="96.35"
           shows_search="0"
           shows_context="755"
           clicks_search="0"
           clicks_context="57"
           sum="96.35"
           shows="755"
           clicks="57"
           regionID="1"
           placeName="catalog.tut.by"
           placeType="context"
           goal_id="18777"
           goal_conversion="28.88"
           session_depth="9.39"
           position_type="other"
           stat_type="Image"/>
   </stat>
</report>

Ниже приведено описание элементов отчета.

Элемент/атрибут Описание Условие вывода
Элемент report
reportID Идентификатор отчета.
campaignID Идентификатор кампании.
startDate Начальная дата отчетного периода, YYYY-MM-DD.
endDate Конечная дата отчетного периода, YYYY-MM-DD.
phrasesDict Словарь фраз. Содержит информацию об объектах в отчете: фразах, рубриках Яндекс.Каталога, ретаргетингах, условиях нацеливания для динамических текстовых объявлений.
stat Статистические данные.
Элемент phrasesDict
phrase Информация о фразе, рубрике или ретаргетинге в атрибутах type, phraseID, DictID, value.
type Содержит значение «phrase» в записях о фразах, или «rubric» в записях о рубриках Яндекс.Каталога, или «retargeting» в записях о ретаргетингах.
phraseID

Идентификатор фразы в отчете.

Идентификатор phraseID существует только внутри отчета и не совпадает с идентификатором фразы в Директе. Он служит для нормализации данных в отчете и связывает элементы phrase и row.

rubricID

Идентификатор рубрики в отчете.

Существует только внутри отчета и не совпадает с идентификатором рубрики в Директе. Служит для нормализации данных в отчете и связывает элементы phrase и row.

DictID

Идентификатор ретаргетинга в отчете.

Существует только внутри отчета и не совпадает с идентификатором ретаргетинга в Директе. Служит для нормализации данных в отчете и связывает элементы phrase и row.

value Текст фразы, или номер рубрики Яндекс.Каталога, или описание ретаргетинга в отчете.
Элемент stat
row Статистика по фразе за один день отчетного периода.
sum

Стоимость кликов, списанная с баланса кампании 1 .

shows Количество показов 1 .
clicks Количество кликов 1 .
bannerID Идентификатор объявления. Во входном параметре GroupByColumns указано значение «clBanner» или «clImage».
phraseID

Идентификатор фразы в отчете (см. элемент phrasesDict).

Идентификатор phraseID существует только внутри отчета и не совпадает с идентификатором фразы в Директе. Он служит для нормализации данных в отчете и связывает элементы phrase и row.

Во входном параметре GroupByColumns указано значение «clPhrase» и запись содержит информацию о фразе (не о рубрике и не о ретаргетинге).

rubricID

Идентификатор рубрики Яндекс.Каталога в отчете (см. элемент phrasesDict).

Существует только внутри отчета и не совпадает с идентификатором рубрики в Директе. Служит для нормализации данных в отчете и связывает элементы phrase и row.

Во входном параметре GroupByColumns указано значение «clPhrase» и запись содержит информацию о рубрике Яндекс.Каталога.

DictID

Идентификатор ретаргетинга в отчете (см. элемент phrasesDict).

Существует только внутри отчета и не совпадает с идентификатором ретаргетинга в Директе. Служит для нормализации данных в отчете и связывает элементы phrase и row.

Во входном параметре GroupByColumns указано значение «clPhrase» и запись содержит информацию о ретаргетинге.

RetargetingID Идентификатор ретаргетинга в Директе. Во входном параметре GroupByColumns указано значение «clPhrase» и запись содержит информацию о ретаргетинге.
statDate Дата, за которую приведена статистика. Если входной параметр GroupByDate имеет значение «week» или «month», указывается первая дата недели или месяца соответственно. В массиве GroupByColumns присутствует значение «clDate».
sum_search

Стоимость кликов на поиске.

Входной параметр PageType не задан или имеет значение «all».
sum_context

Стоимость кликов в Рекламной сети Яндекса.

shows_search

Количество показов на поиске.

shows_context Количество показов в Рекламной сети Яндекса.
clicks_search Количество кликов на поиске.
clicks_context Количество кликов в Рекламной сети Яндекса.
regionID Идентификатор региона показов. В массиве GroupByColumns присутствует значение «clGeo».
placeName Название площадки показов. В массиве GroupByColumns присутствует значение «clPage».
placeType Тип площадки показов: «search» — поисковая площадка (включая поиск Яндекса и поисковые площадки в Рекламной сети Яндекса), «context» — сайт в Рекламной сети Яндекса.
goal_id

Идентификатор цели в Яндекс.Метрике, если он был передан во входном параметре StatGoals.

0 — если идентификатор не был передан. В этом случае остальные показатели из Яндекс.Метрики содержат агрегированные данные по всем целям.

В массиве GroupByColumns присутствует значение «clStatGoals».

goal_conversion Доля целевых визитов в общем числе визитов, в процентах.
goal_cost Средняя цена целевого визита: отношение выручки к количеству целевых визитов.
session_depth Глубина просмотра сайта.
goal_conversions_num

Количество целевых визитов (конверсий).

В массиве GroupByColumns присутствует значение «clGoalConversionsNum».

position_type

Блок показа объявления: «premium» — спецразмещение, «other» — другие блоки.

В массиве GroupByColumns присутствует значение «clPositionType».
stat_type Тип показа объявления: с изображением или без. Возможные значения: Image/Text. В массиве GroupByColumns присутствует значение «clImage».
shows_average_position

Средняя позиция показа объявления. При расчете учитываются только показы на первой странице результатов поиска Яндекса.

Наивысшая позиция имеет номер 1.

В массиве GroupByColumns присутствует значение «clAveragePosition».
clicks_average_position Средняя позиция, на которой произошел клик по объявлению. При расчете учитываются только клики на первой странице результатов поиска Яндекса.
Примечания
  1. Значения параметров sum, shows, clicks зависят от входного параметра PageType:

    • при значении «all» или отсутствии PageType приводятся суммарные данные по поиску и Рекламной сети Яндекса. При этом данные отдельно по поиску и отдельно по Рекламной сети приводятся в параметрах sum_search, shows_search, clicks_search, sum_context, shows_context, clicks_context);
    • при значении «search» приводятся данные по поиску и поисковым площадкам в Рекламной сети Яндекса;
    • при значении «context» приводятся данные по сайтам в Рекламной сети Яндекса, кроме поисковых площадок.