성장 마케팅 및 Discord 제휴 운영
이 문서는 AvatarShot이 제휴와 소셜 성장을 어떻게 추적하는지, Discord 자동화가 어떻게 작동하는지, 관리자가 캠페인 자동화를 실시간으로 안전하게 시작하거나 중지하는 방법을 정의합니다.
범위
- 추천 귀속(코드, 소스, 캠페인)
- 소셜 공유 이벤트 추적 및 마일스톤 보상
- Discord 성장 알림 자동화
- 실시간 시작/중지 운영을 위한 관리자 컨트롤
추천 귀속 모델
사용자가 추천 URL을 통해 유입되면 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 성장 알림은 웹훅 연동을 통해 전송되며 배포 없이도 켜고 끌 수 있습니다.
- 관리자 페이지:
/admin/growth - Start 버튼: Discord 자동화를 즉시 활성화합니다
- Stop 버튼: Discord 자동화를 즉시 비활성화합니다
- 상태는 Running 또는 Stopped로 표시됩니다
웹훅 구성: DISCORD_WEBHOOK_URL을 설정하세요. 설정되지 않으면 자동화는 실행 중일 수 있어도 Discord로 메시지가 전송되지 않습니다.
운영 권장사항
- Discord 웨이브마다 캠페인 코드를 하나씩 만들어 귀속을 명확히 유지하세요.
- 일관된 소스 라벨(discord, x, telegram 등)을 사용하세요.
- Admin Growth Hub에서 매주 성장 지표를 검토하세요.
- 캠페인 QA나 인시던트 대응 중에는 Stop 컨트롤로 자동화를 일시 중지하세요.