🤠 와일드 WEST에 오신 걸 환영합니다 - 추천 캠페인을 위한 Grida WEST

재미있고 유연하며 강력한 추천 엔진입니다.

Grida WEST는 개발자에게 의존하지 않고도 빠르게 성장하고 더 나은 보상을 제공하는 캠페인을 마케터가 직접 시작할 수 있도록 설계된 차세대 추천 캠페인 플랫폼입니다. 물론 개발자도 안전하고 구조화된 백엔드를 사용할 수 있습니다.

---

✨ 만들 수 있는 것들

🪜 마일스톤 추천

예시: "친구 5명을 초대하면 $5 크레딧, 10명을 초대하면 $15 크레딧 제공"

보상이 점차 커지는 캠페인을 만들어 보세요. 참여자는 진척도를 느끼며 다음 목표를 향한 기대감을 가집니다. 일종의 게이미피케이션된 추천 사다리입니다.

🚀 스타트업 사전 예약 대기 리스트

예시: "친구를 추천하면 대기열 순위가 올라갑니다."

런칭에 적합합니다. 초반 입소문과 바이럴 공유를 유도할 수 있습니다. 초대된 사람도 친구를 데려오면 순위가 올라갑니다.

📬 뉴스레터 추천

예시: "3명을 추천하면 Pro 시리즈를 이용할 수 있어요."

콘텐츠, 쿠폰, 굿즈 등으로 독자에게 보상을 제공합니다. Mailchimp, Beehiiv 등과 잘 통합됩니다.

🎁 바이럴 경품 이벤트

예시: "이벤트에 참여하고 친구를 초대하면 당첨 확률이 올라갑니다."

경품 이벤트의 확산력을 키워줍니다. 누가 누구를 초대했는지 추적하고, 초대 횟수에 따라 확률을 높입니다. 보상은 추첨, 디지털 아이템, 명예 등 다양합니다.

🛍️ Shopify 캠페인

예시: "친구를 추천하면 두 사람 모두 10% 할인"

WEST를 스토어에 설치해 양방향 추천 프로그램을 바로 시작할 수 있습니다. 포인트, 크레딧, 쿠폰 등 사용자 정의 보상 로직과 잘 작동합니다.

🤝 양방향 클래식

예시: "친구를 추천하면 내가 $10, 친구는 $5 받기"

공개 또는 비공개 초대 코드를 사용할 수 있습니다. WEST는 셀프 초대 및 추천인 초대 흐름을 모두 지원합니다. 공개 범위도 선택할 수 있습니다.

---

🧰 작동 방식

모든 WEST 캠페인의 중심 요소:

🎟️ 추천인

• 추천 코드를 공유하는 사용자
• 캠페인마다 고유 코드 보유
• 초대 수 제한 가능

📩 초대

• 추적 가능한 링크/코드
• 청구되기 전까지는 새로 고칠 수 있음
• 청구되면 초대받은 사람은 캠페인에 참여하게 됨

🪙 보상

• 마일스톤 보상: 일정 초대 수 도달 시 추천인에게 제공
• 온보딩 보상: 초대받은 사람이 퀘스트를 완료하면 제공
• 모든 보상은 교환 토큰 형태로 발급되며, 나중에 청구 가능

🧩 챌린지 / 퀘스트

• 온보딩을 완료하기 위한 요구 작업 정의
• 예시: "회원가입", "구매", "이메일 인증" 등
• 의존성으로 연결 가능

📊 분석

• 모든 이벤트의 실시간 로그
• 이벤트 빈도, 캠페인 성장, 추천 관계 시각화

🌐 내장 페이지

• 공유용 랜딩 페이지
• 고객용 진행 현황 대시보드
• 선택적 공개 리더보드

---

🙋 FAQ

Q: 아무나 캠페인을 시작할 수 있나요?

네, 프로젝트 소유자라면 누구나 가능합니다. 프로젝트에 연결된 캠페인을 생성, 비활성화/활성화, 관리할 수 있습니다.

Q: 초대자 또는 추천인의 정보를 숨길 수 있나요?

네. 이름이나 아바타 노출 여부를 설정할 수 있습니다. 기본값은 비공개입니다.

Q: 사용자가 자신을 초대할 수 있나요?

원하신다면 가능합니다. 셀프 초대 모드에서는 공개 코드를 사용해 자신의 초대를 생성합니다.

Q: 추천인이 직접 초대를 생성하게 할 수 있나요?

가능합니다. 추천인 초대 모드입니다. 추천인이 초대를 생성하고 직접 공유합니다.

Q: 초대 링크를 새로 고칠 수 있나요?

예. 청구되지 않은 초대는 새 코드로 갱신할 수 있으며, 이전 코드는 무효화됩니다.

Q: 보안은 어떤가요?

안전합니다. 모든 캠페인 로직은 Row-Level Security(RLS)로 DB 수준에서 강제됩니다. 코드는 항상 캠페인 컨텍스트에 연결됩니다.

---

🧠 고급 기능

WEST는 PostgreSQL과 Supabase 위에 구축되어 있으며, 개발자를 위한 안전하고 확장 가능한 데이터 모델을 제공합니다.

🛡️ 완전한 RLS 적용

모든 테이블은 RLS가 활성화되어 있습니다. 접근은 캠페인/프로젝트 단위로 범위가 설정됩니다. 다중 테넌트 및 공개 사용에도 안전합니다.

🔗 고유 코드 처리

모든 코드(추천인/초대자)는 캠페인 내에서 고유함이 보장됩니다. 트리거와 함께 code 레지스트리 테이블에 저장됩니다.

📬 track()을 통한 이벤트 후킹

track() 함수를 호출하여 사용자 활동을 추적하세요. event_log 하이퍼테이블에 로그가 기록되며 시간 기반 분석이 가능합니다.

📈 내장 분석 API

analyze()를 사용하여 이벤트 이름 기준의 시간 단위 통계 데이터를 얻을 수 있습니다. 대시보드나 퍼널 시각화에 적합합니다.

🧪 교환 토큰으로서의 보상

보상 정의는 실질적 교환과 분리되어 있습니다. 즉, "획득했지만 아직 전달되지 않은" 상태로, 인벤토리나 상품 관리를 유연하게 합니다.

🧱 초대 흐름 함수

핵심 흐름은 SQL 함수로 처리됩니다:

• invite() – 새 초대 생성
• refresh() – 초대 코드 재생성
• claim() – 초대 청구 처리
• flag() – 퀘스트/챌린지 진행 기록

---

💼 개발자 / 연동

• Supabase에서 직접 SQL 함수 호출 또는 REST/RPC 엔드포인트 사용
• 스키마: grida_west_referral
• 테이블: campaign, referrer, invitation, onboarding, event_log 등
• 공개용 뷰: referrer_public_secure, invitation_public_secure, campaign_public
• 웹훅 연동 및 Zapier 호환 플로우 문서 예정

---

🔚 마무리

Grida WEST는 헤드리스 추천 엔진의 유연함, 검증된 스키마의 안전함, 그리고 코드 걱정 없이 캠페인을 설정하는 즐거움을 제공합니다.

지금 바로 첫 캠페인을 시작하세요.
추적하고, 공유하고, 당신의 챔피언에게 보상하세요.

WEST는 거칩니다 — 하지만 이제는 당신의 것입니다.

🧨 달려봅시다.