Партнерські ланцюги та вертикалі

1) Терміни і ролі

Вертикаль - галузевий сегмент і/або ланцюжок вартості (наприклад: Фінтех/Платежі, Маркетинг/Афіліати, Контент/Провайдери, Ідентифікація/КУС, Антифрод, Логістика/Фулфілмент, Support BPO).

• Referral/Influencer/Affiliate - приводять трафік/ліди (CPA/RevShare).
• Reseller/Distributor - продають і обслуговують на локальних ринках.
• OEM/Embedded/White-label - вбудовують функціональність, випускають під своїм брендом.
• Technology/ISV/SI - доповнюють продукт модулями та інтеграціями.
• Data/Compliance - KYC/AML/скоринг/платежі/антифрод.
• Content/Media/Streaming - ліцензії, контент-фіди, промо-активи.

2) Карта цінності та ланцюжок партнерів

Спочатку фіксуємо карту потоку цінності: від джерела попиту → до продукту → до монетизації і пост-сейл сервісів.

mermaid flowchart LR
A [Traffic Source/Partner 1] -->    Lead/Event    In [Platform/Product]
B -->    Deal/Transaction    C [Payment/Antifraud/ACC]
B -->    Content/API    D [Content Provider]
B -->    Webhooks/Events    E [PRM/CRM/Analytics]
B -->    SLA/Support    F [Reseller/Support-BPO]

Для кожної стрілки визначаємо: контракт даних, метрики (SLI/SLO), доступи і секрети, правила приватності, комерційну модель.

3) Моделі співробітництва та комерції

3. 1 Формати співпраці

Referral / Affiliate: рефссылки, постбеки, куки/серверна атрибуція.
Reseller / Distributor: квоти, ціни, локальна відповідність закону, L1/L2 підтримка.
OEM / Embedded / White-label: пакети SDK, white-label UI, release train і сумісність API.
Маркетплейс/App Store: каталог інтеграцій, білінг через платформу, рев'ю і безпеку.

3. 2 Комерційні моделі

CPA (Cost per Action): фікс за підтверджену дію.
RevShare: % від маржі/виручки; важливо зафіксувати базу розрахунку і вікно атрибуції.
Hybrid: CPA + RevShare.
MDF/Co-op: спільний маркетинговий фонд за досягнення KPI.
Minimum Guarantees: мінімальний платіж/квота.

Ключові застереження: анти-фрод, таргет-клаузи (гео/канали), період «претензій», право аудиту, ліміти відповідальності.

4) Договори даних та атрибуція

4. 1 Атрибуція

Вікно (наприклад,'7/30'днів), моделі (last-click, data-driven), пріоритет каналів, серверні постбеки.
Джерела: UTM/реф-параметри, c2s-події, підписані вебхуки, dedupe по'event _ id'.
Умови: статус «qualified», дедуп, скасування/рефанд, «cool-off» період.

4. 2 Договір даних

Схеми (JSON Schema/Avro), поля обов'язкові/PII, правова база, TTL/ретеншен, права суб'єкта (видалити/виправити), локалізація (регіон).
Інтеграційний SLA: частка доставлених подій ≤ X хвилин, порядок/ідемпотентність, вікна повторів.

json
{
"event_id": "uuid",
"occurred_at_utc": "2025-10-31T12:01:02Z",
"type": "partner. conversion. v1",
"partner_id": "aff_123",
"attributes": {
"click_id": "abc",
"amount": 49. 90,
"currency": "EUR",
"status": "qualified"
},
"signature": "base64",
"version": 1
}

5) Інтеграційні патерни

REST/gRPC для онлайнового обміну (квоти/лімітери, retry-політики, ідемпотентність).
Webhooks/Eventing - підписані події, повтор з експоненціальною затримкою, затримані черги для «повільних» партнерів.
Batch/SFTP/Blob - звіти, зведення, reconciliation.
SDK/Embeds - мінімальне тертя підключення, політики версій, feature-flags.
Outbox/Inbox - гарантована доставка, дедуп, аудит.
Consent/Privacy API - пропагандація згоди/opt-out по ланцюжку.

6) Каскадні SLA/OLA і ескалації

SLA зовнішні: доступність, p99, частка подій у вікні, точність атрибуції.
OLA внутрішні: PRM-операції, верифікація, відповідь саппорту, закриття тікетів.
Каскадування: зовнішнє порушення → тригери внутрішніх дій, кредити/штрафи (за договором), статус в PRM.
Ескалації: L1 партнер, L2 платформа, L3 вендор інфраструктури; фіксовані вікна відповіді.

7) PRM: операційна модель і процеси

1. Sourcing/Screening: анкета, КУС/санкції, репутація, тех-можливості.

2. Onboarding: договори, ключі/API, пісочниця, чек-листи інтеграції, тест-кейси.

3. Enablement: навчання, бібліотека темплейтів креативів/UTM, гайди по контенту/бренду.

4. Run: звітність, MDF, спільні OKR, статуси SLA, алерти.

5. Review & Growth: QBR (quarterly business review), ко-роадмап, крос-селл.

6. Exit/Change: розірвання, вивезення даних, відкликання ключів, пост-мортем.

PRM-артефакти: паспорт партнера, матриця дозволів, реєстр згоди, реєстр ризиків, playbooks, скоупи API, статус сумісності версій.

8) Вертикалі: особливості та інваріанти

Маркетинг/Афіліати: боротьба з фродом (боти, cookie-stuffing), сувора атрибуція, контент-гайди і бренд-безпека.
Платежі/Фінтех: суверенітет даних, 3-D Secure/PSD-подібні вимоги, KMS/шифрування, зворотні зв'язки по ризику.
КУС/Антифрод: чутливі ПД, DPA, TTL, права суб'єкта, якість матчингу.
Контент/Медіа: ліцензування, DRM/водяні знаки, метадані, звітність по використанню.
Support ВРО/Реселлери: сценарії L1/L2, скрипти, навчальні курси, контроль якості.

Загальні інваріанти: PoLP, шифрування, аудит, ідемпотентність подій, чіткі вікна атрибуції та розрахунків.

9) Управління конфліктами каналів

Правила пріоритету: хто «володіє» клієнтом при перетині (первинна реєстрація, активність, чек).
Protection/Exclusivity: ексклюзив по гео/сегменту/кампанії - з KPI і терміном.
«Last-touch vs data-driven»: зафіксувати модель і її перегляд.
Арбітраж: процес розборів, вікна претензій, доказова база (логи, підписи, трейс-ID).

10) Ризики та контроль

Правові/брендові: заборонені креативи, невідповідність місцевому праву/рекламі.
Фінансові: невірна атрибуція, «сіра» оптимізація під CPA, chargeback-ризик.
Технічні: витік ключів/PII, недоставка вебхуків, дрейф схем.
Операційні: залежність від одного великого партнера, «чорні ящики» в розрахунках.

Контролі: політика як код (OPA/Kyverno), секрет-скани, лімітери, honey-tokens, «подвійний» розрахунок (ваш і партнера) + reconciliation.

11) Метрики та KPI

Джерело попиту: CAC, LTV/CAC, ARPU/ARPPU, CR, churn by partner.
Якість атрибуції: частка «qualified», частка дедуп, розбіжність звітів (<ε).
Операційні: час онбордингу, частка партнерів з актуальними ключами/версіями SDK, SLO доставки подій.
Ризик/комплаєнс: % партнерів з діючими DPA, SLA pass-rate, інциденти/млн подій.
Зростання: частка виручки з нових вертикалей, крос-селл, кількість активних інтеграцій.

12) Шаблони та приклади

12. 1 Паспорт партнера (YAML)

yaml partner_id: "aff-123"
name: "Acme Media"
vertical: "Marketing/Affiliates"
regions: ["EU","TR","LATAM"]
contracts:
msa: "2025-01-10"
dpa: "2025-01-10"
commercials:
model: "Hybrid"
cpa: 50 revshare: "20% of net"
attribution:
window_days: 30 model: "last_click"
postback: "https://acme. example/postback"
data_contract:
event_schema: "conversion. v1"
pii: false retention: "365d"
delivery_sla: "95% <= 5m"
security:
webhooks: { signature: "HMAC-SHA256", replay: 300 }
scopes: ["conversions:read"]
status:
sandbox: "passed"
production: "active"
owners:
biz: "partner-team"
tech: "integrations-team"

12. 2 Політика PRM-гейту (псевдо-Rego)

rego package prm. gates deny["No DPA"] { input. partner. dpa == null }
deny["Weak signature"] { input. partner. webhooks. signature not in {"HMAC-SHA256","Ed25519"} }
deny["Missing attribution window"] { not input. partner. attribution. window_days }

12. 3 Reconciliation (псевдо-SQL)

sql
SELECT a. event_id
FROM partner_report a
LEFT JOIN internal_events b ON a. event_id = b. event_id
WHERE b. event_id IS NULL AND a. occurred_at >= now() - interval '30 days';

13) Анти-патерни

«Спочатку підпишемо - інтеграцію придумаємо потім» → мертві партнери і борги.
Атрибуція тільки по куках і без серверних сигналів → суперечки і шахрайство.
Секрети і вебхуки без підпису/анти-replay → витоку і підміна.
Один «супер-партнер»> 50% трафіку → концентраційний ризик.
Відсутність reconciliation і аудиту → хронічні розбіжності в розрахунках.
Неузгоджені SLA/OLA → «сірі зони» відповідальності.
Ігнорування локальних обмежень по контенту/рекламі → блокування/штрафи.

14) Чек-лист архітектора

1. Побудована карта цінності і стрілки даних/грошей по кожній вертикалі?
2. Для кожного партнера є паспорт: договори, схеми, SLO, ключі, регіони, власник?
3. Атрибуція: вікно, модель, серверні постбеки, дедуп і reconciliation - визначені?
4. Інтеграції: підпис, ретраї, ідемпотентність, лімітери - реалізовані?
5. Політики як код: DPA/SLA/сигнатури/ретеншен - гейти в CI/CD?
6. PRM-процеси: онбординг, навчання, QBR, MDF, exit-план - описані і виконуються?
7. Каскадні SLA/OLA і ескалації - зафіксовані і тестуються?
8. Метрики: CAC/LTV/CVR/ ε -розходження, SLO доставки - на дашбордах?
9. Ризик-контроль: анти-фрод, ліміти концентрації, honey-tokens, план відгуків ключів?
10. Версіонування API/SDK/подій і «вікна сумісності» - в календарі релізів?

Висновок

Партнерські ланцюги - це архітектура відносин, даних і стимулів. Коли у вас є карта цінності, формальні контракти даних, прозора атрибуція, каскадні SLA і керовані інтеграції, екосистема стає передбачуваною: партнери бачать вигоду, користувачі - якість, а платформа - стійке зростання. Будуйте PRM як продукт, автоматизуйте політику і вимірюйте ефекти - і ваша мережа буде масштабуватися без хаосу.