События¶

Добавить событие в архив¶

POST https://cloud.roistat.com/api/v1/project/events/meta/{i:eventId}/archive

Описание

C помощью этого метода можно добавить событие в архив.

Пример запроса

curl 'https://cloud.roistat.com/api/v1/project/events/meta/{i:eventId}/archive?project=12345' \
--request POST \
--header 'Content-type: application/json' \
--header 'Api-key: {KEY}' \
--data '[{"display_name": "test1","type": "js","parameter": "js-12"}]'

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

[
    {
        "display_name": "test1",
        "type": "js",
        "parameter": "js-12"
    },
    {
        "display_name": "test2",
        "type": "url",
        "parameter": "http://test.com"
    }
]

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

Без параметров.

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

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

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

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

Параметр	Тип	Обязательный
display_name	string	нет
type	string	нет
parameter	string	нет

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

Параметр	Тип	Описание
type	string
properties	object
> events	object
>> type	string
>> items	object
>>> type	string
>>> properties	object
>>>> id	object
>>>>> type	string
>>>> display_name	object
>>>>> type	string
>>>> type	object
>>>>> type	string
>>>> parameter	object
>>>>> type	string
> status	object
>> type	string

Создать события¶

POST https://cloud.roistat.com/api/v1/project/events/add

Описание

С помощью данного метода можно добавить события списком.

Пример запроса

curl 'https://cloud.roistat.com/api/v1/project/events/add?project=12345' \
--request POST \
--header 'Content-type: application/json' \
--header 'Api-key: {KEY}' \
--data '[{"display_name": "test1","type": "js","parameter": "js-12"}]'

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

[
    {
        "display_name": "test1",
        "type": "js",
        "parameter": "js-12"
    },
    {
        "display_name": "test2",
        "type": "url",
        "parameter": "http://test.com"
    }
]

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

{
    "events": [
        {
            "id": "13",
            "display_name": "test1",
            "type": "js",
            "parameter": "js-12"
        },
        {
            "id": "14",
            "display_name": "test2",
            "type": "url",
            "parameter": "http://test.com"
        }
    ],
    "status": "success"
}

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

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

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

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

Параметр	Тип	Описание	Обязательный
display_name	string	название события	нет
type	string	js или url - определяет условие срабатывания события	нет
parameter	string	ID события или ссылка	нет

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

Параметр	Тип	Описание
events	array[object]
> id	string
> display_name	string
> type	string
> parameter	string
status	string

Получить данные по каждому событию из истории срабатываний¶

GET https://cloud.roistat.com/api/v1/project/events/log

Описание

С помощью этого метода можно получить данные по каждому событию из истории срабатываний.

Пример запроса

curl 'https://cloud.roistat.com/api/v1/project/events/log?project=12345' \
--request POST \
--header 'Content-type: application/json' \
--header 'Api-key: {KEY}' \
--data '{"name": "Переход в корзину","date_from": "2022-04-04T20:59:59.999Z","date_to": "2022-05-04T15:00:00.000Z"}'

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

{
    "name": "Переход в корзину",
    "date_from": "2022-04-04T20:59:59.999Z",
    "date_to": "2022-05-04T15:00:00.000Z"
}

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

{
    "items": [
        {
            "id": "123",
            "display_name": "Переход в корзину",
            "parameter": "view_contacts_page",
            "type": "js",
            "event_date": "2022-04-04T23:51:58+0000",
            "data": null,
            "visit_id": "41599"
        },
        {
            "id": "456",
            "display_name": "Переход в корзину",
            "parameter": "cozy.home.ru/catalog/decor",
            "type": "url",
            "event_date": "2022-05-03T23:51:29+0000",
            "data": null,
            "visit_id": "41598"
        }
    ],
    "status": "success"
}

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

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

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

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

Параметр	Тип	Описание	Обязательный
name	string	Название события	нет
date_from	string	Дата, с которой учитывать срабатывания	нет
date_to	string	Дата, до которой учитывать срабатывания	нет

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

Параметр	Тип	Описание
items	array[object]
> id	string	ID срабатывания события
> display_name	string	Название события
> parameter	string	URL или ID события
> type	string	Условие срабатывания
> event_date	string	Дата срабатывания
> data	null или object	Дополнительные данные о срабатывании события
> visit_id	null или string
status	string

Отправить событие¶

POST https://cloud.roistat.com/api/v1/project/events/send

Описание

С помощью данного метода можно отправлять события.

Пример запроса

curl 'https://cloud.roistat.com/api/v1/project/events/send?project=12345' \
--request POST \
--header 'Content-type: application/json' \
--header 'Api-key: {KEY}' \
--data '{"name": "Открытие формы","visit": "100001","data": {"region": "Москва","landing": 1}}'

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

{
    "name": "Открытие формы",
    "visit": "100001",
    "data": {
        "region": "Москва",
        "landing": 1
    }
}

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

{
    "status": "success"
}

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

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

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

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

Параметр	Тип	Описание	Обязательный
name	string	Название события, созданного в Roistat	да
visit	string	Номер визита из куки roistat_visit	нет
data	object	Дополнительные параметры события (отображаются в Истории срабатываний в столбце «Доп.поля»)	нет

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

Параметр	Тип	Описание
status	string

Отправить сразу несколько событий¶

POST https://cloud.roistat.com/api/v1/project/events/bulk/send

Описание

Метод позволяет отправлять сразу несколько событий.

Пример запроса

curl 'https://cloud.roistat.com/api/v1/project/events/bulk/send?project=12345' \
--request POST \
--header 'Content-type: application/json' \
--header 'Api-key: {KEY}' \
--data '[{"name": "Открытие формы","visit": "100001"},{"name": "Открытие формы","visit": "100002"}]'

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

[
    {
        "name": "Открытие формы",
        "visit": "100001",
        "data": {
            "region": "Москва",
            "landing": 1
        }
    },
    {
        "name": "Открытие формы",
        "visit": "100002",
        "data": {
            "region": "Москва",
            "landing": 1
        }
    }
]

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

{
    "status": "success"
}

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

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

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

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

Параметр	Тип	Описание	Обязательный
name	string	Название события, созданного в Roistat	нет
visit	string	Номер визита из куки roistat_visit	нет
data	object	Дополнительные параметры события (отображаются в Истории срабатываний в столбце «Доп.поля»)	нет

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

Параметр	Тип	Описание
status	string