Партнёрские сети (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 (партнёрки) с нуля