推荐链接体系结构

1）为什么生态系统的推荐链接

• 归属和付款的可预测性；
• 追逐和扩展合作伙伴的速度；
• 安全/隐私（PII最小化，RG-guardrails）；
• 经济学（诚实分裂，成本服务，ROI频道）。

2）推荐链接模型

2.1深度

单级（L1）：目标事件（FTD/任务存款/激活）的主要推荐人奖励。
多级（L2+）：分期付款在推荐树上消失；适用级别/上限/委员会限制。
杂种：L1 fix+L2上的小"细尾巴"。

2.2通过影响载体

附属机构/媒体（网络，公共场所，彩带）。
User-to-User（玩家推荐代码/链接）。
合作品牌/B2B（合作伙伴品牌/运营商，跨链过渡）。

2.3通过交换拓扑

Hub&Spoke：一个归属和后备中心-更简单的构想。
Mesh（联邦）：链条之间的直接联系-需要严格的事件和签名规范。
层到层：媒体→ offer → 付款/KUS →游戏（清晰的域和网关）。

3）本体和ID

3.1个关键实体

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

3.2连通性和隐私性

PII存储在保险箱区域中，仅交换令牌/别名。
点击链接到事件："traceId"从点击/链接到注册/存款/游戏。
用于反射码令牌的TTL/expiry；防止设备敷设。

4）事件模型和数据合同

4.1最小事件集

`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事件要求

模式的语义版本（Schema Registry），必填字段和有效值。
通过"eventId"+重复数据消除窗口（± 5分钟）实现相容性。
时区是带有"货币"的UTC/ISO-8601，所有金额和货币。

5）协议： 链接,复印机,SmartLink,后备箱

5.1 ref-links生成

参数：'rid'（参考）、'cid'（活动）、'oid' （offer）、'sub1.. sub5'、'utm_'、'traceId'。
参数签名（JWS/HMAC），TTL，替代保护（"kid"，"timestamp"）。

5.2 SmartLink/Deep Link

SmartLink 通过地理/管辖权/设备/SLO支付路由状态重定向。
Deep Link导致特定的游戏/登陆/任务（通过区域/许可证检查可用性）。

5.3 Postbecks （S2S）

签名的webhooks："signature"，"eventId"，"timestamp"，"rid/cid/oid"，"traceId"。
带有抖动和回音的Retrai；重播名册；故事的游标上载。

6）归属和冲突

6.1归属规则

Last eligible touch带有跨辖区和渠道的窗口。
通过一致的令牌/fingerprint（不含原始PII）进行交叉迭代。
在多步路线中-贡献权重（请参见下面的拆分）。

6.2冲突解决

如果L1窗口处于活动状态,则用户直接推荐优先于媒体点击。
Frod/nevalid：标记"disputed"，在重新分配之前付款。

7）反亲和转介流量质量

信号：设备农场，非自然的CTR/CR，快速点击/注册周期，地理/ASN错位，品牌混合，以内容为幌子的刺激流量。
行动：自动冷却，链接/离线暂停，键召回，blacklist站点，重新验证参考。
Scorecard质量：LTV/FTD,保留,chargeback/bonus-abuse,精度/及时的后卫。

8）付款计算和拆分

8.1基本模型

CPA/CPL（事件小说，例如FTD/注册）。
RevShare（Net Revenue在窗口中的份额）。
混合体（fix+股权）。
多层拆分（L1/L2..。带帽子/门槛）。

8.2个公式（简化）

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

其中（W_i）为台阶重量（L1> L2……或根据通道贡献模型），（Q_i）是质量系数（交付的SLI，后备精度，缺少带状/RG标志）。

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

"Adjustments"：SLO的贷款/处罚，有争议案件的保留，RG/制裁调整。

8.3限制和帽子

季度/月限额；最低付款；在有争议的事件中大放异彩；根据管辖权和支付状况削减。

9）安全、隐私和RG

零信托：mTLS用于S2S，短寿命令牌，egress-allow-list。
PII最小化：在ref流量中-仅令牌/别名；严格在安全区进行检测。
RG-guardrails：脆弱部分的强度限制；强制性软盘；禁止在禁止区域发生离岸外包。
DPA/DPIA和本地化：根据管辖区进行存储和处理，禁止跨境出口非规则的PDn。

10）Dashbords和可观察性

10.1推荐小组/附属机构

集团、注册、KYC、FTD、存款、CR/ARPU/LTV、后备状态、拆分和预期付款、上限/配额。

10.2生态系统面板

链接图（referrer→referal），队列，争议份额，RG/制裁犯规，MTTR事件，频道/链条贡献。

10.3 SLO

后卫交付≥ 99。9％（p95 ≤ 1-2 c），lag轮胎≤ 200-500 ms，p95面板渲染≤ 1。5–2.0秒,跟踪覆盖率≥ 95%的路径。

11) Governance и RACI

12）操作流程

12.1 Onbording推荐人

KYP/KYB，交通来源，司法管辖区，品牌海德，RG协议。
发出密钥/API/webhook；沙盒和匹配签名/等效性测试。

12.2更改/版本

更改日历（绿色/黄色/红色窗口），渐进式启用（1%→5%→25%→100％），guardrails和自动滚动。

12.3事件/战争室

P1/P2，停止按钮（交通/离境/路线），SLA到60-90 s Trace Pack，RCA"没有找到罪魁祸首"。

12.4恢复和付款

游标卸载，哈希事件对账，行为/发票，NET7/14/30，保留（frod/Charjback/Bonus Abuse），FX课程。

13）与生态系统其他层的整合

付款/抗逆转录病毒药品：CR/P95退化的配额和切断。
KYC/AML：通过率和SLA阶段；用于低风险的快速跟踪。
内容/任务：带有RTP/波动性和区域限制检查的游戏/锦标赛的双打。
分析/ML：propensity模型，offers排名，antifrod信号。

14）反模式

"后卫动物园"：不同的格式/签名/窗口→双打，损失，争议。
载荷下事件历史的错位分区→孔/复制件（仅游标）。
没有抖动/限制的撤退→风暴和双重权责发生。
Ref事件中的PII →泄漏和违规行为。
无限制的多层尾巴→有毒的经济，无法控制。
没有N+1/health-flip的单个SPOF-redirect。
Neto traceId →归因无法证明。

15）支票单

15.1设计

• 本体和Schema Registry（必填字段版本）。
• 后备和签名合同（JWS/HMAC）,重复数据消除窗口。
• SmartLink/Deep Link发电机、TTL和参数保护。
• 归属：规则，窗口，冲突优先级，跨字节统计。
• 付款和拆分模式、上限/限制、保留。
• 零信托，令牌化，DPIA/DPA，RG-guardrails。
• Dashbords/scorecards和SLO，Alerts和战争室。

15.2启动

• 沙箱/构想，测试事件和钻孔。
• 渐进式发布，自动滚动。
• 配置重新定位和发票管道。

15.3运营

• 每周质量分数和SLO。
• 有争议/持有案件的咆哮。
• 定期RCA和规则更新。

16）成熟度路线图

v1（基金会）：单项活动/后卫佳能，SmartLink，L1模型，基本行车记录仪。
v2（集成）：跨链反射、光标复制、溷合支付、分级和自动冷却。
v3（自动化）：offers的ML排名，预测性超额支付/KUS，SLI/RG上的自动护栏。
v4（网络）：网络之间的联合归属，集体任务/锦标赛，分裂的DAO规则。

17）成功指标

业务：来自裁判频道的uplift FTD/ARPU/LTV，SAS/ROI，质量来源的比例。
质量：后卫的准确性/及时性，争议性<X％，丘陵/charjbacks。

技术人员： p95 redector and backback, lag轮胎,MTTR事件.

合规性/RG：PDn=0事件，司法管辖区合规性，RG 触发器/1k活动。
经济学：服务成本（per rps/txn/event），贷款/处罚，渠道的ROI。

简短的摘要

推荐链接体系结构是标识符和事件标准，SmartLink/diplink和签名的后备箱，诚实的归属，严格的隐私和RG，以及透明的拆分经济和可观察性。通过构建规范和SLO，自动化护卫和重新设计-推荐电路将成为整个生态系统的可扩展，安全和有利可图的基础。