Skip to content

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

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

Метод 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"