Difference between revisions of "API"

From Service Manual Kadam.net
Jump to: navigation, search
Line 125: Line 125:
 
</pre>
 
</pre>
 
</code>
 
</code>
==Статистика по кампаниям.==
+
==Статистика по материалу==
 
+
Для получения статистики по материалу используется метод <b>ads.analytic.material.get</b><br/>
 +
<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>material_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: {
 +
date
 +
shows
 +
clicks
 +
ctr
 +
cpm
 +
money
 +
                      }
 +
                  }
 +
}
  
 +
</pre>
 +
</code>
 
==Статистика по материалу==
 
==Статистика по материалу==
  

Revision as of 14:57, 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
                       }
                  }
}

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

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

Параметры Значение Дополнительные атрибуты
material_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: {
			date
			shows
			clicks
			ctr
			cpm
			money
                       }
                  }
}

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

Конверсии.

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

Лиды.

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

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

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