Communitygithub.com

cameronalexander720/海外广告归因链接技能

用于设计和排查海外广告归因链接、深度链接、落地页、SDK 时序、PushAPI 回调、安装引荐来源流程、广告参数映射以及安装后路由问题的智能体技能。

海外广告归因链接技能 是什么?

该技能专注于海外广告归因链接的技术方案设计与问题排查。它帮助 AI 智能体识别用户意图(技术方案设计或问答排查),并引导智能体加载特定的参考文档(技术方案模板、归因知识、QA 手册)以提供准确回复。在方案设计模式下,技能提供了从场景确认、商业目标识别到验证清单的 8 步结构化工作流,覆盖深度链接、落地页、SDK 归因、PushAPI、Google Install Referrer 等常见链路。在问答模式下,技能指导智能体按阶段(点击、安装、首次打开、SDK 回调等)定位问题,结合归因知识中的来源优先级和时序规则进行分析,并给出包含日志、字段、请求时序、用户状态、广告层级字段和报表开关的验证清单。该技能还内置了专业领域护栏,例如区分归因完成与安装后路由成功,区分归因前和归因后行为,以及强调 Google Install Referrer 仅用于首次打开等关键原则。此外,技能包含敏感上下文护栏,要求智能体在生成可重用指导时去除公司、项目、时间、人员、文件路径、令牌、URL 等具体信息,仅保留必要的公开媒体平台名称。适用于 Claude Code、Cursor、Codex 等 AI 编码智能体,帮助开发者高效处理海外广告归因链路的设计与调试工作。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add cameronalexander720/overseas-ad-attribution-link-skill

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

海外广告归因链接技能 是做什么的?

操作模式

使用该技能生成两种输出类型:

  1. 技术方案设计,用于海外广告归因链接能力。
  2. 问答与排查,用于归因、参数、SDK 时序、PushAPI、落地页、深度链接、事件回调、报表控制以及安装后路由行为。

首先识别模式。当用户请求技术方案、集成计划、产品/技术评审、功能设计或架构时,使用方案设计模式。当用户询问链路为何表现异常、如何判断来源、参数从何而来、链路阶段如何工作,或如何排查指标/行为症状时,使用问答模式。

必需参考文档加载

仅加载请求所需的参考文档:

  • 对于技术方案或功能架构:读取 references/technical-solution-template.md。
  • 对于归因规则、数据源优先级、接口时序、参数映射或事件回调:读取 references/attribution-knowledge.md。
  • 对于使用问题、诊断或解释:读取 references/qa-playbook.md。

除非用户明确为当前任务提供客户特定的源文档,否则不加载或引用这些文档。

方案设计工作流

在起草海外广告归因链接方案时:

  1. 明确场景:深度链接、落地页、SDK 归因、PushAPI、Google Install Referrer 或混合链路。
  2. 识别业务目标:归因完成、广告层级回填、事件回调、安装后路由到推广内容、模型学习信号、报表控制或指标核对。
  3. 定义参与方与模块:媒体平台、广告链接生成器、落地页智能脚本、应用客户端、SDK/MMP、后端归因服务、报表服务、管理配置和数据仓库。
  4. 指定数据来源及优先级。记录每个来源的时序、可靠性、匹配键、回退行为及允许用途。
  5. 指定客户端时序:冷启动、首次安装打开、隐私同意、SDK 回调时序、回退超时、短轮询、热启动以及会话级限制。
  6. 指定后端行为:匹配、去重、传播映射、广告层级回填、事件资格判定及回调路由。
  7. 指定用户侧行为:自动路由、路由提示、用户正在消费内容时抑制路由,或延迟直到归因结果到达。
  8. 指定验证:按来源/渠道的测试用例、参数示例、预期日志、事件回调、指标检查、灰度发布及回滚开关。

使用 references/technical-solution-template.md 作为结构。对于范围较窄的请求,删除不相关的部分。

问答工作流

在回答使用问题时:

  1. 重述观察到的症状或决策点。
  2. 命名相关的链路阶段:广告点击、落地页、安装、首次打开、SDK 回调、归因前、归因后、广告信息请求、事件回调或分析核对。
  3. 将其映射到 references/attribution-knowledge.md 中的已知规则。
  4. 结合来源优先级和时序解释可能的原因,特别是当 PushAPI、Google Install Referrer 或 SDK 数据到达较晚时。
  5. 给出验证清单:日志、字段、请求时序、用户状态、传播/广告层级字段、事件资格及报表开关。
  6. 将已确认的事实与假设分开。如果当前项目有自己的规则,在覆盖通用模式前要求用户提供相关规则或文档摘录。

领域护栏

  • 区分归因完成与安装后路由/播放成功;用户可能已被归因但未路由到推广内容。
  • 区分归因前和归因后。归因前影响即时应用行为;归因后可以稍后完成归因,但可能需要轮询或路由补偿。
  • 将 Google Install Referrer 视为面向首次安装打开。不要假设它会在每次新广告点击后更新。
  • 除非用户声明了项目特定规则,否则优先使用明确的来源优先级规则而非“最新字段获胜”。
  • 在讨论事件回调时,分开讨论媒体事件映射、资格规则、去重和报表开关。
  • 当出现指标问题时,在断定归因逻辑错误之前,先检查归因时序和用户应用体验。

敏感上下文护栏

  • 在生成的可重用指导中,不得包含公司名称、项目名称、文档名称、历史日期、人员姓名、本地文件路径、令牌、URL、包名、广告活动名称或原始日志示例。
  • 公开的媒体/平台名称(如 Facebook、TikTok、Snapchat、Google)可在与方案设计或排查相关时保留。
  • 内部公司名称、项目名称、文档标题、广告活动名称、包名和原始账户标识符必须移除或泛化。
  • 当来源是内部、客户特定或不必要用于回答时,使用通用类别,例如“媒体 SDK”、“MMP SDK”、“社交媒体渠道”、“广告网络”、“落地页日志”或“安装来源 API”。
  • 使用相对时序,例如“初始请求”、“回退超时”和“短轮询窗口”;除非用户为当前交付物提供了日期,否则避免使用历史日期。

相关技能