增长营销与 Discord 联盟运营
本文档定义了 AvatarShot 如何追踪联盟与社交增长数据、Discord 自动化的工作原理，以及管理员如何在运行时安全地启动或停止活动自动化。
范围
- 推荐归因（代码、来源、活动）
- 社交分享事件追踪与里程碑奖励
- Discord 增长通知自动化
- 用于实时启动/停止操作的管理控制项
推荐归因模型
当用户通过推荐网址访问时，AvatarShot 会将活动上下文存储在会话中，并在首次注册时将其绑定到该账户。
/ref/{code}?source=discord&campaign=summer_drop/ref/discord/{code}?campaign=launch_week
新账户创建时，会持久化保存以下字段：
referral_code（用于奖励关联）referral_source（用于渠道归因，例如 discord）referral_campaign（用于活动级别的报表统计）
社交分享追踪
Feed 分享行为通过 feed/actions/track 进行追踪，并映射为 share_platform 动作。
已配置的平台包括原生分享、X、WhatsApp、Telegram、Facebook、LinkedIn、Reddit、Discord、Instagram、TikTok、Pinterest 和 YouTube。不支持直接分享的平台会使用复制链接作为回退方式，同时仍会记录追踪事件。
奖励逻辑
- 推荐奖励：每达到设定数量的受邀用户即可获得 Pro 天数。
- 发帖分享里程碑：达到发帖数量里程碑即可获得 Pro 天数。
- 社交分享里程碑：达到已追踪的分享里程碑即可获得 Pro 天数。
所有阈值均可通过环境变量在 config/marketing.php 中进行配置。
Discord 自动化（运行时启动/停止）
Discord 增长通知通过 Webhook 集成发送，并可在无需重新部署的情况下切换开关。
- 管理页面：
/admin/growth - 启动按钮：立即启用 Discord 自动化
- 停止按钮：立即停用 Discord 自动化
- 状态显示为运行中或已停止
Webhook 配置：设置 DISCORD_WEBHOOK_URL。如果未设置，自动化可能处于运行状态，但不会发送任何 Discord 消息。
运营建议
- 为每一波 Discord 推广创建一个独立的活动代码，以确保归因清晰。
- 使用一致的来源标签（discord、x、telegram 等）。
- 每周在管理后台增长中心查看增长指标。
- 在活动 QA 或事件响应期间，使用停止控制项暂停自动化。