Передача параметров и постбэк
Источник связывает площадку и Qubix в обе стороны:
- Из ссылки в Qubix — когда посетитель кликает по объявлению, Qubix забирает из ссылки нужные параметры (идентификатор объявления, пиксель и др.) и привязывает их к визиту.
- Из Qubix на площадку — когда происходит событие (регистрация, депозит), Qubix отправляет на площадку постбэк, чтобы она знала результат.
Настройки обоих направлений задаются в источнике — см. Создание источника.
Параметры в ссылке объявления
Какие значения брать из ссылки, задаёт таблица Параметры источника. Для каждого параметра вы указываете:
- URL-ключ — под каким ключом значение приходит в ссылке;
- Placeholder — что площадка подставит в значение (свой макрос или фиксированное значение).
Пример ссылки для объявления Facebook:
https://ваш-домен/?pixel=123456789&ad_id={{ad.id}}
Здесь {{ad.id}} — макрос Facebook: при показе объявления площадка сама заменит его на реальный идентификатор. Готовую ссылку под ваш источник Qubix собирает в блоке Пример URL для объявления на форме источника — её можно скопировать и вставить в поле URL объявления на площадке.
Параметр Ad ID нужен, чтобы связать клики с объявлениями и видеть по ним статистику. Без него источник продолжит работать, но детализация по объявлениям будет недоступна.
О параметрах на стороне ссылки кампании — Ссылка кампании и параметры.
S2S-постбэк: уведомление площадки
Постбэк (server-to-server, S2S) — это запрос, который Qubix отправляет на площадку при наступлении события. Шаблон запроса задаётся в поле S2S постбэк источника. В шаблон вставляются макросы — Qubix подставит в них реальные значения перед отправкой:
| Макрос | Значение |
|---|---|
{external_id} | Идентификатор визита/лида на стороне площадки. |
{status} | Статус события (например, регистрация, депозит, отказ). |
{revenue} | Доход по событию. |
{payout} | Выплата по событию. |
{currency} | Валюта. |
{sub_id_N} | Дополнительные метки (sub_id_1, sub_id_2 и т. д.). |
{tid} | Идентификатор транзакции. |
Пример шаблона постбэка:
https://source.com/postback?subid={external_id}&status={status}&payout={revenue}
Facebook: Conversions API вместо постбэка
Для источника на шаблоне facebook обычный постбэк не используется. Вместо него Qubix отправляет события напрямую в Facebook Conversions API. Вы настраиваете только соответствие событий: какое событие Qubix какому событию Facebook соответствует (например, депозит → Purchase). Идентификатор пикселя берётся из ссылки клика, а токен доступа — из реестра пикселей.
Подробнее — Facebook Conversions API и Пиксели.