매일 미션

매일 미션은 [Client Admin]에서 프로모션 등록 시 설정할 수 있는 게임 미션입니다.

유저가 매일 참여 할 수 있는 미션은 Action/Timer 2가지 타입으로 구분되며, 미션 참여를 위해서 이동될 화면 링크를 설정할 수 있습니다.

Timer 미션

Timer 미션은 App/Web 서비스 도메인의 환경에 따라 차이가 있습니다. 아래 버전 별 가이드를 참고해주세요.

App 버전

프로모션 설정 시 Timer 미션을 적용할 화면의 앱 내 이동 링크(딥링크)를 지정합니다. 블리피에서 제공하는 Timer UI 사용을 위해 화면 내에 WebView 를 선언하고 Timer URL 을 로드해주세요. Timer는 프로모션 내 미션 생성 시 설정한 수행시간만큼 동작하고, 사용자가 해당 시간만큼 체류하게 되면 Timer는 자동으로 미션 완료 여부를 블리피 내 API 서버로 전송합니다.

Timer URL 정보

  • 런처 호출 URL/timer?platform={platform}&placement={placement}

  • 위치는 자사 내에서 협의 후 적절한 위치를 정하는걸 추천드립니다.

  • 추천 사이즈는 width 100%, height 30px을 권장합니다.

  • 기본 정렬은 왼쪽 정렬이지만, placement 옵션을 사용하면 좌/우 정렬 변경이 가능합니다.

Key
Required
Description

platform

required

Timer 미션 완료 시 이벤트를 전달을 위해 사용

  • android

  • ios

  • reactNative

  • flutter

placement

optional

Timer UI 좌/우 배치 변경

  • left

  • right (default)

Web 버전

Web 기반의 서비스를 사용중인 클라이언트는 프로모션 등록 시 Timer 미션을 적용할 Web 도메인 링크를 이동 링크에 입력합니다.

Web 버전의 경우 블리피 런처에서 자동으로 Timer UI를 실행하기에 위치 등의 커스텀에 제한이 있는점을 참고해주세요.

Action 미션

Action 미션은 App/Web 서비스 도메인의 환경에 따라 차이가 있습니다. 아래 버전 별 가이드를 참고해주세요.

App 버전

프로모션 설정 시 Action 미션을 적용할 화면의 앱 내 이동 링크(딥링크)를 지정합니다. 미션을 수행할 앱 내 화면으로 이동 후, 유저가 해당 미션을 완료하는 시점에 블리피 Open REST API 를 호출하여 미션의 완료를 전달해야 합니다. 이 경우 Server To Server 구조로 진행하는걸 추천드립니다.

API 연동을 위해서는 REST API 메뉴를 참고해주시기 바랍니다.

Action 미션 완료 요청에는 actionMissionCode 값이 필수로 필요합니다.

  • 프로모션 설정 시 이동링크 딥링크에 queryString 형태로 ?actionMissionCode={actionMissionCode} 구문을 필수로 붙여주세요.

  • 런처는 딥링크 호출 시 {actionMissionCode} 구문을 실제 미션코드 값으로 치환하여 전달합니다.

  • 클라이언트는 딥링크에서 전달되는 actionMissionCode 값을 블리피 Open REST API 요청 시 사용해주세요.

// scheme: bleepy / host: event
딥링크 예시 => bleepy://event?actionMissionCode={actionMissionCode}

Web 버전

App 버전과 개발 프로세스는 동일하나 Web 버전의 경우 이동링크 설정 시 딥링크가 아닌 이동하고자 하는 Web 서비스 도메인 링크를 입력하시면 됩니다.

개발에 대한 추가 설명이 더 필요하신가요?

"[Client Admin] 로그인 → 오른쪽 하단 채널톡 위젯" 클릭 후 개발 카테고리에 문의 남겨주시면 기술 개발팀에서 확인 후 연락드리겠습니다.

Last updated