--- url: /api-sdk/sdk/tiara-game-logs.md description: Tiara Web SDK로 구현하는 필수 게임 로그 11종과 필수 세팅 항목, 표준 page_meta 값 --- # 게임 로그 설정 게임플레이 JS SDK를 사용하지 않는 게임에서 Tiara Web SDK로 구현해야 하는 필수 게임 로그를 안내합니다. SDK 설치와 메서드 사용법은 [Tiara Web SDK](/api-sdk/sdk/tiara-web)를 참고하세요. ::: tip 게임플레이 JS SDK를 쓰는 게임 **이 문서의 구현은 필요하지 않습니다.** SDK가 게임 로그를 대신 보냅니다. 액션명도 SDK 전용 명세를 쓰므로 아래 표와 다릅니다. 자세한 내용은 [전체 메서드: 게임 로그](/api-sdk/sdk/gameplay-js/reference#게임-로그)을 참고하세요. ::: ## 필수 세팅 항목 게임플레이 JS SDK를 사용하지 않는 게임에서 Tiara Web SDK를 직접 적용할 때 다음 4가지를 반드시 설정해야 합니다. | # | 항목 | 값 / 방법 | | --- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | | 1 | 서비스 도메인 (svcDomain) | gameplay.kakao.com 고정. 별도 신규 신청은 필요하지 않습니다 | | 2 | 제3자 정보 제공 동의 (thirdProvideAgree) | true 고정. 게임플레이 진입 시 제3자 제공 동의를 필수로 수령합니다. 설정 방법은 [제3자 동의 여부 세팅](/api-sdk/sdk/tiara-web#제3자-동의-여부-세팅)을 참고하세요 | | 3 | 필수 게임 로그 11종 | 아래 [게임 로그 정의](#게임-로그-정의)에 정의된 11종의 게임 로그를 Tiara Web SDK 가이드의 trackPage / trackEvent / trackViewImp / trackUsage 메서드로 구현합니다 | | 4 | 카카오 사용자 식별값 (AccessToken 또는 AppUserId) | 두 방식 중 하나로 필수 세팅. 미세팅 시 카카오 분석 환경에서 게임 로그를 집계·활용할 수 없습니다. 설정 방법은 [AccessToken / AppUserId](/api-sdk/sdk/tiara-web#accesstoken-appuserid)를 참고하세요 | svcDomain은 모든 입점 파트너사가 동일하게 `gameplay.kakao.com` 값을 사용합니다. 파트너사·게임 구분은 게임플레이 파트너센터에 등록한 게임 코드로 처리합니다. ## 게임 로그 정의 게임플레이 입점 파트너사가 필수로 구현하는 게임 로그 11종입니다. 이 가이드의 메서드(`trackPage` · `trackEvent` · `trackViewImp` · `trackUsage`)로 구현하며, `{게임ID}`는 게임플레이 파트너센터에 등록한 게임 코드를 그대로 사용합니다. 메타데이터 API로 게임을 등록했던 파트너사는 그 `code` 값을 사용합니다. 게임 이름이나 공백은 사용할 수 없습니다. ::: tip 게임플레이 JS SDK 를 쓴다면 이 표가 아닙니다 아래 값은 **직접 연동하는 게임용**입니다. [게임플레이 JS SDK](/api-sdk/sdk/gameplay-js/)는 `section` · `page` · 액션명이 모두 다릅니다 — 두 경로의 로그를 분석 단계에서 가를 수 있어야 하기 때문입니다. | | 직접 연동 (이 표) | 게임플레이 JS SDK | | --- | --- | --- | | `Section` | `SDK_{게임ID}` | `sdk_ui_{게임ID}` | | `Page` | `SDK게임` | `SDK_UI` | | `Name` | 아래 표 | `SDK_UI_` 접두어로 통일 | ::: | # | 발생 시점 | Section | Page | Type | Name | 비고 | | --- | --- | --- | --- | --- | --- | --- | | 1 | 게임 페이지 진입 | `SDK_{게임ID}` | `SDK게임` | `Pageview` | `SDK_게임_조회` | `actionKind: ViewContent` · `page_meta` 세팅 필수(`id` 필수) | | 2 | 게임 체류시간 수집 | `SDK_{게임ID}` | `SDK게임` | `Usage` | `SDK_게임_체류시간` | `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` 구성 방법은 [게임 로그 전송 방법](/api-sdk/sdk/tiara-web#게임-로그-전송-방법)과 [추가 정보 전송](/api-sdk/sdk/tiara-web#추가-정보-전송) 섹션을 참고하세요. ## 게임플레이 표준 page\_meta 값 ActionKind가 `ViewContent`인 게임 로그(`SDK_게임_조회`)는 `page_meta` 세팅이 필수입니다. | 파라미터 | 적용 | 게임플레이 표준값 | | --- | --- | --- | | id | 필수 | 게임 코드 (예: GAME\_001) | | type | 권장 | h5 고정 | | name | 권장 | 게임명 | 세팅 방법은 [Page meta](/api-sdk/sdk/tiara-web#page-meta)를 참고하세요. ## 참고 문서 * [Tiara Web SDK](/api-sdk/sdk/tiara-web): SDK 설치·초기화와 메서드 사용법 * [데이터 샘플 카탈로그](/api-sdk/data/samples#액션데이터-샘플): 액션데이터 요청 본문 샘플 * 기술 문의: [카카오디벨로퍼스 데브톡](https://devtalk.kakao.com/c/game-play/353)