Difference between revisions of "API"

From Service Manual Kadam.net
Jump to: navigation, search
Line 65: Line 65:
 
</pre>
 
</pre>
 
</code>
 
</code>
−
==Общая статистика.==
+
==Статистика по материалам==
−
В данном разделе можно ознакомиться с общей статистикой показов и переходов по рекламе за все время проведения кампаний или за интересующий период. А также узнать о количестве затраченных на кампанию средств и количестве конверсий по KSA кампаниям (рис.2).
+
Для получения статистики по кампании используется метод <b>ads.analytic.materials.get</b><br/>
−
[[Файл:a-stat2.png|alt=Общая статистика|centre|frame|рис. 2]]
+
 
 +
<table>
 +
  <tr bgcolor = #DCDCDC>
 +
      <th width = 130 align = left>Параметры</th>
 +
      <th width = 300 align = left>Значение</th>
 +
      <th width = 350 align = left>Дополнительные атрибуты</th>
 +
  </tr>
 +
  <tr bgcolor = #F5F5F5>
 +
      <td>campaign_id</td>
 +
      <td>id кампании</td>
 +
      <td>int (числовое значение), обязательный параметр</td>
 +
  </tr>
 +
  <tr bgcolor = #F5F5F5>
 +
      <td>period</td>
 +
      <td>Способ группировки данных по датам:
 +
          <p>1. day — статистика по дням;</p>
 +
          <p>2. month — статистика по месяцам;</p>
 +
          <p>Временные ограничения задаются параметрами date_from и date_to</p>
 +
      </td>
 +
      <td>обязательный параметр, строка</td>
 +
  </tr>
 +
  <tr bgcolor = #F5F5F5>
 +
      <td>date_from</td>
 +
      <td>Начальная дата выводимой статистики. Используется разный формат дат для разного значения параметра period:  
 +
          <p>1. day: YYYY-MM-DD, пример: 2011-09-27</p>
 +
          <p>2. month: YYYY-MM, пример: 2011-09</p>
 +
      </td>
 +
      <td>обязательный параметр, строка</td>
 +
  </tr>
 +
  <tr bgcolor = #F5F5F5>
 +
      <td>date_to</td>
 +
      <td>Конечная дата выводимой статистики. Используется разный формат дат для разного значения параметра period:
 +
          <p>1. day: YYYY-MM-DD, пример: 2011-09-27</p>
 +
          <p>2. month: YYYY-MM, пример: 2011-09</p>
 +
      </td>
 +
      <td>обязательный параметр, строка</td>
 +
  </tr>
 +
</table>
 +
<b>Результат:</b><br/>
 +
Возвращает объект с данными
 +
<code>
 +
<pre>
 +
{
 +
response: {
 +
count: %total items%
 +
items: {
 +
teaser_id
 +
date
 +
shows
 +
clicks
 +
ctr
 +
cpm
 +
money
 +
                      }
 +
                  }
 +
}
 +
 
 +
</pre>
 +
</code>
 
==Статистика по кампаниям.==
 
==Статистика по кампаниям.==
 
В данном разделе можно посмотреть статистику показов и переходов по всем кампаниям или по отдельно взятой кампании за интересующий период, но не более 45 дней.  
 
В данном разделе можно посмотреть статистику показов и переходов по всем кампаниям или по отдельно взятой кампании за интересующий период, но не более 45 дней.  

Revision as of 14:48, 2 November 2015

Статистика по кампании

Для получения статистики по кампании используется метод ads.analytic.campaign.get

Параметры Значение Дополнительные атрибуты
campaign_id id кампании int (числовое значение), обязательный параметр
region_id id региона int (числовое значение), обязательный параметр
period Способ группировки данных по датам:

1. day — статистика по дням;

2. month — статистика по месяцам;

Временные ограничения задаются параметрами date_from и date_to

 обязательный параметр, строка
date_from Начальная дата выводимой статистики. Используется разный формат дат для разного значения параметра period:

1. day: YYYY-MM-DD, пример: 2011-09-27

2. month: YYYY-MM, пример: 2011-09

Временные ограничения задаются параметрами date_from и date_to

 обязательный параметр, строка
date_to Конечная дата выводимой статистики. Используется разный формат дат для разного значения параметра period:

1. day: YYYY-MM-DD, пример: 2011-09-27

2. month: YYYY-MM, пример: 2011-09

Временные ограничения задаются параметрами date_from и date_to

 обязательный параметр, строка

Результат:
Возвращает объект с данными 

{
	response: {
		count: %total items%
		items: {
			shows
			clicks
			ctr
			cpm
			money
                       }
                  }
}

Статистика по материалам

Для получения статистики по кампании используется метод ads.analytic.materials.get

Параметры Значение Дополнительные атрибуты
campaign_id id кампании int (числовое значение), обязательный параметр
period Способ группировки данных по датам:

1. day — статистика по дням;

2. month — статистика по месяцам;

Временные ограничения задаются параметрами date_from и date_to

 обязательный параметр, строка
date_from Начальная дата выводимой статистики. Используется разный формат дат для разного значения параметра period:

1. day: YYYY-MM-DD, пример: 2011-09-27

2. month: YYYY-MM, пример: 2011-09

 обязательный параметр, строка
date_to Конечная дата выводимой статистики. Используется разный формат дат для разного значения параметра period:

1. day: YYYY-MM-DD, пример: 2011-09-27

2. month: YYYY-MM, пример: 2011-09

 обязательный параметр, строка

Результат:
Возвращает объект с данными 

{
	response: {
		count: %total items%
		items: {
			teaser_id
			date
			shows
			clicks
			ctr
			cpm
			money
                       }
                  }
}

Статистика по кампаниям.

В данном разделе можно посмотреть статистику показов и переходов по всем кампаниям или по отдельно взятой кампании за интересующий период, но не более 45 дней. Для ознакомления с детальной статистикой по регионам необходимо нажать на глобус (рис.3). Для ознакомления с детальной статистикой по рекламным материалам необходимо нажать на иконку нужной кампании. alt=статистика по кампаниям|centre|frame|рис. 3

Статистика по категориям.

Данный раздел позволит получить статистику по категориям площадок, на которых демонстрировались рекламные объявления по кампаниям за указанный период (рис.4).alt=статистика по категориям|centre|frame|рис. 4

Статистика по регионам.

В данном разделе можно посмотреть географию показов и переходов по всем кампаниям за интересующий период. Также в разделе предусмотрена возможность видеть данные о затраченных средствах в разрезе регионов (рис.5). alt=статистика по регионам|centre|frame|рис. 5

Статистика по кликам.

В данном разделе можно посмотреть статистику по каждому совершённому клику по рекламному материалу за интересующий период (рис.6). alt=статистика по кликам|centre|frame|рис. 6

Статистика по ключевым словам.

В данном разделе можно посмотреть статистику по ключевым словам по всем кампаниям, за интересующий период (рис.7). alt=статистика по кликам|centre|frame|рис. 7

По предложениям.

В данном разделе можно посмотреть статистику за интересующий период по всем кампаниям, где рекламируются товары/услуги из витрины офферов (рис.8). alt=по предложениям|centre|frame|рис. 8

Конверсии.

В данном разделе можно посмотреть отчеты о конверсиях по всем KSA кампаниям за интересующий период (рис.9). alt=конверсии|centre|frame|рис. 9

Лиды.

В данном разделе можно посмотреть отчеты о конверсиях за интересующий период по созданным вами офферам (рис.10). alt=лиды|centre|frame|рис. 10

Мои предложения.

В данном разделе можно посмотреть статистику показов и переходов по всем лендингам созданных вами офферов и отдельно взятому лендингу за интересующий период, но не более 45 дней. А также узнать о количестве лидов и количестве затраченных на них средств. Для ознакомления с детальной статистикой по каждому лендингу офферов необходимо нажать на иконку. (рис.11). alt=мои предложения|centre|frame|рис. 11

Retrieved from "https://wiki.kadam.net/en/index.php?title=API&oldid=1830"