사전 준비하기
운영하고 계신 서비스에 인앱게임을 실행하기 위해 런처(Launcher) API호출이 필요합니다. 프로모션 등록시 발급받는 Secret Key를 API key로 사용하여 런처는 서비스에서 웹뷰 형태로 인앱게임을 제공합니다. 게임을 실행할 수 있도록 서비스 내에서 런처를 호출할 수 있는 UI 트리거를 생성하세요. 생성된 UI 트리거로 유저는 앱을 이탈하지 않고 게임을 진행할 수 있습니다.
Secret Key 확인하기
bleepy Client Admin에서 생성한 프로모션에서 제공하는 Secret Key를 준비합니다.
- [Client Admin] > [프로모션 관리] > [프로모션 목록] > [프로모션 상세] > [Secret Key 확인하기] 에서 Secret Key 정보를 확인합니다.
Ⓐ Secret Key 확인하기 : 프로모션을 등록하시면 프로모션 상세 페이지에 해당 버튼이 노출되며, 버튼 클릭 시 Secert Key가 표시된 팝업창이 호출됩니다.
Ⓑ Secret Key : 자사 서비스에서 게임을 설치하실 때, 게임을 호출하기 위해 임의의 난수로 구성된 Key입니다.
주의!
블리피에서 제공하는 Secret Key는 게임을 임베디드하고 호출하는데 핵심적인 역할을 수행합니다. 클라이언트에게 제공되는 Private Key로, 외부 유출이나 분실 시 재발급이 불가능합니다. 또한, 보안 관리에 대한 책임은 전적으로 클라이언트에게 있음을 알려드립니다.
Query String 규격 확인하기
블리피 런처는 클라이언트의 게임 호출 시, 최소한의 정보를 Query string 형태로 전달받습니다.
Query String 이란?
사용자가 입력 데이터를 전달하는 방법중의 하나로, URL 주소에 미리 협의된 데이터를 파라미터를 통해 넘기는 것을 의미합니다.
Query String 형식
정해진 URL 주소 이후에 ?를 쓰는것으로 Query string이 시작합니다. key=value 형태로 필요한 파라미터의 값을 작성합니다. &를 붙여 여러개의 파라미터를 넘길 수 있습니다. ex) `${런처URL}?${key1}=${value1}&${key2}=${value2}`
공통 Query String
${런처URL}?${UserKey}=${Userkey value}&${Secretkey}=${Secretkey value}
Key | Required | Description |
|---|---|---|
런처URL | required | 시크릿키 발급 후 클라이언트 어드민에서 확인하실 수 있습니다. |
userKey | required | 유저의 고유한 Key 값으로, 클라이언트가 설정 후 필수적으로 전달해주셔야합니다.
보내주신 Key 기준으로 인사이트를 집계합니다.
⚠️ 주의해 주세요! userkey는 최대 255자까지 허용되며, 255자를 초과한 경우 게임 실행이 불가능합니다. 만약 255자를 초과한 userkey로 게임을 실행하면 안내 팝업이 표시됩니다. (안내 내용: 고객 정보를 확인할 수 없습니다. 고객센터로 문의해 주세요) |
secretKey | required | 프로모션 등록 시 발급되는 유니크한 Key 정보로 필수적으로 전달해주셔야합니다. |
language | optional | 게임의 언어는 기본적으로 클라이언트 어드민의 가입된 사업자 국가를 따르지만 게임의 언어를 강제로 변경할 때
해당 옵션을 사용합니다.
|
platform | optional | 런처에 미리 정의된 개발 플랫폼 별 통신 방법을 따르기 위한 구분값입니다.
|
signUpAt | optional | 친구 초대 미션을 사용하는 경우 추가가 필요한 내용입니다.
|
개발에 대한 추가 설명이 더 필요하신가요?
"[Client Admin] 로그인 → 오른쪽 하단 채널톡 위젯" 클릭 후 개발 카테고리에 문의 남겨주시면 기술 개발팀에서 확인 후 연락드리겠습니다.
v1.0.6