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

API Медиаплана

Получить данные по всем медиапланам за определенный месяц

POST https://cloud.roistat.com/api/v1/project/mediaplan/target/list

Позволяет получить данные по всем медиапланам за определенный месяц.

curl 'https://cloud.roistat.com/api/v1/project/mediaplan/target/list?project=12345' \
--request POST \
--header 'Content-type: application/json' \
--header 'Api-key: {KEY}' \
--data '{"date_from": "2021-11-01","date_to": "2021-11-30"}'

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

{
    "date_from": "2021-11-01",
    "date_to": "2021-11-30"
}
{
    "data": [
        {
            "id": "25",
            "channel": "email",
            "metrics": [
                {
                    "name": "leads",
                    "value": 1
                },
                {
                    "name": "marketing_cost",
                    "value": 2
                },
                {
                    "name": "cpl",
                    "value": 2
                }
            ],
            "date_from": "2021-11-01",
            "date_to": "2021-11-30"
        },
        {
            "id": "16",
            "channel": "facebook5",
            "metrics": [
                {
                    "name": "leads",
                    "value": 53
                },
                {
                    "name": "marketing_cost",
                    "value": 10000
                },
                {
                    "name": "cpl",
                    "value": 188.68000000000001
                }
            ],
            "date_from": "2021-11-01",
            "date_to": "2021-11-30"
        },
        {
            "id": "18",
            "channel": "seo",
            "metrics": [
                {
                    "name": "leads",
                    "value": 16
                },
                {
                    "name": "marketing_cost",
                    "value": 10000
                },
                {
                    "name": "cpl",
                    "value": 625
                }
            ],
            "date_from": "2021-11-01",
            "date_to": "2021-11-30"
        }
    ],
    "total": 3,
    "status": "success"
}

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

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

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

Параметр Тип Описание Обязательный
date_from string Первый день месяца, за который нужно получить данные, в формате YYYY-MM-DD. Нельзя указывать прочие дни месяца. да
date_to string Последний день месяца, за который нужно получить данные, в формате YYYY-MM-DD. Нельзя указывать прочие дни месяца. да
Параметр Тип Описание
data array[object]
id string ID медиаплана
channel string Название канала
metrics array[object]
>> name string Метрики "leads" (заявки), "marketing_cost" (расходы) и "cpl"
>> value integer Значение метрики
date_from string Первый день месяца, за который учитываются данные
date_to string Последний день месяца, за который учитываются данные
total integer Количество медиапланов за выбранный месяц
status string

Удалить данные по определенному медиаплану

POST https://cloud.roistat.com/api/v1/project/mediaplan/target/delete

Позволяет удалить данные по определенному медиаплану.

curl 'https://cloud.roistat.com/api/v1/project/mediaplan/target/delete?project=12345' \
--request POST \
--header 'Content-type: application/json' \
--header 'Api-key: {KEY}' \
--data '{"id": "12"}'

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

{
    "id": "12"
}
{
    "status": "success"
}

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

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

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

Параметр Тип Описание Обязательный
id string ID медиаплана, который можно узнать с помощью метода /project/mediaplan/target/list да
Параметр Тип Описание Обязательный
status string нет

Создать медиаплан

POST https://cloud.roistat.com/api/v1/project/mediaplan/target/create

Позволяет создать медиаплан.

curl 'https://cloud.roistat.com/api/v1/project/mediaplan/target/create?project=12345' \
--request POST \
--header 'Content-type: application/json' \
--header 'Api-key: {KEY}' \
--data '{"channel": "unisender","date_from": "2021-11-01","date_to": "2021-11-30","metrics": [{"name": "leads","value": 25},{"name": "marketing_cost","value": 350},{"name": "cpl","value": 14}]}'

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

{
    "channel": "unisender",
    "date_from": "2021-11-01",
    "date_to": "2021-11-30",
    "metrics": [
        {
            "name": "leads",
            "value": 25
        },
        {
            "name": "marketing_cost",
            "value": 350
        },
        {
            "name": "cpl",
            "value": 14
        }
    ]
}
{
    "status": "success"
}

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

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

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

Параметр Тип Описание Обязательный
channel string Название канала в Roistat да
date_from string Первый день месяца, за который нужно получить данные, в формате YYYY-MM-DD. Нельзя указывать прочие дни месяца. да
date_to string Последний день месяца, за который нужно получить данные, в формате YYYY-MM-DD. Нельзя указывать прочие дни месяца. да
metrics array[object] В массиве передаются метрики "leads" (заявки), "marketing_cost" (расходы), "cpl" и их значения. да
name string В качестве значения укажите "leads" (заявки), "marketing_cost" (расходы) или "cpl" нет
value integer Значение метрики, указанной в name нет
Параметр Тип Описание
status string

Обновить данные по указанному медиаплану

POST https://cloud.roistat.com/api/v1/project/mediaplan/target/update

Позволяет обновить данные по указанному медиаплану.

curl 'https://cloud.roistat.com/api/v1/project/mediaplan/target/update?project=12345' \
--request POST \
--header 'Content-type: application/json' \
--header 'Api-key: {KEY}' \
--data '{"id": "26","channel": "yamarket3","date_from": "2021-11-01","date_to": "2021-11-30","metrics": [{"name": "leads","value": 25},{"name": "marketing_cost","value": 350},{"name": "cpl","value": 14}]}'

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

{
    "id": "26",
    "channel": "yamarket3",
    "date_from": "2021-11-01",
    "date_to": "2021-11-30",
    "metrics": [
        {
            "name": "leads",
            "value": 8
        },
        {
            "name": "marketing_cost",
            "value": 600
        },
        {
            "name": "cpl",
            "value": 75
        }
    ]
}
{
    "status": "success"
}

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

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

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

Параметр Тип Описание Обязательный
id string ID медиаплана, который можно узнать с помощью метода /project/mediaplan/target/list да
channel string Название канала в Roistat да
date_from string Первый день месяца, за который учитываются данные, в формате YYYY-MM-DD. Нельзя указывать прочие дни месяца. да
date_to string Последний день месяца, за который учитываются данные, в формате YYYY-MM-DD. Нельзя указывать прочие дни месяца. да
metrics array[object] В массиве передаются метрики "leads" (заявки), "marketing_cost" (расходы), "cpl" и их значения. да
name string В качестве значения укажите "leads" (заявки), "marketing_cost" (расходы) или "cpl" нет
value integer Значение метрики, указанной в name нет
Параметр Тип Описание
status string