미라클플레이 연동

개요¶

• 미라클플레이를 연동하기 위해서는 필수적으로 게임의 데이터를 조회할 수 있는 Open API를 구축하고 필요한 데이터를 제공해야 합니다.
• 이러한 과정을 ‘애널리틱스 로그 조회 API’를 이용하면 빠르고 쉽게 미라클플레이와 연동할 수 있으며, 이를 위한 가이드를 제공합니다.

연동방법¶

전제 조건¶

• Hive 콘솔에 가입하고, 게임 개발 시 Hive SDK를 사용해야 합니다.

연동 구조¶

연동 과정¶

• Hive 연동: Hive 콘솔 가입과 Hive SDK 연동 후 앱센터에서 게임과 appid를 발급합니다.
• 데이터가 저장될 로그 테이블을 선정 : 사전 정의된 로그를 활용하거나 새로 정의하여 사용합니다.
  1. 애널리틱스 콘텐츠 로그를 활용하는 방법 : 사전 정의된 로그로 별도의 작업없이 활용 가능합니다.
  2. 새로 로그정의를 통해 생성하는 방법 : 애널리틱스 로그정의 기능을 이용해 로그가 저장될 테이블을 생성하여 활용 가능합니다.

• 로그 조회 API 발급 : 선정된 로그 테이블에 대한 API를 발급합니다.

  1. 위치 : 애널리틱스 > 로그 정의 > 선정된 로그 테이블 선택
  2. 로그 조회 API의 ‘등록’ 버튼을 클릭
  3. 생성된 로그 조회 API 2개와 액세스 키 2개 확인

• 미라클 플레이에 API 제공 : 생성된 로그 조회 API 2개와 액세스 키 2개 모두 필요합니다.

• 로그 전송 : 게임의 서버 또는 클라이언트에서 애널리틱스로 실시간 전송합니다.(로그 전송 하기 가이드)
• 미라클 플레이의 데이터 조회 : 미라클플레이에서 ‘로그 조회 API’를 통해 데이터를 조회합니다.

참고사항¶

• 액세스 키 갱신/만료
  • 동일한 기능을 수행할 수 있는 액세스 키 2개가 발급됩니다.
  • 보안 등의 이슈 발생시 액세스 키 2개는 개별로 갱신 또는 만료가 가능합니다.