Partnerketten und Vertikale

1) Begriffe und Rollen

Vertical - Branchensegment und/oder Wertschöpfungskette (z.B.: Fintech/Payments, Marketing/Affiliates, Content/Provider, Identification/CUS, Fraud, Logistics/Fulfillment, Support BPO).

• Referral/Influencer/Affiliate - Führen Sie Traffic/Leads (CPA/RevShare).
• Reseller/Distributor - Verkauf und Wartung auf lokalen Märkten.
• OEM/Embedded/White-Label - Embedded Funktionalität, Release unter eigener Marke.
• Technologie/ISV/SI - ergänzen das Produkt mit Modulen und Integrationen.
• Data/Compliance - KYC/AML/скоринг/платежи/антифрод.
• Content/Media/Streaming - Lizenzen, Content Feeds, Promo Assets.

2) Wertkarte und Partnerkette

Zuerst erfassen wir die Wertstromkarte: von der Quelle der Nachfrage → zum Produkt → zur Monetarisierung und zu Post-Sale-Diensten.

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]

Für jeden Pfeil definieren wir: Datenvertrag, Metriken (SLI/SLO), Zugriffe und Geheimnisse, Datenschutzregeln, kommerzielles Modell.

3) Kooperations- und Handelsmodelle

3. 1 Kooperationsformate

Referral/Affiliate: Reflexe, Postbacks, Cookies/Server-Attribution.
Reseller/Distributor: Quoten, Preise, lokale Gesetzeskonformität, L1/L2 Unterstützung.
OEM/Embedded/White-Label: SDK-Pakete, UI-White-Label, Release-Train und API-Kompatibilität.
Marktplatz/App Store: Integrationskatalog, Abrechnung über die Plattform, Revue und Sicherheit.

3. 2 Kommerzielle Modelle

CPA (Cost per Action): Fix für die bestätigte Aktion.
RevShare:% der Marge/Einnahmen; Es ist wichtig, die Berechnungsbasis und das Attributionsfenster festzulegen.
Hybrid: CPA + RevShare.
MDF/Co-op: Gemeinsamer Marketingfonds für das Erreichen von KPIs.
Mindestgarantien: Mindestzahlung/Quote.

Wesentliche Vorbehalte: Anti-Fraud, Targeting-Klauseln (Geo/Kanäle), Zeitraum der „Reklamationen“, Prüfungsrecht, Haftungsgrenzen.

4) Datenverträge und Namensnennung

4. 1 Zuschreibung

Fenster (z.B. '7/30' Tage), Modelle (last-click, data-driven), Kanalpriorität, Server-Postbacks.
Quellen: UTM/ref-Parameter, c2s-Ereignisse, signierte Webhooks, dedupe durch 'event _ id'.
Bedingungen: Status „qualifiziert“, Dedup, Stornierung/Refand, „Cool-Off“ Zeitraum.

4. 2 Datenvertrag

Schemata (JSON Schema/Avro), Pflichtfelder/PII, Rechtsrahmen, TTL/Retenschen, Betroffenenrechte (löschen/korrigieren), Lokalisierung (Region).
Integration SLA: Anteil der gelieferten Ereignisse ≤ X Minuten, Reihenfolge/Idempotenz, Wiederholungsfenster.

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) Integrationsmuster

REST/gRPC für den Online-Austausch (Quoten/Limits, Retry-Policies, Idempotence).
Webhooks/Eventing - signierte Ereignisse, Wiederholung mit exponentieller Verzögerung, verzögerte Warteschlangen für „langsame“ Partner.
Batch/SFTP/Blob - Berichte, Bögen, reconciliation.
SDK/Embeds - Minimale Verbindungsreibung, Versionsrichtlinien, Feature-Flags.
Outbox/Inbox - garantierte Lieferung, Dedup, Audit.
Consent/Privacy API - Propagierung von Einwilligungen/Opt-out entlang der Kette.

6) Kaskadierende SLAs/OLAs und Eskalationen

SLA extern: Verfügbarkeit, p99, Anteil der Ereignisse im Fenster, Attributionsgenauigkeit.
Interne OLAs: PRM-Operationen, Verifizierung, Saport-Antwort, Ticketschließung.
Kaskadierung: externe Verletzung → Auslöser interner Aktionen, Gutschriften/Strafen (gemäß Vertrag), Status im PRM.
Eskalationen: L1 Partner, L2 Plattform, L3 Infrastrukturanbieter; feste Antwortfenster.

7) PRM: Betriebsmodell und Prozesse

1. Sourcing/Screening: Fragebogen, CUS/Sanktionen, Reputation, Tech-Chancen.

2. Onboarding: Verträge, Schlüssel/API, Sandbox, Integrationschecklisten, Testfälle.

3. Enablement: Training, Template Library von Creatives/UTM, Guides zu Content/Marke.

4. Run: Reporting, MDF, gemeinsame OKRs, SLA-Status, Alerts.

5. Review & Growth: QBR (quarterly business review), Co-Roadmap, Cross-Sell.

6. Exit/Change: Kündigung, Datenentnahme, Schlüsselentzug, Post-Mortem.

PRM-Artefakte: Partnerpass, Berechtigungsmatrix, Zustimmungsregister, Risikoregister, Playbooks, API-Skopes, Versionskompatibilitätsstatus.

8) Vertikale: Merkmale und Invarianten

Marketing/Affiliates: Kampf gegen Frod (Bots, Cookie-Stuffing), strikte Attribution, Content-Guides und Markensicherheit.
Zahlungen/Fintech: Datenhoheit, 3-D Secure/PSD-ähnliche Anforderungen, KMS/Verschlüsselung, Risiko-Feedbacks.
KUS/Fraud: sensible PD, DPA, TTL, Subjektrechte, Matchqualität.
Inhalt/Medien: Lizenzierung, DRM/Wasserzeichen, Metadaten, Nutzungsberichterstattung.
Support VRO/Reseller: L1/L2-Skripte, Skripte, Schulungen, Qualitätskontrolle.

Gemeinsame Invarianten: PoLP, Verschlüsselung, Audit, Ereignis-Idempotenz, klare Zuordnungs- und Berechnungsfenster.

9) Channel-Konfliktmanagement

Prioritätsregeln: Wer den Kunden beim Überqueren „besitzt“ (Erstregistrierung, Aktivität, Scheck).
Schutz/Exklusivität: exklusiv nach Geo/Segment/Kampagne - mit KPIs und Deadline.
„Last-touch vs data-driven“: Das Modell und seine Überarbeitung erfassen.
Arbitrage: Analyseprozess, Anspruchsfenster, Beweisgrundlage (Protokolle, Unterschriften, Trace-ID).

10) Risiken und Kontrolle

Legal/Brand: Verbotene Kreative, Nichteinhaltung des lokalen Rechts/Werbung.
Finanziell: falsche Zuordnung, „graue“ Optimierung für CPA, Chargeback-Risiko.
Technisch: Schlüsselleck/PII, Unzustellbarkeit von Webhooks, Schaltungsdrift.
Operational: Abhängigkeit von einem großen Partner, „Black Boxes“ in den Berechnungen.

Kontrollen: Politik als Code (OPA/Kyverno), Secret-Scans, Limits, Honey-Token, „Double“ -Kalkulation (Ihr und Partner) + Reconciliation.

11) Metriken und KPIs

Quelle der Nachfrage: CAC, LTV/CAC, ARPU/ARPPU, CR, churn by partner.
Attributionsqualität: Anteil „qualified“, Anteil dedup, Diskrepanz der Berichte (<ε).
Operativ: Onboarding-Zeit, Anteil der Partner mit aktuellen SDK-Schlüsseln/Versionen, Event Delivery SLO.
Risiko/Compliance:% der Partner mit gültigen DPAs, SLA-Passrate, Incidents/Million Events.
Wachstum: Umsatzanteil aus neuen Verticals, Cross-Sell, Anzahl aktiver Integrationen.

12) Vorlagen und Beispiele

12. 1 Partnerpass (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-Gate-Richtlinie (Pseudo-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 (Pseudo-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) Anti-Muster

„Erst unterschreiben wir - dann erfinden wir die Integration“ → tote Partner und Schulden.
Attribution nur durch Cookies und ohne Serversignale → Streitigkeiten und Betrug.
Geheimnisse und Webhooks ohne Unterschrift/Anti-Replay → Leaks und Ersatz.
Ein „Super-Partner“> 50% des Verkehrs → Konzentrationsrisiko.
Das Fehlen von Reconciliation und Audit → chronische Diskrepanzen in den Berechnungen.
Unkoordinierte SLAs/OLAs → „Grauzonen“ der Verantwortung.
Ignorieren Sie lokale Beschränkungen für Inhalte/Werbung → Sperren/Strafen.

14) Checkliste des Architekten

1. Ist eine Wertkarte und Daten-/Geldpfeile für jede Vertikale aufgebaut?
2. Für jeden Partner gibt es einen Pass: Verträge, Regelungen, SLO, Schlüssel, Regionen, Eigentümer?
3. Attribution: Fenster, Modell, Server-Postbacks, Dedup und Reconciliation - definiert?
4. Integrationen: Signatur, Retrays, Idempotenz, Limiter - umgesetzt?
5. Politiker als Code: DPA/SLA/Signaturen/Retenschen - Gates in CI/CD?
6. PRM-Prozesse: Onboarding, Training, QBR, MDF, Exit-Plan - beschrieben und ausgeführt?
7. Kaskadierende SLAs/OLAs und Eskalationen - erfasst und getestet?
8. Metriken: CAC/LTV/CVR/ ε-Abweichungen, SLO-Lieferung - auf Dashboards?
9. Risikokontrolle: Anti-Betrug, Konzentrationsgrenzen, Honigmarken, Schlüsselrückrufplan?
10. API/SDK/Event-Versionierung und „Kompatibilitätsfenster“ - im Releasekalender?

Schluss

Partnerketten sind eine Architektur von Beziehungen, Daten und Anreizen. Wenn Sie eine Wertkarte, formale Datenverträge, transparente Attribution, kaskadierende SLAs und verwaltete Integrationen haben, wird das Ökosystem vorhersehbar: Partner sehen den Nutzen, Benutzer die Qualität und die Plattform das nachhaltige Wachstum. Bauen Sie PRM als Produkt auf, automatisieren Sie Richtlinien und messen Sie die Auswirkungen - und Ihr Netzwerk wird ohne Chaos skaliert.