개요

용어 정의

• 게이미피케이션 콘텐츠 — 블로믹스 혹은 콘텐츠 제공사(3rd-Party)가 web 으로 제공하는 게임, 운세, 퀴즈, 숏폼 드라마 등의 광고 송출이 포함된 콘텐츠
• 매체사 — 콘텐츠를 소비할 수 있는 유저를 제공하는 회사 (매체사 앱, 매체사 서버 운영)
• 콘텐츠 제공사 — 유저가 소비할 콘텐츠(게임, 웹툰, 퀴즈 등)를 제공하는 회사 (콘텐츠사 앱, 콘텐츠사 서버 운영)
• 블로믹스 플랫폼 — 매체 앱과 콘텐츠를 연결하여 캠페인과 리워드 서비스를 제공하는 플랫폼 (블로믹스 서버, 블로믹스 웹, 블로믹스 어드민 운영)

전체 연동 흐름

매체사 앱, 블로믹스 서버, 콘텐츠사 앱/서버 간의 전체 플로우는 다음과 같습니다.

1단계: 매체사에 콘텐츠 노출

• 매체사는 매체사 앱 내에 블로믹스 콘텐츠가 노출될 수 있도록 진입점을 제공합니다. (메뉴, 배너 등)
• 매체사 서버가 블로믹스 서버의 콘텐츠 목록 조회 API를 호출하여 콘텐츠를 노출합니다. (선택)

2단계: 사용자가 콘텐츠 실행

• 매체사 앱이 블로믹스 게이트웨이 URL을 웹뷰로 호출합니다.
• 블로믹스 서버가 사용자를 인증하고 콘텐츠사 앱으로 리다이렉트합니다.

3단계: 콘텐츠 초기화

• 콘텐츠사 서버가 블로믹스 서버의 세션검증 API로 세션을 확인합니다.
• 콘텐츠사 서버가 이벤트 API로 캠페인별 이벤트 목록을 조회하여 목표를 설정합니다.

4단계: 콘텐츠 플레이 및 이벤트 달성

• 사용자가 콘텐츠를 플레이합니다.
• 콘텐츠 웹뷰는 Javascript Interfaces(nativeBridge/nativeCallback)를 통해 네이티브 앱과 상호작용합니다. (뒤로가기 처리, 영상 광고 재생, 외부 브라우저 열기 등)
• 콘텐츠사 서버는 사용자의 다양한 달성 이벤트(게임 결과, 미션 등)를 블로믹스 서버로 전송합니다.
• 블로믹스 서버는 콘텐츠사 서버로부터 전달받은 이벤트를 판단하여 포인트 적립을 결정합니다.

5단계: 포인트 적립 및 포스트백

• 블로믹스 서버가 매체사 서버의 포스트백 API를 호출하여 포인트 적립을 요청합니다.
• 매체사 서버가 해당 사용자에게 포인트를 적립합니다.
• 실패 시 블로믹스 서버가 자동 재시도합니다. (exponential backoff)

핵심 흐름도

전체 흐름을 시퀀스 다이어그램으로 표현하면 다음과 같습니다.