# 게임플레이 파트너 가이드

> 카카오톡 게임플레이 입점 파트너사를 위한 연동 가이드·API·SDK 문서입니다.
> 게임웹뷰 SDK, 메타데이터·액션데이터 API, 광고, 공유 콜백 연동 스펙을 다룹니다.

- 전체 문서 전문: [llms-full.txt](https://gameplay-partners.kakao.com/llms-full.txt)
- 기술 문의: https://devtalk.kakao.com/c/game-play/353

### 시작하기

- [입점 안내](/docs/checklist/start-guide.md): 게임플레이 입점 구조와 파트너사가 준비해야 하는 연동 작업 안내
- [게임 실행 흐름](/docs/webview/launch-flow.md): 게임웹뷰 진입부터 게임 실행까지의 동선 안내
- [심사 가이드](/docs/checklist/review-guide.md): 신규 게임의 출시 심사와 출시 게임의 업데이트 심사 요청·진행·배포 일정

#### 심사 가이드

- [심사 체크리스트](/docs/checklist/review-checklist.md): 출시·업데이트 심사를 요청하기 전에 파트너사가 확인해야 하는 자체 점검 항목

### 인증

- [카카오싱크 설정](/docs/authentication/kakao-login-sync.md): 게임플레이 입점 파트너사가 카카오싱크 간편가입을 사용하기 위한 앱·채널·동의항목·서비스 약관 설정 방법

### 게임웹뷰

- [게임웹뷰 테스트 방법](/docs/webview/test-guide.md): 화이트리스트 도메인이 카카오톡 게임웹뷰로 정상 실행되는지 확인하는 방법
- [디바이스 구분 방법](/docs/webview/device-detection.md): 게임웹뷰에서 iOS · Android · 태블릿을 구분하는 방법과 판정 규칙
- [상태바 오버레이 설정 방법](/docs/webview/status-bar-overlay.md): 게임웹뷰 오버레이 상태가 페이지 이동 후에도 유지되는 문제와 대응 방법

### 디자인 가이드

- [게임 공통 제작 가이드](/docs/design/common-guide.md): 게임플레이 디자인에 공통으로 적용하는 해상도·타이포그래피·컬러·태블릿 대응 기준
- [게임 콘텐츠 제작 가이드](/docs/design/content-image-guide.md): 게임플레이에 노출되는 앱 아이콘·가로형·세로형·공유 이미지와 동영상 제작 기준
- [웹뷰 컴포넌트 가이드](/docs/design/webview-component-guide.md): 게임웹뷰에 적용하는 상태바·내비게이션·킵버튼·메뉴·로딩·팝업 UI 기준

### 공유

- [공유 설정](/docs/share/settings.md): 카카오 JS SDK 기반 카카오톡 공유·URL 복사 연동 방법

### 광고

- [광고 상품 소개](/docs/ads/product-overview.md): 카카오톡 게임플레이에서 지원하는 애드핏 리워드·전면형 광고 상품 안내
- [광고 UX 가이드](/docs/ads/ux-guideline.md): 게임웹뷰 안에서 애드핏 보상형·전면형 광고를 운영할 때 지켜야 하는 UX 기준
- [애드핏 설정](/docs/ads/iaa-options.md): 애드핏 매체 등록과 리워드·전면형 광고단위 발급 및 운영 설정 방법

#### 애드핏 설정

- [리워드 광고단위 설정](/docs/ads/adfit-reward-adunit.md): 애드핏 리워드 광고단위 생성과 유형 및 부가 옵션 설정 방법
- [전면형 광고단위 설정](/docs/ads/adfit-interstitial-adunit.md): 애드핏 전면형 광고단위 생성과 유형 및 부가 옵션 설정 방법
- [대체·테스트 광고 설정](/docs/ads/adfit-fallback-test.md): 애드핏 리워드 대체 광고 등록과 실소재 노출 중단을 이용한 개발 테스트 방법
- [민감 카테고리 차단 설정](/docs/ads/adfit-sensitive-categories.md): 카카오톡 Android·iOS 애드핏 매체에서 차단해야 하는 민감 광고 카테고리

### 운영 정책

- [운영 원칙](/docs/policy/overview.md): 카카오톡 게임플레이 운영 원칙 안내
- [입점 정책](/docs/policy/onboarding.md): 게임플레이 입점 정책 안내
- [출시 및 업데이트 정책](/docs/policy/launch.md): 신규 게임의 출시 심사와 출시 게임의 업데이트 심사 기준
- [데이터 보호 정책](/docs/policy/implementation.md): 기술 구현, 개인정보·보안, 이용자 데이터 관리에 관한 파트너사 준수 기준 정책

### 서비스 정책

- [서비스 운영](/docs/policy/operations.md): 게임 노출, 업데이트, CS, 장애·점검, 지표 모니터링, 광고 운영, 서비스 종료에 관한 파트너사 준수 기준
- [PR 및 대외 커뮤니케이션](/docs/policy/pr.md): 게임플레이 관련 보도자료, 기사, 인터뷰 등 대외 커뮤니케이션 가이드
- [정산](/docs/policy/settlement.md): 광고 매출 수익 배분 및 정산 절차

### 개요

- [API & SDK 개요](/api-sdk.md): 게임플레이 연동에 사용하는 SDK와 API 전체 목록
- [SDK 연동 방식 선택](/api-sdk/sdk.md): 게임플레이 JS SDK 와 개별 SDK 직접 연동 중 하나를 고르는 기준과 마이그레이션 안내

### 게임플레이 JS SDK <span class="gp-sidebar-mark gp-sidebar-mark--beta">BETA</span>

- [게임플레이 JS SDK 시작하기](/api-sdk/sdk/gameplay-js/getting-started.md): 게임플레이 JS SDK 의 사전 준비와 설치, 초기화 방법
- [게임플레이 JS SDK 다운로드](/api-sdk/sdk/gameplay-js/download.md): 게임플레이 JS SDK 의 CDN 주소와 버전별 integrity 값, TypeScript 선언 파일
- [게임플레이 JS SDK 레퍼런스](/api-sdk/sdk/gameplay-js/reference.md): Gameplay 객체가 제공하는 메서드와 에러 코드 전체 명세
- [게임플레이 JS SDK UI](/api-sdk/sdk/gameplay-js/ui.md): managed UI 5개 컴포넌트의 옵션과 표시 정책

### 개별 SDK 직접 연동

- [게임웹뷰 SDK](/api-sdk/sdk/kakaotalk-gameplay.md): 카카오톡 게임웹뷰 환경의 공통 스펙과 window.kakaotalkGamePlay JavaScript 인터페이스
- [애드핏 광고 SDK](/api-sdk/sdk/adfit.md): 애드핏 전면 광고·보상형 전면 광고 SDK 의 설치·인스턴스 생성·노출 제어·이벤트 스펙
- [카카오 JS SDK](/api-sdk/sdk/kakao-js.md): 게임플레이 파트너사가 카카오 로그인·카카오싱크와 카카오톡 공유를 연동하기 위한 카카오 JS SDK 설치와 초기화
- [Tiara Web SDK](/api-sdk/sdk/tiara-web.md): Tiara Web SDK로 게임 로그(Pageview, Event 등)를 수집·전송하는 방법

#### Tiara Web SDK

- [게임 로그 설정](/api-sdk/sdk/tiara-game-logs.md): Tiara Web SDK로 구현하는 필수 게임 로그 11종과 필수 세팅 항목, 표준 page_meta 값

### API 레퍼런스

#### 디벨로퍼스

- [카카오싱크 API](/api-sdk/kakaosync/rest-api.md): 게임웹뷰 진입 시 카카오싱크 간편가입과 자동 로그인을 구현하는 REST API 요청·응답 스펙
- [친구 목록 조회 API](/api-sdk/kakaotalk-social/friends.md): 친구 목록 API와 친구 피커의 선택 기준 및 카카오톡 친구 목록 조회 REST API 핵심 스펙
- [공유 웹훅 연동](/api-sdk/share/reward-result.md): 카카오톡 공유 발생 후 카카오디벨로퍼스 연동으로 보상 가능 여부 판정 참고 데이터를 수신하는 방식 안내
- [계정 상태 변경 웹훅 연동](/api-sdk/data/terms-withdrawal.md): 카카오 로그인 계정 상태 변경 웹훅으로 사용자의 동의 철회·연결 해제 이벤트를 수신해 데이터 파기를 처리하는 가이드
- [사용자 닉네임 목록 조회 API](/api-sdk/data/user-nicknames.md): 파트너사가 회원번호 목록으로 게임플레이 프로필 닉네임을 일괄 조회하는 API

#### 광고

- [CP별 리포트 API](/api-sdk/ads/cp-report.md): 채널별 CP(Content Provider) 보고서를 조회하는 애드핏 External API

#### 공유

- [단축 URL 생성](/api-sdk/share/short-url.md): 카카오톡 공유 SDK 호출 전에 공유용 단축 URL을 발급하는 API

#### 데이터

- [메타데이터 API (사용 중지 예정)](/api-sdk/data/metadata.md): 게임플레이 파트너센터 오픈과 함께 사용이 중지되는 게임 메타 정보 API와 랭킹 데이터 스펙
- [액션데이터 API](/api-sdk/data/action-data.md): 사용자별 게임 액션데이터 단건·일괄 전송 API
- [데이터 샘플 카탈로그](/api-sdk/data/samples.md): 액션데이터 API와 사용 중지 예정인 메타데이터 API 요청 본문 샘플 모음
- [동의 철회·연결 해제 웹훅 (디벨로퍼스 마이그레이션 가이드)](/api-sdk/data/terms-withdrawal-migration.md): 기존 약관 동의 철회 통지 API를 카카오 로그인 계정 상태 변경 웹훅으로 전환하기 위한 마이그레이션 전용 가이드

### Other

- [게임 URL 접근 분기 안내](/docs/design/bridge-guide.md): 게임 실행 흐름으로 이동한 PC·모바일 웹 직접 접근 분기 안내
- [디자인 가이드](/docs/webview/design-guide.md): 세분화된 게임플레이 디자인 가이드 페이지 안내
- [릴리즈 노트](/release-notes.md): 게임플레이 파트너 가이드의 제품·API·SDK 변경 이력