Получение списка достигнутых целей

Метод	`get.goals_report`
Описание	Получение списка достигнутых целей
Кому доступен	Партнер, Клиент

Параметры запроса

Название	Тип	Обязательный	Допустимые значения	Описание
`access_token`	string	да		Ключ сессии аутентификации
`user_id`	number	нет		Уникальный идентификатор пользователя клиента агента от имени которого делается запрос Является обязательным для агента Для получения списка пользователей клиента необходимо использовать метод "get.customer_users"
`limit`	number	нет		Количество возвращаемых записей. См. раздел "Постраничный вывод"
`offset`	number	нет		Сдвиг, определяет с какого номера записи возвращать `"limit"` записей. По умолчанию "0". См. раздел "Постраничный вывод"
`filter`	object	нет		См. раздел "Критерии фильтрации"
`fields`	array	нет		См. раздел "Представление возвращаемых данных"
`sort`	array	нет		См. раздел "Сортировка данных"
`date_from`	iso8601	да	YYYY-MM-DD hh:mm:ss	Дата начала выборки
`date_till`	iso8601	да	YYYY-MM-DD hh:mm:ss	Дата окончания выбокри

Параметры ответа

Название	Тип	Допустимые значения	Фильтрация	Сортировка	Ответ по умолчанию	Описание
`id`	number		да			Уникальный идентификатор цели
`date_time`	iso8601	YYYY-MM-DD hh:mm:ss				Дата и время достижения цели
`name`	string		да	да		Название цели
`type`	enum	track_event time_on_page comagic segment ppc_goal click link scroll time_on_site	да		да	Тип цели track_event - Пользовательская time_on_page - Время на странице comagic - В CoMagic segment - Вхождение в сегмент ppc_goal - click - Клик на объект link - Переход по ссылке scroll - Действия с прокруткой time_on_site - Время на сайте
`ext_id`	string		да		да	Идентификатор интегрированной цели во внешней системе
`source`	enum	yandex.metrika google.analytics comagic	да		да	Название системы в которой создана цель
`communication_number`	number		да	да		Номер обращения. Расcчитывается в рамках персоны.
`communication_page_url`	string		нет	нет	нет	URL страницы на которой находился посетитель в момент обращения или страница последнего взаимодействия посетителя перед обращением.
`communication_id`	number		да		да	Уникальный идентификатор обращения
`communication_type`	enum	`goal`	да		да	Тип обращения
`ua_client_id`	string					Уникальный идентификатор в Universal Analytics
`ym_client_id`	string					Уникальный идентификатор пользователя Яндекс.Метрики
`sale_date`	iso8601	YYYY-MM-DD hh:mm:ss	да	да		Дата сделки
`sale_cost`	number		да	да		Сумма сделки
`search_query`	string		да			Поисковый запрос
`search_engine`	string		да			Название поисковой системы
`referrer_domain`	string		да			Домен реферера
`referrer`	string		да			Источник перехода
`entrance_page`	string		да			Страница входа
`gclid`	string		да			Google Click Identifier
`yclid`	string		да			Yandex Click Identifier
`ymclid`	string		да			Yandex Market Click Identifier
`ef_id`	string		да			Используется для разметки ссылок в системе управления контекстной рекламой AdLense
`channel`	enum	`display` `paid` `affiliate` `messenger` `social` `email` `organic` `internal` `recommendation` `cashed` `referral` `direct`	да			Канал.
Проставленные теги
`tags`	array		да			Теги, см. метод `"get.tags"`
`tag_id`	number					Уникальный идентификатор тега
`tag_name`	string					Название тега
`tag_type`	enum	`auto`, `manual`				Тип тега
`tag_change_time`	iso8601					Время простановки тега
`tag_user_id`	number					Уникальный идентификатор пользователя, который проставил тег
`tag_user_login`	string					Логин пользователя, который проставил тег
`tag_employee_id`	number					Уникальный идентификатор сотрудника, который проставил тег
`tag_employee_full_name`	string					Ф.И.О. сотрудника, который проставил тег
Сайт
`site_id`	number		да	да	да	Уникальный идентификатор сайта
`site_domain_name`	string		да	да		Адрес сайта в интернете. Без указания протокола - `"http://"` или `"https://"`
Рекламная кампания
`campaign_id`	number		да	да	да	Уникальный идентификатор рекламной кампании
`campaign_name`	string		да	да		Название рекламной кампании
`visit_other_campaign`	boolean					Флаг показывает заходил ли посетитель (в пределах персоны) по другим рекламным кампаниям
Информация о посетителе
`visitor_id`	number		да	да		Уникальный идентификатор посетителя
`person_id`	number		да			Уникальный идентификатор персоны
`visitor_type`	enum	Новый, Вернувшийся, Не заполнен	да	да		Тип посетителя
`visitor_session_id`	number		да			Уникальный идентификатор сессии посетителя, см. `"get.visitor_sessions_report"`
`visits_count`	number		да			Общее количество посещений посетителя
`visitor_first_campaign_id`	number		да			Уникальный идентификатор первой рекламной кампании.
`visitor_first_campaign_name`	string		да			Название первой рекламной кампании
`visitor_city`	string		да			Город посетителя
`visitor_region`	string		да			Регион посетителя
`visitor_country`	string		да			Страна посетителя
`visitor_device`	enum	`desktop` `mobile` `tablet` `other`	да	да		Устройство пользователя
Свойства посетителя
`visitor_custom_properties`	array		да			Свойства посетителя, которые могут быть заданы через личный кабинет или с помощью JavaScript API [метод `Comagic.setProperty(name, value);`]
`property_name`	string					Имя свойства, которое должно быть присвоено посетителю
`property_value`	string					Значение свойства
Сегменты
`segments`	array		да			Сегменты
`segment_id`	number					Уникальный идентификатор сегмента
`segment_name`	string					Название сегмента
UTM-метка
`utm_source`	string		да			Источник кампании
`utm_medium`	string		да			Канал кампании
`utm_term`	string		да			Ключевое слово кампании
`utm_content`	string		да			Содержание кампании
`utm_campaign`	string		да			Название кампании
OS-метка
`openstat_ad`	string		да			Идентификатор рекламного объявления
`openstat_campaign`	string		да			Идентификатор рекламной кампании
`openstat_service`	string		да			Идентификатор сервиса, предоставляющего услуги
`openstat_source`	string		да			Идентификатор площадки, раздела, страницы, места на странице, на котором было показано соответствующее рекламное объявление
Атрибуты обращения
`attributes`	array	`first` - Первый качественный `through` - Сквозной первый качественный `primary` - Первичное `secondary` - Вторичное `lost` - Потерянное `target` - Целевое `off-target` - Не целевое `quality` - Качественное `rest` - целевые повторные обращения (обращения, совершенные в период повторного обращения, настроенного для сайта в ЛК CoMagic).	да			Атрибуты обращения
Расширенные UTM-метки
`eq_utm_source`	string		да			Расширенная utm_source
`eq_utm_medium`	string		да			Расширенная utm_medium
`eq_utm_term`	string		да			Расширенная utm_term
`eq_utm_content`	string		да			Расширенная utm_content
`eq_utm_campaign`	string		да			Расширенная utm_campaign
`eq_utm_referrer`	string		да			Расширенная utm_referrer
`eq_utm_expid`	string		да			Расширенная utm_expid

JSON структура запроса

Копировать

{
 "jsonrpc":"2.0",
 "id":"number",
 "method":"get.goals_report",
 "params":{
  "access_token":"string",
  "user_id":"number",
  "offset":"number",
  "limit":"number",
  "date_from":"iso8601",
  "date_till":"iso8601",
  "filter":{

  },
  "sort":[
   {
    "field":"string",
    "order":"string"
   }
  ],
  "fields":[
   "string"
  ]
 }
}

JSON структура ответа

Копировать

{
 "jsonrpc":"2.0",
 "id":"number",
 "result":{
  "metadata":{

  },
  "data":[
   {
    "id":"number",
    "date_time":"iso8601",
    "name":"string",
    "type": "enum",
    "ext_id": "number",
    "source": "enum",
    "communication_number":"number",
    "communication_page_url": "string",
    "communication_id":"number",
    "communication_type":"enum",
    "ua_client_id":"string",
    "ym_client_id": "string",
    "sale_date":"iso8601",
    "sale_cost":"number",
    "search_query":"string",
    "search_engine":"string",
    "referrer_domain":"string",
    "referrer":"string",
    "entrance_page":"string",
    "gclid":"string",
    "yclid":"string",
    "ymclid":"string",
    "ef_id":"string",
    "channel":"enum",
    "tags":[
     {
      "tag_id":"number",
      "tag_name":"string",
      "tag_type":"enum",
      "tag_change_time":"iso8601",
      "tag_user_id":"number",
      "tag_user_login":"string",
      "tag_employee_id":"number",
      "tag_employee_full_name":"string"
     }
    ],
    "site_id":"number",
    "site_domain_name":"string",
    "campaign_id":"number",
    "campaign_name":"string",
    "visit_other_campaign":"boolean",
    "visitor_id":"number",
    "person_id":"number",
    "visitor_type":"enum",
    "visitor_session_id":"number",
    "visits_count":"number",
    "visitor_first_campaign_id":"number",
    "visitor_first_campaign_name":"string",
    "visitor_city":"string",
    "visitor_region":"string",
    "visitor_country":"string",
    "visitor_device":"enum",
    "visitor_custom_properties":[
     {
      "property_name":"string",
      "property_value":"string"
     }
    ],
    "segments":[
     {
      "segment_id":"number",
      "segment_name":"string"
     }
    ],
    "utm_source":"string",
    "utm_medium":"string",
    "utm_term":"string",
    "utm_content":"string",
    "utm_campaign":"string",
    "openstat_ad":"string",
    "openstat_campaign":"string",
    "openstat_service":"string",
    "openstat_source":"string",
    "eq_utm_source": "string",
    "eq_utm_medium": "string",
    "eq_utm_term": "string",
    "eq_utm_content": "string",
    "eq_utm_campaign": "string",
    "eq_utm_referrer": "string",
    "eq_utm_expid": "string",
    "attributes":[

    ]
   }
  ]
 }
}

Список возвращаемых ошибок

Смотрим раздел "Список ошибок для методов с глаголом get"