Подключение новой CPA (партнёрки) с нуля

Полное пошаговое руководство по подключению новой партнёрской сети (CPA) к трекеру Adset.Pro — от создания записи CPA до настройки постбэков и пикселей.

Что такое CPA в контексте Adset.Pro

CPA (Cost Per Action) — это партнёрская сеть или рекламодатель, который платит вам за целевые действия пользователей (регистрации, депозиты, повторные депозиты).

В Adset.Pro Партнерские сети — это сущность, которая:

• Хранит маппинг статусов — соответствие между статусами партнёрки и внутренними типами событий трекера

• Содержит postback macros — шаблоны макросов, которые партнёрка использует для отправки конверсий

• Имеет param template — шаблон GET-параметров, добавляемых к ссылкам для проброса subid/click_id

• Определяет валюту выплат и настройки дублей конверсий

Поток данных

┌─────────────┐  POSTBACK  (входящий)   ┌────────────┐  PIXEL (исходящий)  ┌───────────────┐
│  Партнёрка  │ ──────────────────────► │  Adset.Pro │ ──────────────────► │ Источник      │
│  (CPA-сеть) │  click_id, status,      │  (Трекер)  │  Facebook CAPI,     │ трафика       │
│             │  payout, currency       │            │  TikTok API,        │ (FB, TikTok)  │
│             │                         │            │  HTTP Get           │               │
└─────────────┘                         └────────────┘                     └───────────────┘

Важно понимать терминологию Adset.Pro:

• Постбэк (Postback) — это то, что приходит В Adset.Pro ИЗ партнёрок (CPA-сетей). Входящий сигнал о конверсии.

• Пиксель (Pixel) — это то, что отправляется ИЗ Adset.Pro В источники трафика (Facebook, TikTok и т.д.). Исходящий сигнал.

---

Предварительная подготовка

Перед подключением CPA убедитесь, что у вас есть:

1. Аккаунт в партнёрской сети — зарегистрируйтесь и получите доступ к личному кабинету

2. Информация о макросах — уточните у менеджера партнёрки:

   • Какой макрос используется для Click ID / subid (например, {click_id}, {sub1}, {external_id})

   • Какие статусы конверсий используются (например, lead, sale, approved, rejected)

   • Какой макрос для суммы выплаты (например, {payout}, {revenue}, {payment})

   • Какой макрос для валюты (например, {currency}, или фиксированная валюта usd)

3. Ссылку на оффер — URL, куда будет литься трафик, уточните в какой параметр ссылки можно передать clickId Adset.Pro

---

Шаг 1: Создание CPA в трекере

1. Перейдите в раздел Трекер → Партнерские Сети

2. Нажмите кнопку "+ Партнерская сеть" (зелёная кнопка в правом верхнем углу)

3. Выберите шаблон (Template) из выпадающего списка:

   • Если ваша партнёрка есть в списке шаблонов — выберите её, и поля заполнятся автоматически

   • Если партнёрки нет в списке — см. раздел ниже

4. Заполните основные поля:

---

Шаг 2: Настройка шаблона URL оффера (Param Template)

Шаблон URL оффера — это строка GET-параметров, которая автоматически добавляется к URL оффера при создании Ссылки на оффер. Она нужна для того, чтобы трекер мог идентифицировать клик, когда партнёрка отправит постбэк.

Как это работает

1. Вы добавляете Ссылку на Оффер (flow)

2. Трекер берёт paramTemplate из CPA и добавляет к URL оффера

3. Когда пользователь кликает, параметр (например, click_id=abc123) передаётся в партнёрку

4. Партнёрка использует этот параметр как subid и отправляет его обратно в постбэке в Adset.Pro

Пример

Для партнёрки с макросом sub1:

?sub1={event.event_click_id}

Для партнёрки с макросом click_id и дополнительным pixel-параметром:

?click_id={event.event_click_id}&pixel={event.cmp_pixel}

Совет: Если используете шаблон из списка — paramTemplate заполнится автоматически. Для новых партнёрок уточните у менеджера, в какой параметр нужно передать clickId из трекера.

---

Шаг 2: Настройка параметров постбэков

Раздел "Шаблон статуса постбэка" (Statuses Configuration) определяет, какие строковые статусы от партнёрки маппятся на внутренние типы событий трекера.

В Adset.Pro используется 5 типов событий CPA-конверсий:

Примеры маппинга для разных партнёрок

Keitaro:

Типичная gambling-партнёрка:

Важно: В одном поле можно указывать несколько статусов через запятую. Партнёрка может использовать разные статусы для одного и того же действия — трекер найдёт совпадение.

---

Шаг 3: Формирование URL постбэка

Раздел "Формирование URL постбэка" (Postback Macros) определяет, какие макросы партнёрка подставляет в URL постбэка. Это соответствие между макросами партнёрки и внутренними полями трекера. На основе этих данных будет сформирован готовый URL постбэка.

Где взять: У менеджера партнёрки или в документации по постбэкам (обычно раздел "Postback URL" или "S2S Postback", "Глобальный Postback").

---

Шаг 4: Копирование URL постбэка

После сохранения CPA:

1. Откройте созданную CPA в списке (Tracker → CPA)

2. Найдите и скопируйте URL постбэка — он сгенерируется автоматически

URL постбэка имеет формат:

https://adset.pro/postback?clickid={click_id}&status={status}&payout={payout}&currency={currency}

Где:

• {click_id} — макрос ClickID, который вы указали в настройках, он отвечает за возврат click_id обратно в трекере

• {status} — макрос статуса

• {payout} — макрос дохода

• {currency} — макрос валюты

Этот URL нужно передать менеджеру партнёрской сети для настройки глобального постбэка на их стороне.

---

Шаг 5: Настройка постбэка на стороне партнёрки

В личном кабинете партнёрской сети:

1. Найдите раздел "Postback", "Global Postback", "S2S Postback" или "Tracking"

2. Вставьте скопированный URL постбэка из Adset.Pro

3. Убедитесь, что:

   • Макросы партнёрки соответствуют указанным в настройках CPA

   • Выбраны нужные события (Registration, FTD, Re-Deposit и т.д.)

4. Сохраните

Пример для Keitaro: В разделе "Postback" Keitaro укажите URL:

https://adset.pro/postback?clickid={external_id}&status={status: lead=reg sale=dep}&payout={revenue}&currency={currency}

---

Шаг 6: Создание Оффера (Offer) и Ссылки на оффер (Flow)

Создание Оффера (Offer)

1. Перейдите в раздел Трекер → Офферы

2. Нажмите "+ Оффер"

3. Заполните:

   • Name — название оффера

   • Default Revenue — дефолтная выплата, которую делает партнерская программа

   • Партнерская сеть — выберите созданную Партнерскую сеть (CPA)

Создание Ссылки на оффер (Flow)

1. Перейдите в раздел Трекер → Ссылки на оффер

2. Нажмите "+ Ссылка на оффер"

3. Заполните:

   • Название — название потока

   • Партнерская сеть — выберите Партнерскую сеть (Шаблон URL автоматически добавится к URL)

   • Оффер — выберите Offer

   • Тип — тип оффера

     • Внешняя ссылка - пользователь будет перенаправлен на внешний URL (на лэндинг Партнерской программы или вашего рекламодателя)

     • Локальный лэндинг - пользователь по падет на загруженный вами лэндинг

   • URL - ссылка на которую будет перенаправлен пользователь в конце воронки (для типа Внешняя ссылка)

   • Лэндинг — выберите загруженный ранее лендинг (для типа Локальный лэндинг )

Как paramTemplate работает в Ссылке на оффер: При создании Ссылки на оффер трекер берёт paramTemplate из CPA и добавляет к URL оффера. Например:

• URL оффера: https://partner.com/offer/123

• ParamTemplate CPA: ?sub1={event.event_click_id}

• Итоговый URL: https://partner.com/offer/123?sub1={event.event_click_id}

Трекер автоматически подставит реальный click_id вместо {event.event_click_id} при каждом клике.

---

Шаг 7: Настройка пикселей (исходящих постбэков)

Пиксели — это исходящие из Adset.Pro события, которые отправляются в источники трафика (Facebook, TikTok и др.) для оптимизации рекламных алгоритмов или в Telegram чат для уведомлений.

Типы пикселей

Создание пикселя

1. Перейдите в раздел Трекер → Пиксели (или Пиксели и постбэки)

2. Нажмите "+ Пиксель"

3. Выберите тип пикселя

4. Заполните:

   • Название — понятное имя (например, "FB CAPI Main Account")

   • Тип - тип пикселя

   • Pixel ID — ID пикселя из рекламного кабинета (для FB/TikTok)

   • Access Token — токен доступа к API (для FB/TikTok)

   • Маппинг событий — соответствие внутренних событий трекера событиям источника:

5. Привяжите пиксель к кампании в настройках стрим сетов кампании

Для HTTP Get пикселя

Укажите URL с макросами:

https://partner.network/postback?click_id={event.ext_click_id}&status={postback.event}&payout={event.event_revenue}

Доступные макросы для URL:

---

Шаг 8: Тестирование

Проверка постбэка (Партнерской сети → Adset.Pro)

1. Снимите все фильтры в настройках кампании

2. Перейдите по трекинговой ссылке кампании

3. Совершите тестовую регистрацию на оффере партнёрки

4. Проверьте раздел Логи → Логи конверсий — конверсия должна появиться с типом Registration

5. Если конверсии нет через 1-2 минуты:

   • Проверьте, что URL постбэка правильно настроен в партнёрке

   • Проверьте, что регистрация появилась в статистике партнерки.

   • Проверьте логи конверсий в Adset.Pro

   • Проверьте логи постбэков в Партнерской сети

   • Убедитесь, что макрос Click ID совпадает

Проверка пикселя (Adset.Pro → Источник трафика)

1. При входящей конверсии проверьте раздел Логи → Лог пикселей

2. Статус должен быть SUCCESS (зелёный)

3. Если статус ERROR:

   • Проверьте Access Token и Pixel ID

   • Для Facebook: убедитесь, что Conversions API включена

   • Для TikTok: проверьте Events API token

   • Проверьте данные запроса

   • Проверьте Данные ответа

---

Что делать, если партнёрки нет в шаблонах

Если нужной Партнерской сети нет в списке предустановленных шаблонов:

1. Создайте Партнерской сеть (CPA) вручную — выберите "No template" или пустой шаблон

2. Заполните все поля вручную по информации от менеджера партнёрки:

   • Statuses (маппинг статусов)

   • Postback Macros (макросы)

   • Param Template (шаблон параметров)

3. Сохраните как (если хотите использовать повторно) — обратитесь к администратору для добавления в систему шаблонов CPA

Где найти информацию о макросах

• Документация партнёрки — раздел "API", "Postback", "Tracking", "Integration"

• Менеджер партнёрки — попросите "postback URL format" и "available macros"

• Личный кабинет — раздел настроек постбэка обычно показывает доступные макросы

---

Troubleshooting

Постбэк не приходит

Конверсия приходит, но статус неверный

• Проверьте маппинг статусов: откройте CPA → Statuses

• Добавьте проблемный статус в нужное поле (например, если approved приходит как accept, добавьте approved в поле Accept)

Дубли конверсий

• Включите "Принимать дубли конверсий" в настройках Партнерской сети (CPA), если партнёрка может слать повторные постбэки

• Выберите типы событий, для которых разрешены дубли: Registration (CPA_HOLD), Deposit (CPA_ACCEPT), Re-deposit (CPA_REDEP)

Пиксель не отправляется

---

Связанные документы

• Глоссарий терминов — все термины арбитража трафика в контексте Adset.Pro

• Руководство по пикселям — детальная настройка каждого типа пикселей

• Руководство по источникам — настройка источников трафика

• Интеграция с Keitaro — пример подключения трекера Keitaro как CPA