Интеграция через Postback Lead Finance

Что происходит во время интеграции?

Наш код отслеживает историю действий пользователя на сайте, в том числе для выявления нарушений правил оффера вебмастерами (например, cookie-stuffing).

В процессе интеграции код устанавливает обезличенные файлы cookie и собирает следующие данные:

Категория	Данные
Параметры URL перехода	Обезличенный идентификатор пользователя; обезличенный идентификатор сессии; параметры последнего перехода (полный URL и UTM-метки раздельно)
Параметры браузера	User-Agent; размер экрана; размер окна браузера; открытие страницы в iframe; URL текущей страницы и её реферер

Также необходимо сформировать DATA-объект с информацией о покупке.

Мы не собираем личные данные и используем только те файлы cookie, которые настраиваем сами.

В СРА-канале используется модель атрибуции «Last Paid Click»: заказ присваивается платному источнику, который был последним в истории переходов перед оформлением заказа.

Это пример инструкции по интеграции Adv.Cake. Инструкцию с актуальными данными для вашего оффера передаст ваш менеджер.

Шаг 1. Предоставление доступа к рекламному кабинету

Предоставьте доступ к рекламному кабинету Google Analytics или Яндекс.Метрика:

Если вы используете Google Analytics, откройте доступ для аккаунтов analytics@advcake.com и exportcake@core-planet-304613.iam.gserviceaccount.com (аккаунт для запроса данных из Google Analytics по API).
Если вы используете Яндекс.Метрику, откройте доступ для аккаунта metrika@advcake.com.

Если предоставить доступ к этим сервисам невозможно, переходите к следующему шагу.

Шаг 2. Установка JS-кода на страницы сайта

Установите JS-код одним из двух способов:

Напрямую на сайт (рекомендуется):
- Код можно разместить как в <head>, так и в <body>. Рекомендуем ставить его выше других скриптов — так поломка сторонних скриптов не нарушит работу нашего кода.
Через GTM (не рекомендуется: код, установленный через GTM, блокируется блокировщиками рекламы, что приводит к потере конверсий от 30% до 50%):
- Если вы устанавливаете наш код через GTM, выберите триггер «Page View» или «DOM Ready». Триггер «Window Load» не подходит: другие загружаемые скрипты могут заблокировать наш скрипт.

<script type="text/javascript" id="advcakeAsync">
    (function(a) {
        var b = a.createElement("script");
        b.async = 1;
        b.src = "//***.ru/"; // точный домен для интеграции будет вам передан вместе с кастомной инструкцией
        a = a.getElementsByTagName("script")[0];
        a.parentNode.insertBefore(b, a)
    })(document);
</script>

Добавьте в заголовок CSP (если он используется) переданный вам домен.

Шаг 3. Настройка дополнительных параметров

По умолчанию трекинг-ссылка Adv.Cake выглядит так:

?utm_source=advcake&utm_medium=cpa&utm_campaign={partner}&utm_content={webmaster}&advcake_params={click_id}&utm_term={click_id}

Если такой формат ссылок не подходит, сообщите нам.

При переходе пользователя на сайт код Adv.Cake устанавливает две куки:

advcake_track_id — случайная последовательность из 32 символов в формате UUID v.4 (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
advcake_track_url — полная ссылка перехода на сайт с utm_source=advcake.

Шаг 4. Настройка postback

Пример отправки заказа/заявки:

Отправляйте все заказы независимо от источника трафика.

https://api.ekacvda.com/postback/siteru?id=1411551&totalPrice=10141.14&coupo
n=A270&clientType=new&trackId=14511aca1b09e91f&url=https%3a%2f%2fsite.ru%2f%3
futm_source%3dadvcake%26utm_campaign%3dcpa%26advcake_params%3dafacaafa15aac&e
mail=abc@gmail.com&leadName=english_course&timeLastChanged=2021-01-01%2021%3A
30%3A10&status=1&product=credit_card

Вместо siteru подставьте название вашего сайта, например: https://api.ekacvda.com/postback/exampleru.

В параметр url вставляются данные из куки advcake_track_url, предварительно закодированные через url_encode.

Заказ/заявку рекомендуем отправлять POST-запросом в формате JSON (например, через XHR): длина GET-запроса ограничена 2048 символами, поэтому часть данных может не дойти.

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

Расшифровка полей постбека

Параметр	Тип параметра: пример	Описание
`id`	string: `"114392"`	Номер заявки/лида/заказа
`totalPrice`	number: `1500`	Стоимость заявки/лида. Если понятие стоимости отсутствует, передавайте поле всегда равным `0`
`status`	string: `"1"`	Статус заявки/лида/заказа: `1` – Заявка в обработке; `2` – Заявка подтверждена; `3` – Заявка отменена.
`trackid`	string: `"7d12ff1fd3dd5b9a61dc1f42b927264c"`	Значение куки `advcake_track_id` на момент совершения заказа
`url`	string: `"https://example.ru/"`	Значение куки `advcake_track_url` на момент совершения заказа (см. шаг 3)
`product`	string: `"credit_card"`	Соответствующее значение под конкретный продукт, например: `credit_card` – Кредитная карта; `RKO` – Расчетно-кассовое обслуживание.
`leadName`	string: `"RKO-IP"`	При необходимости (например, наличие двух или более категорий продукта) передается категория продукта: Например, для продукта «РКО», могут быть указаны следующие категории: `RKO-IP` - Расчетно-кассовое обслуживание для ИП; `RKO-OOO` - Расчетно-кассовое обслуживание для ООО.
`email`	string: `md5(user@email.ru`	Почта клиента (можно передавать телефон или захешированный идентификатор)
`description`	string: `"Не понравился"`	Причина отмены заказа (передавать данное поле желательно, но необязательно) (см. шаг 3)
`coupon`	string: `"SALE10"`	Использованный в заказе купон/промокод, если такая опция используется. Если такой опции нет, данное поле можно исключить
`clientType`	string: `"new"`	Тип клиента: `old` (старый), `new` (новый). Нужен для разделения ставок и аналитики (желательно, но необязательно)
`dateCreate`	string: `"2022-09-08 17:16:25"`	Дата создания заказа в формате Y-m-d H:i:s (например, 2022-09-08 17:16:25)
`timeLastChanged`	string: `"2022-09-08 17:16:25"`	Дата изменения статуса заказа в формате Y-m-d H:i:s (например, 2022-09-08 17:16:25)

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

Шаг 5. Установка кода DATA-объекта на страницы сайта

Установите приведённые ниже коды на соответствующие страницы сайта:

1. Главная страница

<script>
    window.advcake_data = window.advcake_data || [];
    window.advcake_data.push({
        pageType: 1
    });
</script>

2. Все остальные страницы

<script>
    window.advcake_data = window.advcake_data || [];
    window.advcake_data.push({
        pageType: 2
    });
</script>

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

Последнее изменение: 19.01.2026

Интеграция через Postback Lead Finance

На этой странице: