데이터 수집하기

데이터 수집이란 로그인이나 재화 획득과 같이 게임내에서 플레이어가 하는 행동에 대한 정보를 수집하는 과정을 말합니다. 데이터 수집은 클라이언트에서 이루어지며 SDK 내 게임 스크립트에 심겨진 관련 메소드들을 호출함으로써 수행됩니다. 수집된 데이터는 데이터 분석의 근거가 되며 이로부터 개인화 오퍼나 AI 인게임 상점 오퍼가 생성됩니다.

이후 데이터 수집에 대한 설명은 신궁 데모 게임이 포함된 SDK를 설치했다는 가정 하에 진행됩니다.

참고 스크립트 찾아보기

데이터 수집에 필요한 메소드의 대부분은 TPStashEvent 클래스에 들어 있습니다. TPStashEvent의 실제 구현 예를 보려면 Player.cs를 참고하십시오. Player.cs는 ShelterScene의 Player 게임 오브젝트 컴포넌트 스크립트로서 Assets/ShingGoongDemo/Scripts/TentuplayRelated/ 경로에 있습니다.

ShelterScene location1
폴더 내 ShelterScene의 위치
ShelterScene location2
ShelterScene내 Player 게임 오브젝트
ShelterScene location3
Player 게임 오브젝트 내 Player 스크립트 컴포넌트

수집 메소드 사용하기

데이터가 수집되도록 하려면 TPStashEvent 클래스 내에서 각 게임 이벤트에 맞는 메소드를 호출해야 합니다.

대표적인 게임 이벤트로 등록(join)과 로그인(login)이 있습니다. 아래 예시 스크립트는 텐투플레이를 초기화하고 신규 가입과 로그인을 수집하도록 메소드를 작성할 수 있는지 보여주고 있습니다. 이렇게 이벤트별로 한 줄의 코드를 작성함으로써 데이터를 기록할 수 있습니다.

등록 및 로그인 이벤트 수집을 위한 메소드 작성 예시
using UnityEngine;
using TentuPlay;
using TentuPlay.Api; // 데이터를 수집하거나 업로드 하기 위해 TentuPlay.Api 를 가져옵니다. TpStashEvent를 사용하는 스크립트에는 모두 필요합니다.
using UnityEngine.UI;

public class ExampleJoinScript : MonoBehaviour
{
    // 텐투플레이 로그 기록에 사용되는 변수를 정의합니다.
    private string player_uuid = "TentuTestPlayer";  // player_uuid 는 게임 사용자를 고유하게 식별하는 값입니다.

    // 첫 프레임 업데이트 전에 Start를 호출합니다.
    void Start()
    {
        // 텐투플레이를 초기화합니다.
        TPStashEvent myStashEvent = new TPStashEvent();

        // 신규 가입 이벤트를 호출할 때 텐투플레이 Join 이벤트를 기록합니다.
        myStashEvent.Join(player_uuid : player_uuid);

        // 유저의 로그인 이벤트를 호출할 때 텐투플레이 Login 이벤트를 기록합니다.
        myStashEvent.PlayerLogin(player_uuid : player_uuid,
            app_version : "1.0"  // 기본값은 null입니다. 게임 클라이언트의 버전을 기록합니다(optional)
            );

    }

}

데이터 업로드에 성공할 경우, 아래와 같이 유니티 에디터 콘솔에 로그가 기록됩니다.

check uploads

그 외 자세한 메소드는 참조문서를 참고해주세요.

도움이 필요한가요?

궁금한 것이 있으신가요? 텐투플레이 디스코드에서 바로 문의주세요.