Developers
로그인

드롭스 연동 가이드

드롭스 캠페인을 운영하기 위한 단계별 안내입니다. 드롭스가 무엇인지는 드롭스 소개, OpenAPI 스펙은 드롭스 API를 참고하세요.

인게임 보상

게임사 서버가 씨미 OpenAPI를 통해 청구 내역을 수령하고, 게임 내에서 직접 보상을 지급하는 방식입니다.

특징

  • 자주·지속적으로 캠페인을 운영하는 게임에 적합합니다.
  • 보상 종류와 수량을 자유롭게 설계할 수 있습니다.
  • 시청자의 씨미 계정과 게임사 계정이 OAuth로 연동되어 있어야 수령이 가능합니다.
  • 시청자는 시청 조건을 달성한 즉시(방송 중에도) 수령 요청을 할 수 있고, 수령 마감 시각(claimAvailableAt) 전까지 유효합니다. 게임사 지급은 OpenAPI 폴링 주기에 따라 비동기로 처리됩니다.

필요한 작업

  1. 씨미 개발자센터에서 애플리케이션을 등록합니다.
  2. 씨미에 드롭스 카테고리 연결을 문의합니다.
  3. OAuth 연동 서버를 준비합니다 (Redirect URI 등록 포함).
  4. 캠페인을 생성하고 심사를 요청합니다.
  5. 심사 승인 후, 게임사 서버에서 씨미 OpenAPI를 주기적으로 폴링하여 청구 내역을 받아 지급 처리합니다.

선착순 쿠폰

게임사가 업로드한 쿠폰 코드를 자격을 획득한 시청자에게 자격 획득 순서(FIFO)로 자동 배분하는 방식입니다.

특징

  • 빠른 캠페인 론칭이 가능합니다.
  • 별도의 API 연동이 필요하지 않습니다.
  • 쿠폰 코드는 참여자당 1개씩 개별 고유 코드로 소비됩니다.
  • 캠페인 진행 중뿐 아니라 수령 마감 시각 전까지 추가 업로드가 가능합니다. 대기 중인 자격자가 있다면 즉시 이어서 배분됩니다.

필요한 작업

  1. 씨미 개발자센터에서 애플리케이션을 등록합니다.
  2. 씨미에 드롭스 카테고리 연결을 문의합니다.
  3. 캠페인을 생성하고 보상별로 쿠폰 코드를 업로드합니다.
  4. 심사 요청 후 승인되면 자동으로 운영이 시작됩니다.

주의

  • 쿠폰 여유 분을 충분히 확보하시거나 캠페인 기간 중 추가 업로드를 권장드립니다.

랜덤 쿠폰

캠페인 종료 후 자격을 획득한 시청자 중 무작위 추첨으로 쿠폰을 지급하는 방식입니다.

특징

  • 참여 타이밍에 무관한 공정한 추첨 방식입니다.
  • 쿠폰 업로드·관리는 선착순 쿠폰과 동일합니다.
  • 같은 캠페인 안에서 선착순 쿠폰과 혼용할 수 있습니다.
  • 추첨은 캠페인이 수령 대기(CLAIMABLE) 상태로 전환된 이후에 진행됩니다. 캠페인 진행(ACTIVE) 중에는 추첨이 일어나지 않습니다.
  • 수령 대기 구간에 쿠폰을 추가 업로드하면 아직 당첨되지 않은 자격자 풀에서 재추첨합니다.

필요한 작업

  1. 애플리케이션 등록 및 카테고리 연결 문의
  2. 캠페인 생성 시 보상 타입을 랜덤 쿠폰으로 지정하고 쿠폰 업로드
  3. 심사 승인 후 운영 시작

캠페인 운영 흐름

  1. 애플리케이션 등록 — 씨미 개발자센터에서 등록 후 Client Id / Client Secret을 발급받습니다.
  2. 카테고리 연결 문의 — 씨미에 해당 게임 카테고리 연결을 요청합니다.
  3. 캠페인 생성 — 기간(시작·종료·수령 마감), 보상 목록, 최소 시청 시간, 허용 채널을 설정합니다.
  4. 쿠폰 업로드 (쿠폰형) — 보상별로 개별 고유 코드를 줄바꿈 구분 또는 CSV로 업로드합니다.
  5. 심사 요청 — 생성한 캠페인을 제출합니다.
  6. 운영 — 심사 승인 후 시작 시각이 도래하면 시청자에게 노출되고 시청 집계가 시작됩니다. 인게임 보상은 이 구간부터 시청 조건을 달성한 시청자가 바로 수령 요청을 할 수 있습니다.
  7. 수령 대기 — 종료 시각이 지나면 캠페인은 수령 대기 상태가 됩니다. 이 구간에 랜덤 쿠폰 추첨·쿠폰 추가 업로드·인게임 보상 수령이 계속 진행됩니다.
  8. 보상 전달 — 보상 타입에 따라 씨미가 자동 배분하거나, 게임사 서버가 OpenAPI로 청구 내역을 받아 지급합니다.
  9. 완료 — 수령 마감 시각(claimAvailableAt) 도래 시 캠페인이 완료 상태로 전환되고 잔여 자격자의 미수령 보상은 만료됩니다.

자주 묻는 질문

Q. 보상 타입을 나중에 변경할 수 있나요? 캠페인 생성 후에는 변경이 불가능합니다. 새 캠페인을 생성해 주세요.

Q. 한 캠페인에 인게임 보상과 쿠폰 보상을 함께 둘 수 있나요? 쿠폰과 인게임 보상은 함께 둘 수 없습니다. 쿠폰끼리(선착순 + 랜덤)는 혼용 가능합니다.

Q. 쿠폰형에도 OAuth 연동이 필요한가요? 필요하지 않습니다. 시청자가 보관함에서 코드를 직접 확인하여 게임에 입력합니다.

Q. 인게임 보상 수령을 자동화하려면 어떻게 해야 하나요? 씨미 OpenAPI를 주기적으로 폴링하여 내역을 받아 지급 처리하시면 됩니다. 자세한 내용은 드롭스 API를 참고하세요.

Q. 인게임 보상은 언제부터 수령할 수 있나요? 시청자는 방송 중(ACTIVE 구간)에 시청 조건을 달성한 즉시 수령 요청을 할 수 있습니다. 수령 마감 시각(claimAvailableAt) 전까지 유효하며, 게임 내 지급은 게임사 서버의 OpenAPI 폴링 주기에 따라 비동기로 이루어집니다.

Q. 쿠폰이 부족한 상태에서 캠페인이 종료되면 어떻게 되나요? 수령 마감 시각 전까지 대기 중인 자격자는 유지됩니다. 이 구간에 추가 쿠폰을 업로드하면 자격자에게 자동 배분(선착순) 또는 재추첨(랜덤)됩니다. 수령 마감 시각 이후에는 미수령 자격이 만료됩니다.

Q. 허용 채널을 변경하면 시청 중인 참여자의 누적 시간은 어떻게 되나요? 누적 시청 시간은 그대로 보존됩니다. 허용 채널 중 다른 방송을 계속 시청하시면 이어서 집계됩니다.

Q. Webhook 알림은 지원되나요? 현재는 지원하지 않습니다. 폴링 방식으로 구현해 주세요.

문의

연동 및 캠페인 관련 문의는 씨미 담당 채널로 부탁드립니다.