콘솔로 이동

Unity로 시작하기

텐투플레이 사용하기

텐투플레이 SDK를 활용하면 데이터 수집과 분석, 개인화된 메시징 기능을 사용할 수 있습니다.

  1. 텐투플레이 SDK를 이용해 데이터 수집하기

    1. 게임 이벤트에 TPStashEvent 클래스의 메소드를 호출합니다.
    2. 클라이언트의 DB에 이벤트 로그가 수집됩니다.
    3. TentuPlay Settings의 Upload Data Interval (sec) 마다 혹은 수동 업로드 메소드 호출시 서버로 통신하여 데이터가 업로드됩니다.
  2. 텐투플레이의 행동 분석 AI 기술을 이용한 데이터 분석

    1. 서버로 업로드된 데이터를 통해 데이터 분석을 진행합니다.
    2. 플레이어마다 개인화된 문구와 아이템 및 상품 추천을 포함하는 우편 내용이 생성됩니다.
    3. 개인화된 문구와 아이템 및 상품 추천을 포함합니다.
  3. 출력 SDK (TentuPlay.CRM)를 이용해 우편 기능 사용하기

    1. TPMentor 클래스의 메소드를 이용하여 각 플레이어에게 맞춤형 우편을 보여줍니다.
    2. TPAdviceTemplates에서 기본으로 제공하는 우편 스크립트와 프리팹에 변경을 가하여 사용할 수 있습니다.

텐투플레이 유니티 패키지 다운로드

유니티용 텐투플레이 SDK를 다운로드 합니다.

Unity 버전 2017 이상(.NET 버전 3.5 Equivalent 이상)을 사용합니다.

텐투플레이 유니티 패키지 불러오기

유니티용 텐투플레이 SDK를 다운로드 합니다. 유니티 에디터에서 메뉴 > Assets > Import Package > Custom Package를 클릭하세요.

다운로드 한 SDK TentuPlay_SDK_v0.26.unitypackage를 선택하고, 열기를 클릭하세요.

_TentuPlaySDKDemo
데모 게임을 이용하여 텐투플레이 SDK 사용법을 익힐 수 있습니다.

TentuPlay
텐투플레이 패키지의 핵심. Dll 파일과 스크립트, 프리팹 등이 들어있습니다.

Plugins
텐투플레이를 실행시키는데에 필요한 3rd party plugins 입니다.

TPAdviceTemplates
텐투플레이 우편 화면에 필요한 스크립트와 프리팹입니다.

Import Unity Package 창에서 Import를 클릭하면 텐투플레이 패키지가 설치됩니다. 설치 후 유니티 에디터 메뉴에 TentuPlay 항목이 생성되며, Assets 폴더 내에 TentuPlay 관련 폴더가 생성됩니다.

TentuPlay Settings 설정하기

텐투플레이 설정은 유니터 에디터에서 하거나 스크립트에서 할 수 있습니다.

유니티 에디터에서 지정하는 방법:

유니티 에디터 메뉴 > TentuPlay > Edit Settings에서 다음과 같이 설정할 수 있습니다.

Api Key: 고객사 회원가입 시 발급되는 고객사 고유값. 텐투플레이 콘솔 - 프로젝트 - 프로젝트 설정 - 일반 설정 - 프로젝트 크레덴셜에서 발급받을 수 있습니다.

Secret: 고객사 회원가입 시 발급되는 고객사 고유값. 텐투플레이 콘솔 - 프로젝트 - 프로젝트 설정 - 일반 설정 - 프로젝트 크레덴셜에서 발급받을 수 있습니다.

Get Client Key: 버튼을 눌러 Client Key를 발급받습니다. Client Key가 있어야 텐투플레이가 정상적으로 작동됩니다.

TentuPlay Debug Mode: 텐투플레이 SDK를 디버그 모드에서 실행하기 위해서는 체크합니다.

Auto Upload: 클라이언트로부터 수집된 데이터를 자동으로 서버에 업로드 하기 위해서는 체크합니다. 데이터를 자동으로 업로드 하기 위해서는 AutoUpload가 체크되어있어야 합니다. Auto Upload가 체크되어있지 않으면 UploadData함수를 호출해야만 데이터가 업로드됩니다.

※ 주의사항: 텐투플레이 함수는 메인 스레드에서만 호출이 가능합니다. 메인 스레드에서 호출이 불가능 할 경우, AutoUpload를 해제하고 TPUploadData를 이용하여 수동으로 업로드해주세요

Upload Interval (sec): 서버 업로드 최소 간격 (기본값 1200초)

Advice Sync Interval (sec): CRM을 사용하는 경우 새로운 Advice를 불러오는 최소 간격 (기본값 600초)

스크립트에서 지정하는 방법:

텐투플레이의 클래스/메소드 호출에 앞서서 가장 먼저 TentuPlaySettings 클래스의 정적필드(static field) 값을 지정하면 TentuPlaySettings.asset 없이도 TentuPlay Setting을 설정할 수 있습니다.

using TentuPlay;
TentuPlaySettings.ClientKey= "MY_CLIENT_KEY";
TentuPlaySettings.DEBUG = true; // 기본 값은 false 입니다. 디버깅 하려면 true라고 해주세요.
TentuPlaySettings.AutoUpload = true; // 기본값은 false 입니다. 수동으로 TPUpload를 부르지 않을 거면 true로 설정해야 합니다.
TentuPlaySettings.DeferredSendIntervalSec = 1200; // 기본값은 1200입니다. 숫자가 작으면 작은 데이터를 자주 올리고, 숫자가 크면 많은 데이터를 가끔 올리게 됩니다.

// 가장 처음으로 호출되는 TentuPlay.Api 혹은 TentuPlay.CRM의 클래스

TentuPlaySettingsEditor 클래스의 CreateClientKey(string apiKey, string secret) 메소드를 이용하여 ClientKey를 불러올 수 있습니다. 이 때 코드 내에 Api Key와 Secret Key를 하드코딩 하지 않도록 주의합니다.

도움이 필요한가요?

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