Пример инструкции Postback Lead для финансовых офферов

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

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

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

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

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

    • Cookie - обезличенный идентификатор пользователя;

    • Cookie - обезличенный идентификатор сессии;

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

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

    • User-Agent;

    • Размер экрана;

    • Размер окна браузера;

    • Открытие страницы в iframe;

    • URL текущей страницы и ее реферер;

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

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

Подсказка

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

Примечание

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

Содержание:

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

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

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

  4. Настройка postback;

  5. Установка кода, формирующего DATA-объект на страницы.

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

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

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

Если вы используете Яндекс.Метрику, предоставьте доступ для аккаунта metrika@advcake.com.

Подсказка

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

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

Установить JS-код можно двумя способами:

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

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

  1. Через 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-х букв и цифр.

  2. 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

Номер заявки/лида/заказа

totalPrice

Стоимость заявки/лида. Если понятие стоимости заявки отсутствует, передавать данное поле всегда равным 0

coupon

Передавать значение промокода

clientType

Тип клиента: “новый” (new), “старый” (old). Может понадобиться для разделения ставок для новых/старых клиентов, а также для аналитики

trackid

Значение куки advcake_track_id на момент совершения заказа (см. шаг 3)

url

Значение куки advcake_track_url на момент совершения заказа (см. шаг 3)

email

Почта клиента (можно передавать телефон или захешированный идентификатор)

dateCreate

Дата создания заказа в формате Y-m-d H:i:s (например, 2022-09-08 17:16:25)

timeLastChanged

Дата изменения статуса заказа в формате Y-m-d H:i:s (например, 2022-09-08 17:16:25)

status

Статус заявки/лида/заказа:

1 – Заявка в обработке;

2 – Заявка подтверждена;

3 – Заявка отменена.

product

Соответствующее значение под конкретный продукт, например:

credit_card - Кредитная карта;

RKO - Расчетно-кассовое обслуживание.

leadName

При необходимости (например, наличие двух или более категорий продукта) передается категория продукта:

Например, для продукта «РКО», могут быть указаны следующие категории:

RKO-IP - Расчетно-кассовое обслуживание для ИП;

RKO-OOO - Расчетно-кассовое обслуживание для ООО.

Примечание

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

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