# statSubscribe

Статистика оформления и отмен подписок.

Обязательные параметры: 

| **Параметр**                                             | Описание                                                                                                                             |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| <p><strong>date\_from</strong> <br><em>(string)</em></p> | <p>дата и время, с которой подписались/отписались <br>формат: <code>d.m.Y H:i:s</code> пример: <code>26.11.2018 10:00:00</code></p>  |
| <p><strong>date\_to</strong> <br><em>(string)</em></p>   | <p>дата и время, до которой подписались/отписались <br>формат: <code>d.m.Y H:i:s</code> пример: <code>27.11.2018 10:00:00</code></p> |

Необязательные параметры:&#x20;

| **Параметр**                                                              | Описание                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>count</strong> <br><em>(int)</em></p>                          | <p>количество элементов, информацию о которых нужно вернуть</p><p>максимум: <code>1000</code><br>пример: <code>50</code></p>                                                                                                                                                                                                                                                                                                                    |
| <p><strong>offset</strong><br><em>(int)</em></p>                          | <p>Смещение, необходимое для выборки определенного подмножества бесед<br>пример: <code>10</code></p>                                                                                                                                                                                                                                                                                                                                            |
| <p><strong>vk\_user\_id или tg\_user\_id</strong><br><em>(array)</em></p> | <p>идентификаторы пользователей ВКонтакте или Telegram соответственно<br>пример: <code>\[1]</code></p>                                                                                                                                                                                                                                                                                                                                          |
| <p><strong>subscription\_id</strong> <br><em>(array)</em></p>             | <p>идентификаторы групп подписчиков <br>пример: <code>\[123]</code></p>                                                                                                                                                                                                                                                                                                                                                                         |
| <p><strong>ignore\_subscription\_id</strong><br><em>(array)</em></p>      | <p>идентификаторы групп, подписчиков которых нужно исключить из выборки (0 - без группы) <br>пример: <code>\[0,123]</code></p>                                                                                                                                                                                                                                                                                                                  |
| <p><strong>utm\_id</strong> <br><em>(array)</em></p>                      | <p>идентификаторы utm - меток Senler <br>пример: <code>\[0,123]</code></p>                                                                                                                                                                                                                                                                                                                                                                      |
| <p><strong>source</strong> <br><em>(array)</em></p>                       | <p>источник подписки</p><ul><li><code>subscriptions</code> Список групп в приложении</li><li><code>subscription</code> Прямая ссылка на группу подписчиков</li><li><code>widget</code> Виджет в сообществе</li><li><code>keyword</code> Ключевое слово</li><li><code>api</code> API</li><li><code>site</code> Сайт</li><li><code>hand</code> Вручную</li><li><code>other</code> Другое <br><br>пример: <code>\['subscription']</code></li></ul> |
| <p><strong>utm\_source</strong> <br><em>(array)</em></p>                  | <p>источник кампании <br>пример: <code>\['vk']</code></p>                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><strong>utm\_medium</strong> <br><em>(array)</em></p>                  | <p>тип трафика <br>пример: <code>\['cpc']</code></p>                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><strong>utm\_campaign</strong> <br><em>(array)</em></p>                | <p>название кампании <br>пример: <code>\['skidka\_po\_karte']</code></p>                                                                                                                                                                                                                                                                                                                                                                        |
| <p><strong>utm\_content</strong> <br><em>(array)</em></p>                 | <p>идентификатор объявления <br>пример: <code>\['banner']</code></p>                                                                                                                                                                                                                                                                                                                                                                            |
| <p><strong>utm\_term</strong> <br><em>(array)</em></p>                    | <p>ключевое слово <br>пример: <code>\['заказать стул онлайн']</code></p>                                                                                                                                                                                                                                                                                                                                                                        |

Ответ:

| Параметр                                            | Описание                                                                                                 |
| --------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| <p><strong>success</strong> <br><em>(bool)</em></p> | <p><code>true</code> операция прошла успешно</p><p><code>false</code> при выполнении возникли ошибки</p> |
| <p><strong>items</strong> <br><em>(array)</em></p>  | [список подписок/отписок](#struktura-elementa-massiva-s-podpiskami-otpiskami-items)                      |

#### Структура элемента массива с подписками/отписками (items):&#x20;

| **Параметр**                                                            | Описание                                                                                                                                                                                                                                                                                                                                                                                          |
| ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>date</strong> <br><em>(string)</em></p>                      | <p>дата подписки <br>формат: <code>d.m.Y H:i:s</code> пример: <code>27.11.2018 10:00:00</code></p>                                                                                                                                                                                                                                                                                                |
| <p><strong>vk\_user\_id или tg\_user\_id</strong><br><em>(int)</em></p> | <p>идентификатор подписчика ВКонтакте или Telegram соответственно<br>пример: <code>1</code></p>                                                                                                                                                                                                                                                                                                   |
| <p><strong>first\_name</strong> <br><em>(string)</em></p>               | <p>имя подписчика <br>пример: <code>Иван</code></p>                                                                                                                                                                                                                                                                                                                                               |
| <p><strong>last\_name</strong> <br><em>(string)</em></p>                | <p>фамилия подписчика <br>пример: <code>Иванов</code></p>                                                                                                                                                                                                                                                                                                                                         |
| <p><strong>photo</strong> <br><em>(string)</em></p>                     | <p>ссылка на изображение подписчика <br>пример: <a href="https://vk.com/away.php?to=https%3A%2F%2Fsun6-6.userapi.com"><code><https://sun6-6.userapi.com></code></a></p>                                                                                                                                                                                                                           |
| <p><strong>subscription\_id</strong><br><em>(int)</em></p>              | <p>идентификатор группы подписчиков (отсутствует, если подписка без группы) <br>пример: <code>123</code></p>                                                                                                                                                                                                                                                                                      |
| <p><strong>action</strong> <br><em>(int)</em></p>                       | <p>действие. </p><ul><li><code>1</code> подписка</li><li><code>2</code> отписка </li></ul>                                                                                                                                                                                                                                                                                                        |
| <p><strong>ignore</strong> <br><em>(int)</em></p>                       | <p>если пользователь в черном списке - значение "1", иначе "0" (на момент подписки) <br>пример: <code>0</code></p>                                                                                                                                                                                                                                                                                |
| <p><strong>source</strong> <br><em>(string)</em></p>                    | <p>источник подписки</p><ul><li><code>subscriptions</code> Список групп в приложении</li><li><code>subscription</code> Прямая ссылка на группу подписчиков</li><li><code>widget</code> Виджет в сообществе</li><li><code>keyword</code> Ключевое слово</li><li><code>api</code> API</li><li><code>site</code> Сайт</li><li><code>hand</code> Вручную</li><li><code>other</code> Другое </li></ul> |
| <p><strong>utm\_id</strong> <br><em>(int)</em></p>                      | <p>идентификатор меток Senler <br>пример: <code>123</code></p>                                                                                                                                                                                                                                                                                                                                    |
| <p><strong>utm\_source</strong> <br><em>(string)</em></p>               | <p>источник кампании <br>пример: <code>vk</code></p>                                                                                                                                                                                                                                                                                                                                              |
| <p><strong>utm\_medium</strong> <br><em>(string)</em></p>               | <p>тип трафика <br>пример: <code>cpc</code></p>                                                                                                                                                                                                                                                                                                                                                   |
| <p><strong>utm\_campaign</strong> <br><em>(string)</em></p>             | <p>название кампании <br>пример: <code>skidka\_po\_karte</code></p>                                                                                                                                                                                                                                                                                                                               |
| <p><strong>utm\_content</strong> <br><em>(string)</em></p>              | <p>идентификатор объявления <br>пример: <code>banner</code></p>                                                                                                                                                                                                                                                                                                                                   |
| <p><strong>utm\_term</strong> <br><em>(string)</em></p>                 | <p>ключевое слово <br>пример: <code>заказать стул онлайн</code></p>                                                                                                                                                                                                                                                                                                                               |