Postback Lead без JS

Пример инструкции по интеграции

Для передачи данных о получении или изменении информации о целевом действии (оформление платной подписки) необходимо отправить HTTP-запрос методом POST.

Запрос

Адрес для запроса: https://api.ekacvda.com/postback/offer, где вместо:

offer – наименование оффера на платформе, которое будет предоставлено в специально подготовленной инструкции после согласования всех атрибутов запроса.

Атрибуты запроса

\(^?\) – атрибут может не передаваться в некоторых случаях

Наименование

Тип значения

Описание

id

string

Идентификатор для целевого действия (например, идентификатор заказа).

Формат: строка до 255 любых символов.

Предупреждение

Должен быть уникальным.

totalPrice \(^?\)

integer

Сумма оплаты для целевого действия (например, сумма оплаты заказа) для определения ставок.

\(^?\) Может отсутствовать, если:

– не потребуется для последующей сверки;

– или не будет ставок, основанных на проценте от суммы оплаты;

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

Формат: число от 0 до 99999999.

coupon \(^?\)

string

Промокод для атрибуции по промокодам.

\(^?\) Может не передаваться, если:

– при совершении целевого действия не использовался промокод;

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

Формат: строка до 128 любых символов.

clientType \(^?\)

string

Тип клиента (например, пользователя сайта):

– new – новый клиент

– old – существующий клиент

\(^?\) Может отсутствовать, если запрос отправлен только для обновления статуса целевого действия.

email \(^?\).

string

Идентификатор клиента (например, адрес электронной почты, номер телефона или любое другое значение).

\(^?\) Может отсутствовать, если:

– запрос отправлен только для обновления статуса целевого действия;

– или не потребуется для последующей сверки.

Формат: строка до 255 любых символов.

url \(^?\)

string

URL адрес последнего платного перехода со всеми параметрами.

\(^?\) Может отсутствовать, только если:

– переход был не по платной ссылке;

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

marketing_cat \(^?\)

string

Маркетинговая категория для определения ставок (список будет предоставлен в специально подготовленной инструкции).

\(^?\) Может отсутствовать, если запрос отправлен только для обновления статуса целевого действия.

status

integer

Статус целевого действия:

1 – совершено (например, заказ оформлен).

2 – подтверждено (например, заказ оплачен)

3 – отклонено (например, заказ отменён)

Предупреждение

В случае ручной сверки для целевых действий отправляется только статус 1.

dateCreate \(^?\)

string

Дата и время совершения целевого действия.

\(^?\) Может отсутствовать, если:

– не потребуется для последующей сверки;

– или это запрос для обновления статуса целевого действия.

Формат: Y-m-d H:i:s

timeLastChanged \(^?\)

string

Дата и время обновления статуса целевого действия.

\(^?\) Может отсутствовать, если:

– не потребуется для последующей сверки;

– или это первый запрос для целевого действия.

Формат: Y-m-d H:i:s

Примечание

Если необходимы дополнительные атрибуты для последующей сверки или для вашей аналитики на нашей платформе, то потребуется сообщить о них для изменения алгоритмов обработки данных.

Ответ

Положительный ответ на корректный запрос будет с кодом 200 и телом в формате JSON.

Свойства объекта

\(^?\) – свойство может отсутствовать

Наименование

Тип значения

Описание

success

boolean

Флаг принятия корректного запроса.

dt

string

Дата и время принятия запроса в часовом поясе GMT+3.

Формат: Y-m-d H:i:s

status_code \(^?\)

integer

Код ответа об ошибке. Соответствует стандартным кодам ответов на HTTP-запросы.

\(^?\) Отсутствует в ответе на корректный запрос.

errors \(^?\)

array

Список ошибок.

\(^?\) Отсутствует в ответе на корректный запрос.

Формат: массив строк.

Предупреждение

Независимо от состава атрибутов и их значений, корректный запрос всегда будет принят и ответ на него будет с кодом 200. Но дальнейшая корректная обработка данных будет только в случае соответствия ожидаемых атрибутов запроса и их значений.

Примеры

Совершение целевого действия

5 сентября 2025 года в 13:00 (по Москве) существующий клиент с адресом электронной почты client@domain.com оформил заказ на сумму 3000 рублей c маркетинговой категорией 1. Для целевого действия был зарегистрирован идентификатор заказа с уникальным значением c8821c53-403f-4aeb-ae4e-9853d2d52fde.

Указанный клиент перед оформлением заказа перешёл на рекламируемый сайт website.ru по ссылке с метками:

https://website.ru/?utm_source=advcake&utm_medium=cpa&utm_campaign=affiliate&utm_content=test&advcake_params=5ad7308ea4cfb34847520984528d0b5d&utm_term=5ad7308ea4cfb34847520984528d0b5d

Запрос

POST /postback/360yandexru HTTP/2
Host: api.ekacvda.com
Content-Type: application/json

    {
        "id": "c8821c53-403f-4aeb-ae4e-9853d2d52fde",
        "amount": 300,
        "user": "old",
        "customer": "client@domain.com",
        "url": "https://website.ru/?utm_source=advcake&utm_medium=cpa&utm_campaign=affiliate&utm_content=test&advcake_params=5ad7308ea4cfb34847520984528d0b5d&utm_term=5ad7308ea4cfb34847520984528d0b5d"
        "category": "1",
        "status": 1,
        "created": "2025-09-05 13:00:00"
    }

Ответ

HTTP/2 200 OK
Content-Type: application/json

{
    "success": true,
    "dt": "2025-09-05 13:00:01"
}

Подтверждение целевого действия

5 сентября 2025 года в 13:00:05 (по Москве) заказ со значением c8821c53-403f-4aeb-ae4e-9853d2d52fde был оплачен и целевое действие было подтверждено.

Запрос

В запросе передаются только те данные, которые необходимо изменить. Все переданные ранее данные для запроса с тем же идентификатором останутся неизменными.

POST /postback/360yandexru HTTP/2
Host: api.ekacvda.com
Content-Type: application/json

{
    "id": "c8821c53-403f-4aeb-ae4e-9853d2d52fde",
    "status": 2,
    "updated": "2025-09-05 13:00:05"
}

Ответ

HTTP/2 200 OK
Content-Type: application/json

{
    "success": true,
    "dt": "2025-09-05 13:00:06"
}

Отклонение целевого действия

6 сентября 2025 года в 14:30:00 (по Москве) заказ со значением c8821c53-403f-4aeb-ae4e-9853d2d52fde был отклонён и оплата была возвращена.

Запрос

В запросе передаются только те данные, которые необходимо изменить. Все переданные ранее данные для запроса с тем же идентификатором останутся неизменными.

POST /postback/360yandexru HTTP/2
Host: api.ekacvda.com
Content-Type: application/json

{
    "id": "c8821c53-403f-4aeb-ae4e-9853d2d52fde",
    "status": 3,
    "updated": "2025-09-06 14:30:00"
}

Ответ

HTTP/2 200 OK
Content-Type: application/json

{
    "success": true,
    "dt": "2025-09-05 14:30:01"
}