Catene di partnership e verticali

1) Termini e ruoli

Verticale è un segmento di settore e/o catena di valore (ad esempio Fintech/Pagamenti, Marketing/Affiliati, Contenuti/Provider, Identificazione/CUS, Antifrod, Logistica/Fulfilment, Support BPO).

• Referral/Influencer/Affiliate - Causano traffico/lidi (CPA/RevShare).
• Reseller/Distributor - vendono e gestiscono i mercati locali.
• OEM/Embedded/White-label - Integrano funzionalità, producono con il loro marchio.
• Technology/ISV/SI - completano il prodotto con moduli e integrazioni.
• Data/Compliance - KYC/AML/screening/pagamenti/antifrode.
• Content/Media/Streaming - licenze, contenuti fide, beni promozionali.

2) Mappa del valore e catena dei partner

Prima di tutto, rileviamo la mappa del flusso di valore, dalla fonte della domanda al prodotto, alla monetizzazione e ai servizi post-cassetta.

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]

Per ogni freccia definiamo il contratto di dati, le metriche (SLI/SLO), la disponibilità e i segreti, le regole di privacy, il modello commerciale.

3) Modelli di collaborazione e commerciale

3. 1 Formati di collaborazione

Referral/Affiliate - Rifornimenti, postback, cookie/assegnazione server.
Reseller/Distributor: quote, prezzi, conformità locale, supporto L1/L2.
OEM/Embedded/White-label: pacchetti SDK, white-label UI, release treno e compatibilità API.
Marketplace/App Store: catalogo delle integrazioni, bollo attraverso piattaforma, gelosia e sicurezza.

3. 2 Modelli commerciali

CPA (Cost per Action) - Fisso per l'azione confermata.
RevShare:% dei margini/ricavi; è importante fissare la base di calcolo e la finestra di assegnazione.
Hybrid: CPA + RevShare.
MDF/Co-op - Fondo di marketing congiunto per il raggiungimento di KPI.
Minimo Guarantees: pagamento minimo/quota.

Riserve chiave: anti-frod, target-clause (geo/canali), periodo di «rivendicazione», diritto di verifica, limiti di responsabilità.

4) Contratti di dati e attribuzione

4. 1 Attributo

Finestra (ad esempio, '7/30' giorni), modelli (last-click, data-driven), priorità canali, postback server.
Sorgenti: UTM/ref, eventi c2s, webhoop firmati, dedupe per «event _ id».
Condizioni: qualified, abbreviazione, cancellazione/rifand, periodo «cool-off».

4. 2 Contratto di dati

Schemi (JSON Schema/Avro), campi obbligatori/PII, base legale, TTL/retenschen, diritti del soggetto (rimuovi/correggi), localizzazione (regione).
SLA integrativo: numero di eventi consegnati per X minuti, ordine/idemotia, finestre di ripetizione.

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) Modelli di integrazione

REST/gRPC per lo scambio online (quote/limitatori, regole retry, idempotenza).
Webhooks/Avvening - Eventi firmati, ripetizione con ritardo esponenziale, code ritardate per i partner «lenti».
Batch/SFTP/Blob - Report, insiemi, ripartizione.
SDK/Embeds - Attrito minimo di connettività, criteri di versione, feature-flags.
Outbox/Inbox - consegna garantita, deducibilità, controllo.
API Consent/Privacy - Esprime i consensi/opt-out attraverso la catena.

6) SLA a cascata/OLA e escalation

SLA esterno: disponibilità, p99, percentuale di eventi nella finestra, accuratezza di attribuzione.
OLA interno: operazioni PRM, convalida, risposta allo zapport, chiusura dei ticket.
A cascata: violazione esterna dei trigger di azione interna, crediti/multe (contratto), stato in PRM.
Escalation: L1 partner, piattaforma L2, L3 venditore infrastruttura; finestre di risposta fisse.

7) PRM: modello operativo e processi

1. Sorcing/Screening: il questionario, il CUS/sanzioni, la reputazione, le opportunità.

2. Onboarding: contratti, chiavi/API, cassetta di sabbia, scontrini di integrazione, valigette di prova.

3. Enablement: formazione, libreria di templati creativi/UTM, gite di contenuti/brand.

4. Run: rapporti, MDF, OKR congiunti, SLA states, alert.

5. Review & Growth: QBR (quarterly business review), co-roadmap, cross-sell.

6. Exit/Change: annullamento, estrazione dei dati, ritiro delle chiavi, post mortem.

Manufatti PRM: passaporto partner, matrice di autorizzazioni, registro dei consensi, registro dei rischi, playbooks, appunti API, stato di compatibilità delle versioni.

8) Verticale: caratteristiche e invarianti

Marketing/Affiliati: lotta contro il frodo (bot, cookie-stuffing), rigorosa attribuzione, contenuti e sicurezza di marca.
Pagamenti/Fintech: sovranità dei dati, 3-D Secure/CD-requisiti simili, KMS/crittografia, feedback dei rischi.
CUS/Antifrode: PDA sensibili, DPA, TTL, diritti del soggetto, qualità del matching.
Contenuti/Media: licenza, DRM/filigrana, metadati, report di utilizzo.
Supporto VRO/Rivenditori: script L1/L2, script, corsi di formazione, controllo qualità.

Invarianti comuni: crittografia, crittografia, controllo, idemoticità degli eventi, finestre di calcolo e assegnazione chiare.

9) Gestione dei conflitti di canale

Regole di priorità: chi «possiede» il cliente durante l'intersezione (registrazione primaria, attività, assegno).
Protezione/Exclusivity: esclusiva per geo/segmento/campagna - con KPI e scadenza.
Last-touch vs data-driven - Fissare il modello e modificarlo.
Arbitraggio: processo di analisi, finestre di rivendicazione, base di prova (logici, firme, trace-ID).

10) Rischi e controllo

Legali/marchi: creativi proibiti, inadempienza al diritto/pubblicità locale.
Finanziaria: attribuzione errata, ottimizzazione «grigia» sotto CPA, rischio di aggregazione.
Tecnica: perdita di chiavi/PII, mancanza di webhoop, deriva di schemi.
Sala operatoria: dipendenza da un socio importante, scatole nere in bolletta.

Controlli: politica come codice (OPA/Kyverno), segreto-scan, limitatori, honey-tokens, «doppio» calcolo (vostro e partner) + assembling.

11) Metriche e KPI

Fonte di domanda: CAC, LTV/CAC, ARPU/ARPPU, CR, churn by partner.
Qualità dell'assegnazione: quota di «qualified», quota di deduplo, discrepanza di report.
Operativi: tempo di onboarding, quota di partner con chiavi/versioni SDK aggiornate, SLO di consegna eventi.
Rischio/compagine:% dei partner con DPA attivo, SLA pass-rate, incidenti/milioni di eventi.
Crescita: la quota di fatturato da nuove verticali, cross-sell, il numero di integrazioni attive.

12) Modelli e esempi

12. 1 Passaporto partner (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 Criterio PRM-gate (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 Recordation (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-pattern

«Prima firmiamo e poi creiamo l'integrazione».
L'attribuzione è solo per cookie e senza segnali di server.
Segreti e webhoot senza la firma/anti-replay di fuoriuscita e cambio.
Il 50% del traffico è a rischio concentrazione.
L'assenza di riconducibilità e di verifiche consente di calcolare i calcoli in modo cronico.
SLA/OLA incoerenti → «zone grigie» di responsabilità.
Ignora i vincoli locali di contenuto/pubblicità bloccati/multe.

14) Assegno-foglio architetto

1. Una mappa di valore e frecce dati/denaro costruita su ogni verticale?
2. Ogni partner ha un passaporto: contratti, schemi, SLO, chiavi, regioni, proprietari?
3. La finestra, il modello, i postback server, il deadup e la riparazione sono definiti?
4. Integrazioni: firma, retrai, idemotia, limitatori - implementati?
5. Regole come codice DPA/SLA/firme/retenschen gate in CI/CD?
6. Processi PRM: onboarding, formazione, QBR, MDF, exit plan - descritto e eseguito?
7. SLA/OLA a cascata e scalate - sono stati registrati e testati?
8. Metriche: CAC/LTV/CVR/DSL di spedizione?
9. Rischio-controllo: anti-frode, limiti di concentrazione, honey-tokens, piano di revisione delle chiavi?
10. La versioning di API/SDK/eventi e la finestra di compatibilità sono nel calendario di rilascio?

Conclusione

Le catene di partnership sono l'architettura delle relazioni, dei dati e degli incentivi. Quando si dispone di una mappa del valore, contratti formali dei dati, attribuzioni trasparenti, SLA a cascata e integrazioni gestite, l'ecosistema diventa prevedibile: i partner vedono i vantaggi, gli utenti la qualità e la piattaforma la crescita sostenibile. Costruite PRM come prodotto, automatizzate le regole e misurate gli effetti e la rete sarà scalabile senza caos.