Перейти к содержанию

Визиты

Получить информацию о всех визитах

POST /project/site/visit/list

Этот метод используется для получения информации о всех визитах.

Для ограничения выборки можно использовать наши стандартные фильтры. Для фильтрации по вложенным значениям необходимо указывать название родительского параметра и через точку название параметра для фильтрации. Например, для фильтрации по источнику перехода: "filters" : [[ "source.system_name", "like", "yandex"]].

Однако фильтрация невозможна по следующим параметрам: google_client_id, metrika_client_id, device, order_ids, source.icon_url, source.openstat, geo.country, geo.region, geo.city, icon_url, country_iso, cost.

Ограничение на один ответ - 10 000 записей.

Также реализована поддержка limit и offset.

curl 'https://cloud.roistat.com/api/v1/project/site/visit/list?project=12345' \
    --request POST \
    --header 'Content-type: application/json' \ 
    --header 'Api-key: {KEY}' \ 
    --data Стандартные фильтры
{
    "data": {
        "id": "4336465",
        "first_id": "4336465",
        "date": "2016-06-19T00:30:31+0000",
        "landing_page": "kartinidemo.ru/l/portret-na-zakaz",
        "host": "kartinidemo.ru",
        "google_client_id": null,
        "metrika_client_id": null,
        "ip": "37.144.111.135",
        "roistat_param1": null,
        "roistat_param2": null,
        "roistat_param3": null,
        "roistat_param4": null,
        "roistat_param5": null,
        "device": {
            "os": "OS X",
            "os_icon": "https://cloud.roistat.com/img/os/macosx.png",
            "agent": "Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.84 Safari/537.36",
            "agent_icon": "https://cloud.roistat.com/img/browsers/chrome.png",
            "is_mobile": false
        },
        "source": {
            "referrer": "http://yandex.ru",
            "system_name": "direct1_search_1_123456_789012",
            "display_name": "Яндекс.Директ_Поиск_Картины_Акция",
            "display_name_by_level": [
                "Яндекс.Директ",
                "Поиск",
                "Картины",
                "Акция"
            ],
            "icon_url": "https://favicon.yandex.net/favicon/vk.com",
            "utm_source": null,
            "utm_medium": null,
            "utm_campaign": null,
            "utm_term": null,
            "utm_content": null,
            "openstat": null
        },
        "geo": {
            "country": "Россия",
            "region": "Смоленская область",
            "city": "Смоленск",
            "icon_url": "/img/country/ru.png",
            "country_iso": "RU"
        },
        "order_ids": [
            "62"
        ],
        "cost": 223.18299999999999,
        "ab_test": [
            {
                "test_id": 1,
                "test_title": "button",
                "variant_id": "1",
                "variant_title": "green"
            },
            {
                "test_id": 2,
                "test_title": "font",
                "variant_id": "1",
                "variant_title": "14px"
            }
        ]
    },
    "total": 1,
    "status": "success"
}

Строка запроса:

Параметр Тип Описание Обязательный
project string Номер проекта да

Тело запроса:

Стандартные фильтры

Параметр Тип Описание
data object
id string Текущий номер визита
first_id string Номер первого визита в цепочке посещений клиента
date string Дата и время визита
landing_page string Страница, на которую совершен визит
host string Домен
google_client_id null или string Значение ClientId, присвоенное счетчиком Google Analytics
metrika_client_id null или string Значение ClientId, присвоенное счетчиком Яндекс.Метрики
ip string IP посетителя
roistat_param1 null или string Значение метки roistat_param1 у посетителя
roistat_param2 null или string Значение метки roistat_param2 у посетителя
roistat_param3 null или string Значение метки roistat_param3 у посетителя
roistat_param4 null или string Значение метки roistat_param4 у посетителя
roistat_param5 null или string Значение метки roistat_param5 у посетителя
device object
>> os string Операционная система посетителя
>> os_icon string Иконка операционной системы
>> agent string Браузер посетителя
>> agent_icon string Иконка браузера
>> is_mobile boolean true - визит с мобильного устройства
source object
>> referrer string Источник перехода
>> system_name string Системное название рекламного канала
>> display_name string Человекочитаемое название рекламного канала
>> display_name_by_level array[string] Человекочитаемое название рекламного канала по уровням
>> icon_url string Ссылка на иконку канала
>> utm_source null или string Значение метки utm_source у посетителя
>> utm_medium null или string Значение метки utm_medium у посетителя
>> utm_campaign null или string Значение метки utm_campaign у посетителя
>> utm_term null или string Значение метки utm_term у посетителя
>> utm_content null или string Значение метки utm_content у посетителя
>> openstat null или string Значение метки openstat у посетителя
geo object
>> country string Страна посетителя
>> region string Регион посетителя
>> city string Город посетителя
>> icon_url string Ссылка на иконку страны
>> country_iso string Код страны
order_ids array[string] ID сделок по визиту
cost number Себестоимость сделки
ab_test array[object]
>> test_id number ID теста
>> test_title string Название теста
>> variant_id string ID варианта
>> variant_title string Название варианта
total integer
status string

Обновить параметры roistat_param в визите

POST /project/site/visit/params/update

Данный метод позволяет обновлять параметры roistat_param в визите.

curl 'https://cloud.roistat.com/api/v1/project/site/visit/params/update?project=12345' \
    --request POST \
    --header 'Content-type: application/json' \ 
    --header 'Api-key: {KEY}' \ 
    --data Тело запроса - см. ниже

Тело запроса:

{
    "visit": "123",
    "roistat_param1": "onlineshop"
}
{
    "status": "success"
}

Строка запроса:

Параметр Тип Описание Обязательный
project string Номер проекта да

Тело запроса:

Параметр Тип Описание Обязательный
visit string да
roistat_param1 string или null нет
roistat_param2 string или null нет
roistat_param3 string или null нет
roistat_param4 string или null нет
roistat_param5 string или null нет
Параметр Тип Описание
status string