Adv.Cake
/Рекламодателям/Интеграция/Пример инструкции Postback Ecom

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

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

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

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

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

  1. Параметры URL перехода:

    • Cookie — обезличенный идентификатор пользователя;
    • Cookie — обезличенный идентификатор сессии;
    • Cookies — параметры последнего перехода (полный URL и UTM-метки раздельно).

  2. Параметры браузера:

    • User-Agent;
    • Размер экрана;
    • Размер окна браузера;
    • Открытие страницы в iframe;
    • URL текущей страницы и её реферер.

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

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

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

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

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

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

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

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

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

  1. Напрямую на сайт (рекомендуется):

    • Код можно разместить как в <head>, так и в <body>. Рекомендуем ставить его выше других скриптов — так поломка сторонних скриптов не нарушит работу нашего кода.

  2. Через 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 устанавливает две куки:

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

  2. advcake_track_url — полная ссылка перехода на сайт с utm_source=advcake.

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

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

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

https://api.ekacvda.com/postback/siteru?id=1411551&totalPrice=10141.14&%20
basketProducts=%5b+%7b+%22id%22%3a+1107239%2c+%22name%22%3a+%20%22%d0%9a%d1%
83%d1%80%d1%82%d0%ba%d0%b0+%20%d0%b4%d0%b5%d1%82%d1%81%d0%ba%d0%b0%d1%8f
+Rip+Curl+Small%20+Puffer+Jacket+Surf+The+Web%22%2c+%22price%22%3a+%204580%2c+%22
quantity%22%3a+1%2c%22marketing_cat%22%3a%221%22%2c%20%22category%22%3a+%22164%22%2c%22
category_name%22%20%3a%22%d0%be%d0%b4%d0%b5%d0%b6%d0%b4%d0%b0+%20%d0%b4%d0%b5%d1%82%d1%8
1%d0%ba%d0%b0%d1%8f%22%7d%2c%7b+%20%22id%22%3a+1047488%2c+%22name%22%3a+%22%d0%a8%d0%b0%
d0%bf%d0%ba%d0%b0+%20%d0%bd%d0%be%d1%81%d0%be%d0%ba+Armour+Classic+%20Beanie+Blue%22%2c+%
22price%22%3a+490%2c+%20%22quantity%22%3a1%2c+%22marketing_cat%22%3a%222%22%2c%22%20
category%22%3a%22164%22%2c%22category_name%22%20%3a%22%d0%be%d0%b4%d0%b5%d0%b6%d0%b4%d0%b0
+%20%d0%b4%d0%b5%d1%82%d1%81%d0%ba%d0%b0%d1%8f%22%7d%5d%20&coupon=A270&
client_type=new&orderTrackid=14511aca1b09e91f&url=https%3a%2f%2fsite.ru%2f%3f%20
utm_source%3dadvcake%26utm_campaign%3dcpa%26advcake_params%3dafacaafa15aac

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

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

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

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

ПараметрТип параметра: примерОписание
idstring: "114392"Номер заявки/лида/заказа
totalPricenumber: 1500Стоимость заказа. Если понятие стоимости заказа отсутствует, поле можно исключить
orderStatusstring: "1"Статус заказа. Поле можно передавать двумя способами: согласно нашим внутренним идентификаторам: "1" – Заказ в обработке; "2" – Заказ подтвержден; "3" – Заказ отменен. Согласно вашим внутренним идентификаторам — в таком случае нам потребуется описание каждого статуса, например: Принят в обработку – транслируем как статус "1"; Подтвержден – транслируем как статус "2"; Обработан – транслируем как статус "3".
orderBasketstring: "1107239" number: 1Если ставка вебмастеру зависит от категории товара, необходимо передавать состав корзины в формате JSON (см. пример ниже).
descriptionstring: "Не понравился"Причина отмены заказа (желательно, но не обязательно)
couponstring: "SALE10"Купон/промокод, использованный в заказе. Если промокоды не используются, поле можно исключить
clientTypestring: "new"Тип клиента: old (старый), new (новый). Нужен для разделения ставок и аналитики (желательно, но не обязательно)
trackIdstring: "25d478c0-36db-52cf-39sa"Значение куки advcake_track_id на момент совершения заказа (см. шаг 3)
urlstring: "https://example.ru/"Значение куки advcake_track_url на момент совершения заказа (см. шаг 3)
emailstring: "19111350"Почта клиента (можно передавать телефон или захешированный идентификатор)
dateCreatestring: "2022-09-08 17:16:25"Дата создания заказа в формате Y-m-d H:i:s (например, 2022-09-08 17:16:25)
dateLastChangestring: "2022-09-08 17:16:25"Дата изменения статуса заказа в формате Y-m-d H:i:s (например, 2022-09-08 17:16:25)

Пример значения orderBasket:

[
  {
    "id": "1107239",         // тип данных: string
    "name": "Куртка детская Rip Curl Small Puffer Jacket Surf The Web", // тип данных: string
    "price": 4580,           // тип данных: number
    "quantity": 1,           // тип данных: number
    "marketing_cat": "1",    // тип данных: string
    "categoryId": "164",     // тип данных: string
    "categoryName": "одежда детская" // тип данных: string
  },
  {
    "id": "1047488",         // тип данных: string
    "name": "Шапка носок Armour Classic Beanie Blue", // тип данных: string
    "price": 490,            // тип данных: number
    "quantity": 1,           // тип данных: number
    "marketing_cat": "2",    // тип данных: string
    "categoryId": "164",     // тип данных: string
    "categoryName": "одежда детская" // тип данных: string
  }
]

Поля массива:

  • price — стоимость за единицу товара;
  • quantity — количество товара в корзине;
  • marketing_cat — маркетинговая категория (необязательно, если нет разделения комиссии по категориям);
  • categoryId, categoryName — значения из товарного фида.

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

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

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

Назад

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

Далее