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

Ниже показан пример отчета в формате 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» приводятся данные по сайтам в Рекламной сети Яндекса, кроме поисковых площадок.