Підключення нової 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