Arquitectura de enlaces de referencia

1) ¿Por qué un ecosistema de enlaces de referencia

• previsibilidad de la atribución y los pagos;
• Velocidad de onboarding y zoom de socios;
• seguridad/privacidad (PII-minimización, RG-guardrails);
• economía (split honesto, Costo-a-Serve, canales ROI).

2) Modelos de enlaces de referencia

2. 1 En profundidad

Nivel único (L1): recompensa de referencia primaria por evento objetivo (FTD/depósito/activación de misión).
Multinivel (L2 +): las cuotas de pago suben en el árbol de referencias; se aplica un límite de nivel/caps/comisiones.
Híbrido: L1 fix + una pequeña «cola delgada» por L2.

2. 2 Por portador de efectos

Afiliado/medios (redes, publishers, streamers).
User-to-User (códigos de referencia/links de los jugadores).
Co-marca/B2B (marcas de afiliados/operadores, transiciones de cadena cruzada).

2. 3 Por topología de intercambio

Hub & Spoke: un único centro de atribución y postback: más fácil de conformar.
Mesh (federación): conexiones directas entre cadenas - requiere una estricta canónica de eventos y firmas.
Layer-to-Layer: medios → offer → pagos/CUS → juego (dominios claros y pasarelas).

3) Ontología e identificadores

3. 1 Entidades clave

`referrerId`, `referralId`, `playerId` (псевдоним), `affiliateId`, `campaignId`, `offerId`, `routeId`, `operatorId`, `providerId`, `traceId`.

3. 2 Conectividad y privacidad

El PII se almacena en las zonas seguras, en el intercambio, sólo los tokens/alias.
La conexión del clic con el evento: 'traceId' se extiende desde el clic/link hasta el registro/depósito/juego.
TTL/expiry para tokens de refcode; protección contra sobreacoplamiento de dispositivos.

4) Modelo de eventos y contratos de datos

4. 1 Conjunto mínimo de eventos

`ref_click`, `deep_link_open`, `session_start`, `registration`, `kyc_status`, `deposit`, `ftd`, `bet/spin`, `mission_progress`, `reward_granted`, `ref_postback_received`, `fraud_signal`.

4. 2 Requisitos de eventos

Versiones semánticas de esquemas (Schema Registry), campos obligatorios y valores válidos.
Idempotencia a través del 'eventId' + ventana de deduplicación (± 5 min).
Zonas horarias - UTC/ISO-8601, todas las cantidades y monedas con 'currency'.

5) Protocolos: referencias, diplomas, SmartLink, postbeki

5. 1 Generación de enlaces de referencia

Parámetros: 'rid' (referer), 'cid' (campaña), 'oid' (offer), 'sub1.. sub5', 'utm _', 'traceId'.
Firma de parámetros (JWS/HMAC), TTL, protección de sustitución ('kid', 'timestamp').

5. 2 SmartLink/Deep Link

SmartLink redirige por geo/jurisdicción/dispositivo/estado SLO de las rutas de pago.
Deep Link lleva a un juego/landing/misión específica (verificación de disponibilidad por región/licencia).

5. 3 Postbeki (S2S)

Webhooks firmados: 'signature', 'eventId', 'timestamp', 'rid/cid/oid', 'traceId'.
Retrés con jitter y backoff; registro para reprogramar; descarga por cursor del historial.

6) Atribución y conflictos

6. 1 Reglas de atribución

Last elegible touch con ventanas por jurisdicciones y canales.
Estitching de dispositivos cruzados a través de tokens/huellas dactilares convenidos (sin PII crudo).
Con rutas de varias etapas - el peso de las contribuciones (ver los divididos a continuación).

6. 2 Resolución de conflictos

Prioridad de la referencia directa del usuario sobre el clic multimedia si la ventana L1 está activa.
Frod/nevalid: las marcas «disputed», la colina de los pagos a la reconciliation.

7) Anticongelante y calidad del tráfico de referencia

Señales: device farm, CTR/CR no naturales, ciclos rápidos de clics/registros, no coincidencia geo/ASN, brand-bidding, tráfico estimulante bajo la apariencia de contenido.
Acciones: auto-refrigeración, pausa de link/offer, revocación de llaves, sitios blacklist, re-verificación de referencias.
Calidad Scorecard: LTV/FTD, retención, chargeback/bonus-abuse, precisión/puntualidad postback.

8) Liquidación de pagos y splits

8. 1 Modelos básicos

CPA/CPL (fix por evento, por ejemplo, FTD/registro).
RevShare (participación de Net Revenue por ventana).
Híbrido (fix + share).
División de niveles (L1/L2... con gotas/umbrales).

8. 2 Fórmulas (simplificado)

[
share_i=\frac{W_i \cdot Q_i}{\sum_j W_j \cdot Q_j}
]

donde (W_i) es el peso del paso (L1> L2... o según el modelo de contribución del canal), (Q_i) - coeficiente de calidad (SLI de la entrega, precisión de los postbacks, ningún frod/banderas RG).

[
payout_i = share_i \times (Base\ Reward \ \text{или} \ Net\ Revenue \times rate) \times Adjustments
]

'Adjustments': créditos/sanciones para SLO, retenciones para casos controvertidos, ajustes de RG/sanciones.

8. 3 Restricciones y Caps

Límites trimestrales/mensuales; El pago mínimo; una colina en el rugido de acontecimientos controvertidos; las secciones por jurisdicción y estado de pago.

9) Seguridad, privacidad y RG

Zero Trust: mTLS para S2S, tokens de vida corta, egress-allow-list.
Minimización PII: en el tráfico de ref - sólo tokens/alias; desintoxicación estrictamente en áreas de seguridad.
RG-guardrails: restricciones de intensidad por segmentos vulnerables; discleimers obligatorios; Prohibición de los offs en las regiones prohibidas.
DPA/DPIA y localización: almacenamiento y procesamiento por jurisdicciones, prohibición de la exportación transfronteriza de PDn fuera de las regulaciones.

10) Dashboards y observabilidad

10. 1 Panel de referencias/afiliados

Clics, registros, KYC, FTD, depósitos, CR/ARPU/LTV, estados postback, divididos y pagos esperados, caps/cuotas.

10. 2 Panel del ecosistema

Mapa de enlaces (referrer→referal), cohortes, proporción de disputados, faltas de RG/sanción, MTTR sobre incidentes, contribución de canales/cadenas.

10. 3 SLO

Entrega de postbacks ≥ 99. 9% (p95 ≤ 1-2 s), lag bus ≤ 200-500 ms, render paneles p95 ≤ 1. 5–2. 0 s, cobertura de trazado ≥ 95% de las vías.

11) Governance и RACI

12) Procesos operativos

12. 1 Referer Onboarding

KYP/KYB, fuentes de tráfico, jurisdicciones, marca-hyde, acuerdo RG.
Emisión de claves/API/webhooks; sandbox y pruebas de conformación de firmas/idempotencia.

12. 2 Cambios/lanzamientos

Cambie-calendar (ventanas verdes/amarillas/rojas), inclusiones progresivas (1%→5%→25%→100%), guardrails y auto-rollback.

12. 3 Incidentes/sala de guerra

P1/P2, botones de parada (tráfico/offer/ruta), SLA en el paquete de viaje 60-90 s, RCA «sin buscar culpables».

12. 4 Reconciliation y pagos

Descargas por cursor, conciliación de eventos hash, actos/facturas, NET7/14/30, retenciones (frod/charjbeki/bonus abuse), cursos FX.

13) Integración con el resto de capas del ecosistema

Pagos/ARM: cupos y cut-over en la degradación de CR/P95.
KYC/AML: pass-rate y etapas SLA; fast-track para los de bajo riesgo.
Contenido/misiones: diplomas para juegos/torneos con verificación de RTP/volatilidad y restricciones regionales.
Análisis/ML: propensity-models, clasificación de offers, señales antifraude.

14) Anti-patrones

«Zoológico postback»: diferentes formatos/firmas/ventanas → tomas, pérdidas, disputas.
Paginación offset del historial de eventos bajo carga → agujeros/duplicados (sólo cursores).
Retiros sin jitter/límites → tormenta y doble devengo.
PII en eventos de ref → fugas y violaciones.
Colas multinivel ilimitadas → economía tóxica, imposibilidad de control.
Redireccionamiento único SPOF sin N + 1/flip-health.
Net traceId → atribución no se puede probar.

15) Hojas de cheques

15. 1 Diseño

• Ontología y Registro de Schema (versiones, campos obligatorios).
• Contratos de postback y firma (JWS/HMAC), ventana de deduplicación.
• SmartLink/Deep Link generador, TTL y protección de parámetros.
• Atribución: regla, ventanas, prioridades de colisiones, estitcheo de dispositivos cruzados.
• Modelos de pagos y splits, caps/límites, retenciones.
• Confianza cero, tokenización, DPIA/DPA, RG-guardrails.
• Dashboards/scorecards y SLO, alertas y sala de guerra.

15. 2 Inicio

• Caja de arena/conformación, eventos de prueba y conciliación.
• Lanzamiento progresivo, auto-rollback.
• Reconciliation y factura-pipeline personalizados.

15. 3 Explotación

• Scorecards semanales de calidad y SLO.
• Revuelo de casos controvertidos/hold.
• RCA periódicas y actualización de las normas.

16) Hoja de ruta de la madurez

v1 (Fundación): canónigo único de eventos/postback, SmartLink, modelo L1, dashboards básicos.
v2 (Integración): reflujo de cadena cruzada, réplicas de cursor, pagos híbridos, scorecards y refrigeración automática.
v3 (Automatización): clasificación ML de offers, pagos predecibles cut-over/CUS, auto-guardrails por SLI/RG.
v4 (Networked): atribución federada entre redes, misiones/torneos colectivos, reglas DAO de splits.

17) Métricas de éxito

Negocios: uplift FTD/ARPU/LTV de los canales de reflujo, SAS/rentabilidad, una fracción de fuentes de calidad.
Calidad: exactitud/puntualidad de los postbacks, controversia <X%, colinas/charjbeki.
Técnica: p95 redirecciones y postbacks, llantas lag, MTTR para incidentes.
Cumplimiento/RG: incidentes PDn = 0, cumplimiento de jurisdicciones, desencadenantes RG/1k activos.
Economía: Costo-a-Serve (per rps/txn/event), créditos/penaltis, canales ROI.

Resumen breve

La arquitectura de enlaces de referencia son estándares de identificación y eventos, SmartLink/Diplins y postbeki firmados, atribución honesta, privacidad estricta y RG, además de una economía de división transparente y observabilidad. Construye canónigos y SLO, automatiza guardrails y reconciliation, y el circuito de referencia se convertirá en la base escalable, segura y rentable de todo el ecosistema.