Пример инструкции Postback Lead

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

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

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

Мы собираем и используем следующие данные:

Параметры URL перехода:
- Cookie — обезличенный идентификатор пользователя;
- Cookie — обезличенный идентификатор сессии;
- Cookies — параметры последнего перехода (полный 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}

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

При переходе пользователя на сайт код 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

Вместо 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`
`coupon`	string: `"SALE10"`	Купон/промокод, использованный в заказе. Если промокоды не используются, поле можно исключить
`clientType`	string: `"new"`	Тип клиента: `old` (старый), `new` (новый). Нужен для разделения ставок и аналитики (желательно, но не обязательно)
`trackId`	string: `"25d478c0-36db-52cf-39sa"`	Значение куки `advcake_track_id` на момент совершения заказа (см. шаг 3)
`url`	string: `"https://example.ru/"`	Значение куки `advcake_track_url` на момент совершения заказа (см. шаг 3)
`email`	string: `"19111350"`	Почта клиента (можно передавать телефон или захешированный идентификатор)
`leadName`	string: `"Базовый курс"`	Название лида
`marketing_cat`	string: `"1"`	Маркетинговая категория: каждому продукту присваивается номер категории, по которому рассчитывается комиссия (поле необязательно, если разделения комиссии по категориям нет). Например: Регистрация: `marketing_cat: "1"` – комиссия 5% от стоимости товара; Оплаченный курс: `marketing_cat: "2"` – комиссия 2% от стоимости товара. Примечание: если у вас разные ставки по продуктам, обратитесь к менеджеру за корректной разбивкой.
`description`	string: `"Не понравился"`	Причина отмены заказа (желательно, но не обязательно)
`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)
`status`	string: `"1"`	Статус заявки/лида/заказа: `"1"` – Заявка в обработке; `"2"` – Заявка подтверждена; `"3"` – Заявка отменена.

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

Шаг 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>

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

Последнее изменение: 2026-03-07

Пример инструкции Postback Lead

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