사전 준비하기

ℹ️ 인앱게임 설치 전, 확인해주세요!

현재 운영 중인 서비스에 인앱게임을 설치하기 위해서는 게임을 호출하기 위한 런처 URL과 Secret Key가 필요합니다.

아래 사전에 준비해야 할 항목을 확인하신 후 개발자 사이트에서 연동 가이드를 꼭 확인해 주세요!

Secret Key란 무엇인가요?

Secret Key는 영문과 숫자로 이루어진 난수로, 프로모션 등록시 선택한 게임을 호출하기 위해 필요한 API Key의 역할을 합니다.

어드민에서 프로모션 등록 시 발급되는 Secret Key는 클라이언트에게 제공되는 Private Key로, 외부 유출이나 분실 시 재발급이 불가능합니다. 따라서 보안 관리에 대한 책임은 전적으로 클라이언트에게 있으므로, 보안 관리에 유의해 주세요!

발급된 Secret Key를 확인하는 방법은 아래 이미지를 참고해 주세요.

Secret Key 확인하기

자사 서비스애 선택한 게임을 설치하기 위해 Secret Key가 필요합니다.

프로모션 등록 완료 후 '프로모션 등록 완료 팝업'에서 Secret Key를 확인할 수 있습니다.

▸ 등록된 '프로모션의 상세페이지'에서 [Secret Key 확인하기] 버튼을 클릭하여 팝업에서 확인할 수 있습니다.

런처URL이란 무엇인가요?

런처 URL은 운영 중인 서비스에서 게임을 호출하려고 할 때 필요한 URL 주소이며, 게임에 대한 최소한의 정보를 전달하는 역할을 합니다.

런처 URL의 게임 호출 시 런처 URL에는 게임 정보를 전달하기 위해 필요한 몇 가지 항목이 함께 작성되어야 합니다. 자세한 가이드는 '개발자 사이트'에서 확인하실 수 있습니다.

프로모션 등록을 완료하신 후 프로모션 상세 페이지에서 런처 URL을 확인하실 수 있습니다. 확인하는 방법은 아래 이미지를 참고해 주세요!

런처 URL 확인하기

자사 서비스에서 선택한 게임을 호출하기 위해 런처 URL 이 필요합니다.

▸ 등록된 '프로모션 상세 페이지'에서 런처 URL을 확인할 수 있습니다.

블리피에서 제공하는 Secret Key와 런처 URL은 게임을 임베디드하고 호출하는데 핵심적인 역할을 수행합니다. 보안 관리에 대한 책임은 전적으로 클라이언트에게 있음을 알려드립니다.

또한, Secret Key는 클라이언트에게 제공되는 Private Key로, 외부 유출이나 분실 시 재발급이 불가능합니다.

Userkey란 무엇인가요?

Userkey는 클라이언트가 직접 관리하고 있는 값으로, 게임을 진행한 클라이언트의 유저를 식별하기 위해 사용됩니다. 이 정보는 개인정보 대신 사용되며, '인사이트' 메뉴에서 유저별 게임 참여 현황을 확인할 때 활용됩니다.

최대 255자까지 허용되며, 이 값을 초과하면 게임 실행이 불가능합니다. 이 점을 유의하여 주시길 바랍니다! 만약 255자를 초과한 Userkey로 진입한 경우, 게임 내에서 안내 팝업이 표시됩니다. (안내 내용: 고객 정보를 확인할 수 없어요. 고객센터에 문의해 주세요.)

FAQ

Q. 프로모션을 등록해야만 Secret Key와 런처 URL을 확인할 수 있나요?

네, Secret Key와 런처URL은 게임을 호출하는 중요한 역할을 하여 프로모션을 진행하시는 클라이언트에게만 제공드리고 있습니다.

런처 URL은 모든 프로모션에서 공통적으로 사용되지만, Secret Key는 프로모션마다 상이합니다. 또한 동일한 프로모션에 다른 Secret Key로 재발급이 어려우므로 보안 관리에 유의해 주세요!

Q. 발급 받은 Secret Key를 사용하여 서비스에 설치하면 바로 게임을 실행할 수 있나요?

프로모션 등록 시 설정한 기간과 동일한 기간 동안 게임을 실행할 수 있습니다.

만약 프로모션 시작 전에 게임이 이미 설치되어 있다면, 유저가 해당 UI 트리거를 클릭 시 '게임 참여 불가'에 대한 안내 알럿이 표시됩니다.

게임을 설치하기 전에는 꼭 설정하신 프로모션의 기간을 확인해 주시고 진행해 주세요!

Q. 게임 설치에 한 번 사용한 Secret Key는 재사용할 수 없나요?

발급 받으신 Secret Key는 사용 제한 없이 게임을 설치할 수 있습니다. 다만, 각 Secret Key에 대한 게임 현황은 해당 Secret Key로 등록한 각각의 프로모션에 대한 것으로만 확인할 수 있습니다. 다시 말해, 동일한 Secret Key로 다른 서비스에서도 게임을 설치할 수 있지만, 인사이트는 통합되어 표시됩니다.

따라서 운영 중인 서비스별로 게임 현황을 확인하려면, 동일한 게임에 프로모션을 추가 등록하여 진행해야 합니다.

Last updated