Партнерские цепи и вертикали

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

Вертикаль — отраслевой сегмент и/или цепочка стоимости (например: Финтех/Платежи, Маркетинг/Аффилиаты, Контент/Провайдеры, Идентификация/KYC, Антифрод, Логистика/Фулфилмент, 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: анкета, KYC/санкции, репутация, тех-возможности.

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/шифрование, обратные связи по риску.
KYC/Антифрод: чувствительные ПД, DPA, TTL, права субъекта, качество матчинга.
Контент/Медиа: лицензирование, DRM/водяные знаки, метаданные, отчетность по использованию.
Support BPO/Реселлеры: сценарии 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 как продукт, автоматизируйте политику и измеряйте эффекты — и ваша сеть будет масштабироваться без хаоса.