액션데이터 확인

파트너센터의 게임 > 액션데이터 확인에서 테스트 계정으로 게임을 플레이하며 액션데이터가 정상적으로 전송되는지 실시간으로 확인할 수 있습니다.

심사 체크리스트의 액션데이터 항목을 파트너사 자체 점검으로 확인할 때 사용합니다.

사전 준비 필수

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

항목	준비 내용
게임 등록	파트너센터에 게임 코드를 입력해 게임을 임시저장합니다. 게임 코드가 생성되어야 확인할 게임으로 선택할 수 있으므로, 출시 전 게임도 최소한 임시저장은 해야 합니다.
카카오 로그인	게임 시작 전 사용자를 식별하는 카카오싱크·카카오 로그인을 구현합니다.
액션데이터 전송	액션데이터 API 전송을 구현합니다.

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

확인 항목

자주 확인하는 항목은 아래와 같습니다. 게임마다 전송해야 하는 라벨이 다르므로 전체 목록은 label 매트릭스와 심사 체크리스트에서 확인하세요.

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

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

확인 방법

1단계: 게임 선택

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

2단계: 테스트 계정 입력

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

3단계: 게임 플레이

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

확인 가능 시간

주의사항

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

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

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

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

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

주의사항

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

참고 문서

• 액션데이터 API: 액션데이터 이벤트 스키마와 label 매트릭스
• 심사 체크리스트: 심사 요청 전 액션데이터 자체 점검 항목
• 게임웹뷰 테스트 방법: 카카오톡과 Gameplay 테스트앱에서 게임을 확인하는 방법