Correntes parceiras e verticais

1) Termos e papéis

Vertical - segmento setorial e/ou cadeia de valor (por exemplo: Fintech/Pagamentos, Marketing/Afiliados, Conteúdo/Provedores, Identificação/CUS, Antifrod, Logística/Fulfilment, Suporte BPO).

• Referral/Infuencer/Affiliate - Conduz tráfego/lidas (CPA/RevShare).
• Reseller/Distribuidor - vendem e atendem nos mercados locais.
• OEM/Embedded/White-label - Incorporando funcionalidade, lançando com sua marca.
• Tecnologia/ISV/SI - Complementa o produto com módulos e integrações.
• Data/Compliance - KYC/AML/compilação/pagamentos/antifrode.
• Conteúdo/Media/Streaming - licenças, conteúdo-fido, ativos promocionais.

2) Mapa de valor e cadeia de parceiros

Primeiro, mapeamos o fluxo de valor, da fonte de demanda → para o produto → à monetização e serviços pós-cofre.

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]

Para cada seta, definimos o contrato de dados, métricas (SLI/SLO), acessíveis e segredos, regras de privacidade, modelo comercial.

3) Modelos de cooperação e comércio

3. 1 Formatos de cooperação

Referral/Affiliate: Reflorestamento, pós-base, cookies/atribuição de servidor.
Reseller/Distribuidor: quotas, preços, conformidade local, L1/L2 suporte.
OEM/Embedded/White-label: pacotes SDK, white-label UI, release trem e API compatível.
Marketplace/App Store: catálogo de integrações, billing via plataforma, revezamento e segurança.

3. 2 Modelos comerciais

CPA (Cost per Action): fixe por efeito confirmado.
RevShare:% da margem/receita; é importante fixar a base de cálculo e a janela de atribuição.
Hybrid: CPA + RevShare.
MDF/Co-op: um fundo de marketing conjunto para alcançar o KPI.
Mínimo Guarantees: pagamento mínimo/quota.

As principais reservas são: anti-frod, meta-klauss (geo/canais), período de «reclamação», direito de auditoria, limites de responsabilidade.

4) Contratos de dados e atribuição

4. 1 Atribuição

Janela (por exemplo, «7/30» dias), modelos (last-click, data-driven), prioridade de canais, pós-back de servidor.
Fontes: UTM/parâmetros ref, eventos c2s, webhooks assinados, dedupe por 'event _ id'.
Condições: status «qualificed», deadup, cancelamento/refand, período «cool-off».

4. 2 Contrato de dados

Esquemas (JSON Schema/Avro), campos obrigatórios/PII, base legal, TTL/retensivo, direitos do sujeito (remover/corrigir), localização (região).
SLA de integração: proporção de eventos entregues ≤ X minutos, ordem/idempotidade, janelas de repetição.

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) Pattern de integração

REST/gRPC para compartilhamento online (quotas/limitadores, políticas retry, idempotidade).
Webhooks/Eventing - eventos assinados, repetição com atraso exponencial, filas atrasadas para parceiros «lentos».
Batch/SFTP/Blob - relatórios, cópias, reconciação.
SDK/Embeds - fricção mínima de conexão, políticas de versão, função-flags.
Outbox/Inbox - entrega garantida, dedução, auditoria.
Consent/Private API - encorajamento de concordâncias/opt-out na cadeia.

6) SLA em cascata/OLA e escaladas

SLA externa: disponibilidade, p99, proporção de eventos na janela, precisão de atribuição.
OLA interna: operações PRM, verificação, resposta de safort, encerramento de tíquetes.
Cascadura: violação externa → desencadeadores de ação interna, créditos/multas (contrato), status no PRM.
Escaling: L1 parceiro, plataforma L2, L3 vendedor de infraestrutura; janelas de resposta fixas.

7) PRM: modelo operacional e processos

1. Surcing/Screening: questionário, CUS/sanções, reputação, possibilidades.

2. Onboarding: contratos, chaves/API, caixa de areia, cheques de integração, malas de teste.

3. Enablement: treinamento, biblioteca de templos criativos/UTM, guias de conteúdo/marca.

4. Run: relatórios, MDF, OKR conjunto, estatais SLA, alertas.

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

6. Exit/Mudança: Desfazer, retirar dados, rever chaves, pós-mortem.

Artefatos PRM: passaporte do parceiro, matriz de permissões, registro de concordâncias, registro de risco, playbooks, caixas de API, status de compatibilidade de versões.

8) Vertical: características e invariantes

Marketing/Afiliados: luta contra o frod (bots, cookies-stuffing), atribuição rigorosa, conteúdo e segurança de marca.
Pagamentos/Fintech: soberania de dados, 3-D Secure/PSD tais requisitos, KMS/criptografia, feedback de risco.
CUS/antifrod: PD sensível, DPA, TTL, direitos do sujeito, qualidade do jogo.
Conteúdo/Mídia: licenciamento, DRM/marca de água, metadados, relatórios de uso.
Suporte VRO/Revendedores: cenários L1/L2, script, cursos de formação, controle de qualidade.

Invariantes gerais: PoLP, criptografia, auditoria, idempotidade de eventos, janelas claras de atribuição e cálculo.

9) Gerenciamento de conflitos de canais

As regras de prioridade são: quem «possui» o cliente ao cruzar (registro inicial, atividade, cheque).
Proteção/Exclusivity: exclusivo por geo/segmento/campanha - com KPI e prazo.
«Last-touch vs data-driven»: fixar o modelo e revisitá-lo.
Arbitragem: processo de análise, janelas de reclamação, base de provas (logs, assinaturas, trace-ID).

10) Riscos e controle

Legais/marcas: criações proibidas, não conformidade com o direito/publicidade local.
Financeiro: atribuição errada, otimização «cinzenta» sob CPA, risco vageback.
Técnico: fuga de chaves/PII, falta de webhooks, à deriva dos circuitos.
Operação: Dependência de um parceiro importante, caixas pretas no cálculo.

Controladores: política como código (OPA/Kyverno), segredo scan, limitadores, honey-tokens, «duplo» cálculo (seu e parceiro) + recordação.

11) Métricas e KPI

Fonte de demanda: CAC, LTV/CAC, ARPU/ARPU, CR, churn by parceiro.
Qualidade de atribuição: proporção de «qualificed», proporção de dados, discrepância de relatórios.
Operacionais: tempo de operação, proporção de parceiros com chaves/versões atuais SDK, SLO de entrega de eventos.
Risco/Complacência:% dos parceiros com DPA atuante, SLA pass-rate, incidentes/milhões de eventos.
Crescimento: proporção de receita de novas verticais, cruzada-selo, número de integrações ativas.

12) Modelos e exemplos

12. 1 Passaporte de sócio (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 Política 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 Reconciação (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

«Primeiro assinamos, a integração é mais tarde», → os sócios mortos e as dívidas.
Atribuição por cookies e sem sinais de servidor → disputas e fraudes.
Segredos e webhooks sem assinatura/anti-replay → vazamentos e trocas.
Um «super parceiro»> 50% do tráfego → risco de concentração.
A falta de recepção e auditoria → diferenças crônicas de cálculo.
SLA/OLA discordantes → «zonas cinzentas» de responsabilidade.
Ignorar restrições locais de conteúdo/publicidade → bloqueios/multas.

14) Folha de cheque do arquiteto

1. Um mapa de valor e seta de dados/dinheiro construído em cada vertical?
2. Cada sócio tem passaporte, contratos, esquemas, SLO, chaves, regiões, proprietário?
3. Atribuição: janela, modelo, pós-back de servidor, dedução e reconciação - definidos?
4. Integração: assinatura, retraí, idempotidade, limitadores - implementados?
5. Políticas como código: DPA/SLA/assinaturas/retenss - gates em CI/CD?
6. Processos PRM: internet, treinamento, QBR, MDF, exit plug - descrito e executado?
7. SLA/OLA em cascata e escalas - registadas e testadas?
8. Métricas: CAC/LTV/CVR/Contábeis, SLO de entrega em dashboards?
9. Controle de risco, anti-frod, limites de concentração, honey-tocens, plano de reavaliação de chaves?
10. Versioning API/SDK/Eventos e «janela de compatibilidade» - no calendário de lançamentos?

Conclusão

As cadeias parceiras são a arquitetura das relações, dados e incentivos. Quando você tem um mapa de valor, contratos formais de dados, atribuições transparentes, SLA em cascata e integrações gerenciáveis, o ecossistema torna-se previsível: os parceiros veem benefícios, os usuários têm qualidade e a plataforma tem um crescimento sustentável. Construa o PRM como um produto, automatize a política e mede os efeitos - e a sua rede será escalada sem caos.