Adv.Cake

Postback Lead без JS

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

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

Запрос

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

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

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

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

НаименованиеТип значенияОписание
idstringИдентификатор для целевого действия (например, идентификатор заказа). Формат: строка до 255 любых символов. Внимание: Должен быть уникальным.
totalPrice $^?$integerСумма оплаты для целевого действия (например, сумма оплаты заказа) для определения ставок. $^?$ Может отсутствовать, если: – не потребуется для последующей сверки; – или не будет ставок, основанных на проценте от суммы оплаты; – или если запрос отправлен только для обновления статуса целевого действия. Формат: число от 0 до 99999999.
coupon $^?$stringПромокод для атрибуции по промокодам. $^?$ Может не передаваться, если: – при совершении целевого действия не использовался промокод; – или если запрос отправлен только для обновления статуса целевого действия. Формат: строка до 128 любых символов.
clientType $^?$stringТип клиента (например, пользователя сайта): – new – новый клиент – old – существующий клиент $^?$ Может отсутствовать, если запрос отправлен только для обновления статуса целевого действия.
email $^?$.stringИдентификатор клиента (например, адрес электронной почты, номер телефона или любое другое значение). $^?$ Может отсутствовать, если: – запрос отправлен только для обновления статуса целевого действия; – или не потребуется для последующей сверки. Формат: строка до 255 любых символов.
url $^?$stringURL адрес последнего платного перехода со всеми параметрами. $^?$ Может отсутствовать, только если: – переход был не по платной ссылке; – или запрос отправлен только для обновления статуса целевого действия.
marketing_cat $^?$stringМаркетинговая категория для определения ставок (список будет предоставлен в специально подготовленной инструкции). $^?$ Может отсутствовать, если запрос отправлен только для обновления статуса целевого действия.
statusintegerСтатус целевого действия: 1 – совершено (например, заказ оформлен). 2 – подтверждено (например, заказ оплачен) 3 – отклонено (например, заказ отменён) Внимание: В случае ручной сверки для целевых действий отправляется только статус 1.
dateCreate $^?$stringДата и время совершения целевого действия. $^?$ Может отсутствовать, если: – не потребуется для последующей сверки; – или это запрос для обновления статуса целевого действия. Формат: Y-m-d H:i:s
timeLastChanged $^?$stringДата и время обновления статуса целевого действия. $^?$ Может отсутствовать, если: – не потребуется для последующей сверки; – или это первый запрос для целевого действия. Формат: Y-m-d H:i:s

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

Ответ

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

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

$^?$ – свойство может отсутствовать

НаименованиеТип значенияОписание
successbooleanФлаг принятия корректного запроса.
dtstringДата и время принятия запроса в часовом поясе 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/{offer} 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/{offer} 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/{offer} 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"
}

Вам помогла эта страница?

Последнее изменение: 2026-02-12