---
url: /docs/partner-center/action-data-check.md
description: 게임플레이 파트너센터에서 테스트 계정으로 게임을 플레이하며 액션데이터 전송을 실시간으로 확인하는 방법
---

# 액션데이터 확인

파트너센터의 **게임 > 액션데이터 확인**에서 테스트 계정으로 게임을 플레이하며 액션데이터가 정상적으로 전송되는지 실시간으로 확인할 수 있습니다.
[심사 체크리스트](/docs/checklist/review-checklist#액션데이터)의 액션데이터 항목을 파트너사 자체 점검으로 확인할 때 사용합니다.

## 사전 준비 

액션데이터를 확인하려면 아래 항목을 먼저 준비해야 합니다.
액션데이터는 로그인한 사용자 기준으로 전송되므로, 테스트할 게임 안에 카카오 로그인과 액션데이터 전송이 구현되어 있어야 합니다.

| 항목 | 준비 내용 |
| --- | --- |
| 게임 등록 | 파트너센터에 [게임 코드를 입력해 게임을 임시저장](/docs/partner-center/games#게임-등록)합니다. 게임 코드가 생성되어야 확인할 게임으로 선택할 수 있으므로, 출시 전 게임도 최소한 임시저장은 해야 합니다. |
| 카카오 로그인 | 게임 시작 전 사용자를 식별하는 [카카오싱크·카카오 로그인](/docs/authentication/kakao-login-sync)을 구현합니다. |
| 액션데이터 전송 | [액션데이터 API](/api-sdk/data/action-data) 전송을 구현합니다. |

출시되지 않은 게임은 화이트리스트에 등록한 도메인이라면 [카카오톡 테스트 링크](/docs/webview/test-guide#카카오톡에서-테스트하기)로 실행해 확인할 수 있습니다.
화이트리스트 등록 전이라면 [Gameplay 테스트앱](/docs/webview/test-guide#테스트앱에서-테스트하기)에 게임 URL을 입력해 플레이합니다.
테스트앱은 게임 URL을 카카오톡 게임웹뷰 환경처럼 실행하는 역할만 하며 로그인 기능을 제공하지 않습니다.
테스트 계정에는 게임 안에서 로그인한 카카오계정의 이메일 주소를 입력합니다.

## 확인 항목

자주 확인하는 항목은 아래와 같습니다. 게임마다 전송해야 하는 라벨이 다르므로 전체 목록은 [label 매트릭스](/api-sdk/data/action-data#label-매트릭스)와 [심사 체크리스트](/docs/checklist/review-checklist#액션데이터)에서 확인하세요.

| 항목 | 확인할 내용 |
| --- | --- |
| 필수 라벨 `label` | `Loading`부터 `Exit_Play`까지의 필수 라벨이 모두 전송되는지 확인합니다. 광고를 사용하는 경우 광고 라벨도 함께 확인합니다. |
| 플레이 시간 `play_time` | `Exit_Play`에 `Loading`부터 누적한 플레이 시간이 포함되는지 확인합니다. |
| 랭킹 기록 `action_data` | 랭킹을 사용하는 경우 `Complete_Play`에 기록값이 포함되는지 확인합니다. |
| 랭킹 지표 이름 `action_data` 키 | 파트너센터에 설정한 랭킹 지표 유형의 영문 값과 일치하는지 확인합니다. 예를 들어 지표 유형이 점수라면 키는 `SCORE`입니다. 지표 유형별 값은 [랭킹 데이터 스펙](/api-sdk/data/ranking#metrics)을 참고하세요. |
| 대전 모드 정보 `pvp_data` | 대전 모드를 제공하는 경우 대전 진입 시점마다 `Pvp_Start`에 `pvp_data`가 포함되는지 확인합니다. |

Tiara Web SDK 설정은 액션데이터 확인에서 볼 수 없습니다.
[심사 체크리스트의 게임 로그](/docs/checklist/review-checklist#게임-로그) 항목을 참고해 별도로 확인하세요.

## 확인 방법

### 1단계: 게임 선택

**게임 > 액션데이터 확인**의 **액션데이터 확인 설정**에서 게임 상태를 고른 뒤 확인할 게임을 선택합니다.

### 2단계: 테스트 계정 입력

게임을 플레이할 카카오계정의 이메일 주소를 입력하고 **확인**을 선택합니다.

### 3단계: 게임 플레이

테스트 계정으로 게임에 로그인해 플레이합니다.
전송된 액션데이터는 화면 하단에 실시간으로 표시되며, 수신 건수로 진행 상황을 확인할 수 있습니다.

## 확인 가능 시간

::: warning 주의사항
보안을 위해 **확인**을 선택한 시점부터 최대 5분 동안만 액션데이터를 확인할 수 있습니다.
**확인**을 선택하기 전에 전송한 액션데이터는 표시되지 않습니다.
5분이 지난 뒤 이어서 확인하려면 **확인**을 다시 선택하세요.
**확인**을 다시 선택하면 이전에 받은 액션데이터 목록은 지워집니다.
:::

## 액션데이터가 표시되지 않는 경우

게임을 플레이했는데 액션데이터가 표시되지 않으면 아래 항목을 먼저 확인하세요.

| 확인할 곳 | 확인할 내용 |
| --- | --- |
| 확인 시간 | **확인**을 선택한 뒤 5분 안에 플레이했는지 확인합니다. 시간이 지났다면 **확인**을 다시 선택하고 플레이합니다. |
| 게임·테스트 계정 | 선택한 게임과 실제로 플레이한 게임이 같은지, 입력한 이메일 주소가 게임 안에서 로그인한 카카오계정과 같은지 확인합니다. |
| 테스트 계정 확인 안내 | "해당 이메일로 테스트 계정을 확인할 수 없습니다"가 표시되면 다른 카카오계정으로 다시 시도합니다. 다른 회사의 파트너센터 관리자 계정과 비활성 관리자 계정은 테스트 계정으로 사용할 수 없습니다. |
| `game_id` | 전송하는 `game_id`가 파트너센터에 등록한 게임 코드와 일치하는지 확인합니다. |
| API 응답 | [액션데이터 API](/api-sdk/data/action-data#단건-전달) 응답의 `error_code`·`error_message`를 확인합니다. |

위 항목을 확인해도 표시되지 않는다면 [카카오디벨로퍼스 데브톡](https://devtalk.kakao.com/c/game-play/353)으로 문의하세요.
액션데이터 확인에서는 액션데이터가 수신되지 않은 상세 원인을 확인할 수 없어 카카오 담당자가 원인을 확인합니다.
문의할 때는 `game_id`, 테스트한 시각, 전송한 `label`과 `log_id`, API 응답을 함께 알려주세요.

::: warning 주의사항
데브톡은 공개 게시판입니다.
테스트 계정의 이메일 주소 등 개인정보는 게시글에 적지 마세요.
:::

## 참고 문서

* [액션데이터 API](/api-sdk/data/action-data): 액션데이터 이벤트 스키마와 label 매트릭스
* [심사 체크리스트](/docs/checklist/review-checklist#액션데이터): 심사 요청 전 액션데이터 자체 점검 항목
* [게임웹뷰 테스트 방법](/docs/webview/test-guide): 카카오톡과 Gameplay 테스트앱에서 게임을 확인하는 방법