게임플레이 파트너 가이드

테마 전환

게임 로그 설정 ​

게임플레이 JS SDK를 사용하지 않는 게임에서 Tiara Web SDK로 구현해야 하는 필수 게임 로그를 안내합니다.
SDK 설치와 메서드 사용법은 Tiara Web SDK를 참고하세요.

게임플레이 JS SDK를 쓰는 게임

이 문서의 구현은 필요하지 않습니다. SDK가 게임 로그를 대신 보냅니다.
액션명도 SDK 전용 명세를 쓰므로 아래 표와 다릅니다. 자세한 내용은 전체 메서드: 게임 로그을 참고하세요.

필수 세팅 항목 ​

게임플레이 JS SDK를 사용하지 않는 게임에서 Tiara Web SDK를 직접 적용할 때 다음 4가지를 반드시 설정해야 합니다.

#항목값 / 방법
1서비스 도메인 (svcDomain)gameplay.kakao.com 고정.
별도 신규 신청은 필요하지 않습니다
2제3자 정보 제공 동의 (thirdProvideAgree)true 고정.
게임플레이 진입 시 제3자 제공 동의를 필수로 수령합니다.
설정 방법은 제3자 동의 여부 세팅을 참고하세요
3필수 게임 로그 11종아래 게임 로그 정의에 정의된 11종의 게임 로그를 Tiara Web SDK 가이드의 trackPage / trackEvent / trackViewImp / trackUsage 메서드로 구현합니다
4카카오 사용자 식별값 (AccessToken 또는 AppUserId)두 방식 중 하나로 필수 세팅.
미세팅 시 카카오 분석 환경에서 게임 로그를 집계·활용할 수 없습니다.
설정 방법은 AccessToken / AppUserId를 참고하세요

svcDomain은 모든 입점 파트너사가 동일하게 gameplay.kakao.com 값을 사용합니다.
파트너사·게임 구분은 게임플레이 파트너센터오픈 예정에 등록한 게임 코드로 처리합니다.

게임 로그 정의 ​

게임플레이 입점 파트너사가 필수로 구현하는 게임 로그 11종입니다.
이 가이드의 메서드(trackPage · trackEvent · trackViewImp · trackUsage)로 구현하며, {게임ID}는 게임플레이 파트너센터오픈 예정에 등록한 게임 코드를 그대로 사용합니다.
메타데이터 API로 게임을 등록했던 파트너사는 그 code 값을 사용합니다.
게임 이름이나 공백은 사용할 수 없습니다.

게임플레이 JS SDK 를 쓴다면 이 표가 아닙니다

아래 값은 직접 연동하는 게임용입니다.
게임플레이 JS SDK는 section · page · 액션명이 모두 다릅니다 — 두 경로의 로그를 분석 단계에서 가를 수 있어야 하기 때문입니다.

직접 연동 (이 표)게임플레이 JS SDK
SectionSDK_{게임ID}sdk_ui_{게임ID}
PageSDK게임SDK_UI
Name아래 표SDK_UI_ 접두어로 통일
#발생 시점SectionPageTypeName비고
1게임 페이지 진입SDK_{게임ID}SDK게임PageviewSDK_게임_조회actionKind: ViewContent · page_meta 세팅 필수(id 필수)
2게임 체류시간 수집SDK_{게임ID}SDK게임UsageSDK_게임_체류시간duration(ms) 필드 필수
3상단 더보기 버튼 클릭SDK_{게임ID}SDK게임Event게임_더보기_클릭click.layer1: header
4더보기 > 공유하기 클릭SDK_{게임ID}SDK게임Event게임공유하기_클릭click.layer1: header
5더보기 > 문의하기 클릭SDK_{게임ID}SDK게임Event게임문의하기_클릭click.layer1: header
6더보기 > 내 게임 관리 클릭SDK_{게임ID}SDK게임Event내게임관리_클릭click.layer1: header
7상단 닫기 버튼 클릭SDK_{게임ID}SDK게임Event게임_닫기_클릭click.layer1: header
8상단 접기 버튼 클릭SDK_{게임ID}SDK게임Event게임_접기_클릭click.layer1: header · iOS 접기 기능 적용 게임만
9게임 종료 팝업 노출SDK_{게임ID}SDK게임ViewImp게임종료_팝업_노출—
10게임 종료 팝업의 확인 클릭SDK_{게임ID}SDK게임Event게임종료_팝업_확인_클릭—
11게임 종료 팝업의 취소 클릭SDK_{게임ID}SDK게임Event게임종료_팝업_취소_클릭—

SDK 메서드 매핑 규칙은 다음과 같습니다.

  • Pageview → trackPage
  • Event → trackEvent
  • ViewImp → trackViewImp
  • Usage → trackUsage에 usage 정보를 함께 전달

각 메서드의 호출 형태와 page_meta 구성 방법은 게임 로그 전송 방법과 추가 정보 전송 섹션을 참고하세요.

게임플레이 표준 page_meta 값 ​

ActionKind가 ViewContent인 게임 로그(SDK_게임_조회)는 page_meta 세팅이 필수입니다.

파라미터적용게임플레이 표준값
id필수게임 코드 (예: GAME_001)
type권장h5 고정
name권장게임명

세팅 방법은 Page meta를 참고하세요.

참고 문서 ​