Партнерські мережі (CPA)

Партнерська мережа (CPA-мережа) — довідник рекламодавців, з якими працює команда: назва, валюта виплат, маппінг статусів постбеків на події трекера, макроси постбека і шаблон параметрів для посилань. Офери й потоки завжди належать якійсь CPA-мережі. У кабінеті це розділ Трекер → Aff. Networks (див. Aff. Networks (Партнерські мережі) та Статуси конверсій і налаштування postback).

Отримання токена, загальний формат відповідей, параметри списків і помилки — у головній статті розділу.

Скоупи

Ендпоінти

Права cpa:list, cpa:read, cpa:create є в усіх ролей. cpa:update немає в BUYER — для його токена PATCH /api/cpa/{id} поверне 403 forbidden навіть за наявності скоупу api:cpa:write. Видимість: ADMIN — усі мережі, решта ролей — мережі своєї команди (BUYER — свої та доступні за налаштуваннями доступу). Чужа мережа → 404.

Параметри списку GET /api/cpa

curl -G 'https://adset.pro/api/cpa' \
  -H 'Authorization: Bearer pat_…' \
  --data-urlencode 'pageSize=100' \
  --data-urlencode 'sort=name:asc' \
  --data-urlencode 'filter[isActive]=true'

Об'єкт CPA-мережі

statuses — маппінг статусів

Значення — рядки, які партнерка надсилає в параметрі статусу постбека. Кожне поле відповідає події трекера:

postbackMacros — параметри постбека

Як називаються параметри в постбеку партнерки, з яких трекер бере дані:

POST /api/cpa — створити CPA-мережу

Обов'язкове поле — name. Власник і команда за замовчуванням беруться з токена; ADMIN зобов'язаний передати team та/або user (інакше 400). Заповнювати statuses і postbackMacros вручну необов'язково — зручніше взяти їх із CPA-шаблону потрібної партнерки.

// POST /api/cpa
{
  "name": "Casino Partners",
  "shortName": "casinop",
  "description": "Прямий рекламодавець, виплати в EUR",
  "currency": "EUR",
  "paramTemplate": "sub1={click_id}&sub2={campaign_id}",
  "statuses": { "hold": "lead", "accept": "sale", "redep": "redeposit", "decline": "rejected", "trash": "trash" },
  "postbackMacros": { "clickId": "sub1", "status": "status", "revenue": "payout", "currency": "EUR", "externalId": "conversion_id" },
  "acceptDuplicates": false,
  "tags": []
}

Відповідь — 201 Created, заголовок Location: /cpa/{id}:

{
  "data": {
    "id": "6704b1c2d3e4f5a6b7c8d9e0",
    "name": "Casino Partners",
    "description": "Прямий рекламодавець, виплати в EUR",
    "shortName": "casinop",
    "isActive": true,
    "statuses": { "accept": "sale", "redep": "redeposit", "hold": "lead", "decline": "rejected", "trash": "trash" },
    "postbackMacros": { "clickId": "sub1", "status": "status", "revenue": "payout", "currency": "EUR", "externalId": "conversion_id" },
    "currency": "EUR",
    "paramTemplate": "sub1={click_id}&sub2={campaign_id}",
    "acceptDuplicates": false,
    "acceptDuplicatesFor": ["CPA_HOLD", "CPA_ACCEPT"],
    "user": "64a0…",
    "team": "64b0…",
    "tags": [],
    "created": "2026-10-13T10:00:00.000Z",
    "updated": "2026-10-13T10:00:00.000Z"
  },
  "traceId": "01HX…"
}

PATCH /api/cpa/{id} — змінити CPA-мережу

Усі поля необов'язкові; передавайте лише те, що змінюєте. Відповідь 200 OK з повним об'єктом.

Прапорець ?changeAllUrl=true

Якщо в тілі змінюється paramTemplate, прапорець каскадно оновлює url усіх потоків цієї CPA-мережі:

• у мережі не було шаблону — новий дописується до URL через ? або &;
• шаблон був — його входження в URL замінюється на новий.

Без прапорця змінюється лише сама мережа, URL потоків залишаються незмінними. Потоки оновлюються в межах видимості власника токена.

# змінити шаблон параметрів і прокинути його в усі потоки мережі
curl -X PATCH 'https://adset.pro/api/cpa/6704b1c2d3e4f5a6b7c8d9e0?changeAllUrl=true' \
  -H 'Authorization: Bearer pat_…' \
  -H 'Content-Type: application/json' \
  -d '{ "paramTemplate": "sub1={click_id}&sub2={campaign_id}&sub3={source_id}" }'

Було: https://partner.example/offer?aff=123&sub1={click_id}&sub2={campaign_id} → стало: https://partner.example/offer?aff=123&sub1={click_id}&sub2={campaign_id}&sub3={source_id}.

Помилки

Пов'язані статті

• CPA-шаблони — готові statuses, postbackMacros і paramTemplate популярних партнерок
• Офери та Потоки — дочірні сутності мережі
• Статуси конверсій і налаштування postback — як партнерка має надсилати постбеки
• Підключення нової CPA (партнерки) з нуля