Game Report SDK 및 Method

Classic/VPC 환경에서 이용 가능합니다.

Game Report 서비스를 사용하기 위한 분석/로그 수집 플랫폼 기술과 관련된 SDK를 제공합니다.

이 활동에는 다음과 같은 하위 작업이 포함됩니다.

• Think Core 게임 분석 서비스
• Lib Core 게임 로그 제공 서비스

기본 용어

Game Report SDK 구성 시 알아야 할 용어와 용어에 대한 설명은 다음과 같습니다.

개발 환경 구성

SDK 다운로드

개발 환경 구성에 필요한 SDK 파일은 Service Center에서 다운로드할 수 있습니다. 자세한 내용은 Service Center의 SDK 다운로드를 참고해 주십시오.

UNREAL

플러그인 설치 및 설정

UNREAL 엔진 에디터에 플러그인 설치 및 설정하는 방법은 다음과 같습니다.

1. UNREAL 엔진 에디터를 실행한 후 플러그인을 설치할 프로젝트의 Plugins 폴더를 열어 주십시오.
2. 다운로드한 SDK의 'Unreal' 폴더에 있는 SDK 파일을 Plugins 폴더에 복사하여 압축을 풀어 주십시오.
3. UNREAL 엔진 에디터를 재실행한 후 셋팅 > 플러그인 > 프로젝트 > Other를 차례대로 클릭해 주십시오.
4. StorageCoreSDKPlugin의 활성화 체크 박스를 선택한 후 UNREAL 엔진 에디터를 재실행해 주십시오.

SDK 초기화

앱을 처음 실행하는 경우 블루프린트 등을 사용하여 SDK를 초기화해야 합니다.
또는 직접 StorageCoreSdk에 접근하여 C++코드로 SDK를 초기화할 수도 있습니다.

블루프린트로 SDK를 초기화하는 방법은 다음과 같습니다.

1. 블루프린트를 실행해 주십시오.
2. 아래 표를 참고하여 기본 정보를 입력한 후 초기화해 주십시오.

입력해야 할 기본 정보는 다음과 같습니다.

• String은 특수문자 포함 100자 이내로 입력해야 합니다.
• Member ID(계정ID)와 Nick Name(닉네임)은 게임 유저 정보에 따라 별도 설정해야 합니다.
• 'Proguard'를 사용하는 경우 아래와 같이 SDK 예외처리를 해야 합니다.
  • Proguard 파일 위치: 게임프로젝트\Build\Android\proguard-project.txt
  • 예외처리 명령어

    keep class com.coresight.storagecoresdk.** { *; }
    dontwarn com.coresight.storagecoresdk.**
    

Unity3D

플러그인 설치 및 설정

1. Unity 3D를 실행한 후 플러그인을 설치할 프로젝트를 열어 주십시오.
2. Unity 메뉴에서 Assets > Import Package > Custom Package를 클릭해 주십시오.
3. 다운로드한 SDK의 'Unity' 폴더에 있는 StorageCoreUnityPlugin.unitypackage 파일을 선택한 후 [Import] 버튼을 클릭해 주십시오.
4. 첫 번째 Scene Hierarchy에 Plugin/StorageCoreManager.prefab을 끌어다 놓아 주십시오.
5. StorageCoreManager GameObject를 선택한 후 Inspector 창에서 아래 표를 참고하여 기본 사용 환경을 설정해 주십시오.

입력해야 할 기본 정보는 다음과 같습니다.

• Member ID(계정ID)와 Nick Name(닉네임)은 게임 유저 정보에 따라 별도 설정해야 합니다.
• StorageCoreSample 폴더 내의 Sample.scene에서 샘플 프로젝트를 확인할 수 있습니다.

• 'Proguard'를 사용하는 경우 아래와 같이 SDK 예외처리를 해야 합니다.
  • Proguard 파일 위치: Assets/Plugins/Android/proguard-user.txt
  • 예외 처리 명령어

  keep class com.coresight.storagecoresdk.** { *; }
  dontwarn com.coresight.storagecoresdk.**
  

• 'Custom Gradle Template'을 사용하는 경우 아래와 같이 내용을 추가해야 합니다.
  • mainTemplate.gradle 파일 위치: Assets/Plugins/Android/mainTemplate.gradle
  • 추가해야 하는 내용

  dependencies {
  implementation fileTree(dir: 'libs', include: ['*.jar'])
  ……………
  
  // 아래의 implementation만 추가 하면 됩니다.
  implementation 'com.android.installreferrer:installreferrer:1.0'
  
  …………….
  **DEPS**
  }
  

iOS Native

플러그인 설치 및 설정

1. 다운로드한 SDK의 'iOS' 폴더에 있는 StorageCoreSdk.framework와 strip-frameworks.sh를 Xcode 프로젝트 파일(.xcodeproj)이 있는 폴더로 복사해 주십시오.
2. Xcode 프로젝트 설정 메뉴에서 아래의 방법으로 StorageCoreSdk.framework와 strip-frameworks.sh를 설정해 주십시오.

• StorageCoreSdk.framework 설치

1. Xcode 프로젝트 설정 메뉴에서 General을 클릭한 후 'Embedded Binaries' 영역에 있는 + 버튼을 클릭해 주십시오.
2. Add Other 버튼을 클릭해 프로젝트 폴더로 복사한 'StorageCoreSdk.framework'를 추가해 주십시오.
3. 'Embedded Binaries' 영역에 'StorageCoreSdk.framework'가 추가되었는지 확인해 주십시오.

• SystemConfiguration.framework 설치
  'StorageCoreSdk.framework'를 설치하는 동일한 방법으로 Xcode 프로젝트 설정에서 General를 클릭한 후 'Linked Frameworks and Libraries' 영역에 'SystemConfiguration.framework'을 추가해 주십시오.

• strip-frameworks.sh 설정
  제공되는 Storage Core SDK Framework는 Device와 Simulator에서 모두 이용할 수 있는 Fat 형태로, 빌드 시 strip 과정을 거쳐야 합니다.
  strip 과정은 제공되는 쉘 스크립트를 Post Build에 설정하면 됩니다.

1. Xcode 프로젝트 설정에서 Build Phases 클릭해 주십시오.
2. 왼쪽 위에 있는 + 버튼을 클릭한 후 New Run Script Phase를 선택해 Run Script를 추가해 주십시오.
3. 추가된 Run Script에 아래 표를 참고하여 프로젝트 폴더로 복사한 strip-frameworks.sh를 실행하는 스크립트를 작성해 주십시오.

입력해야 할 기본 정보는 다음과 같습니다.

• String은 특수문자 포함 100자 이내로 입력해야 합니다.
• Member ID(계정ID)와 Nick Name(닉네임)은 게임 유저 정보에 따라 별도 설정해야 합니다.

SDK 초기화

앱을 처음 실행하는 경우 SDK를 초기화해야 합니다.

• 라이브러리를 사용하기 위해 다음과 같이 import 명령어로 헤더 파일을 가져와 주십시오.

#import <StorageCoreSdk/StorageCoreManager.h>

• ViewController.m > viewDidLoad 함수에서 다음과 같이 initSDK 함수를 호출해 주십시오.

    [StorageCoreManager initSDK:@"https://storagecore.gamereport.naverncp.com" authKey:@"YWtoaWw6YWtoaWw=" gameVersion:@"1.0" channelCode:@"GOOGLE" channelID:@"media_account@gmail.com" memberID:@"testuserid01" charID:@"TestCharID" nickName:@"testnickname01"];

Cocos2d-x

플러그인 설치 및 설정

1. Wrapper 소스 코드 복사를 위해 다운로드한 SDK의 'Cocos2d-x' 폴더에 있는 'StorageCoreSdk.zip' 압축 파일을 푼 후 StorageCoreSdk 폴더를 Cocos2d-x 프로젝트 파일 폴더/Classes로 복사해 주십시오.
2. Cocos2d-x 프로젝트 폴더/Classes/StorageCoreSdk 폴더를 드래그하여 Xcode 또는 Visual Studio 프로젝트에 추가한 후 아래 표를 참고하여 기본 사용 환경을 설정해 주십시오.

입력해야 할 기본 정보는 다음과 같습니다.

• String은 특수문자 포함 100자 이내로 입력해야 합니다.
• Member ID(계정ID)와 Nick Name(닉네임)은 게임 유저 정보에 따라 별도 설정해야 합니다.

SDK 초기화

앱을 처음 실행하는 경우 SDK를 초기화해야 합니다.

• 라이브러리를 사용하기 위해 다음과 같이 include 명령어로 헤더 파일을 포함시켜 주십시오.

  #include "StorageCoreWrapper.h"
  

• 최초 시작하는 Scene의 init 함수에서 다음과 같이 initSDK 함수를 호출해 주십시오.

  StorageCoreWrapper::initSDK("https://storagecore.gamereport.naverncp.com", "YWtoaWw6YWtoaWw=", "1.0", "GOOGLE", "media_account@gmail.com", "testuserid01", "TestCharID", "testnickname01");
  

Android Native

플러그인 설치 및 설정

1. 다운로드한 SDK의 'Android' 폴더에 있는 StorageCoreSdk.jar와 gson-2.8.4.jar를 Android Studio 프로젝트 폴더/app/libs로 복사해 주십시오.

2. dependencies 설정을 위해 build.gradle에 다음과 같이 설정해 주십시오.

   dependencies {
       implementation fileTree(dir: 'libs', include: ['*.jar'])
       implementation files('libs/gson-2.8.4.jar')
       implementation files('libs/StorageCoreSdk.jar')
       implementation 'com.android.installreferrer:installreferrer:1.0'
    }
   

3. AndroidManifest.xml에 아래 코드 및 표를 참고하여 기본 사용 환경을 설정해 주십시오.

   • 퍼미션 추가

   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
   <uses-permission android:name="android.permission.INTERNET" />
   

입력해야 할 기본 정보는 다음과 같습니다.

• String은 특수문자 포함 100자 이내로 입력해야 합니다.
• Member ID(계정ID)와 Nick Name(닉네임)은 게임 유저 정보에 따라 별도 설정해야 합니다.

SDK 초기화

앱을 처음 실행하는 경우 SDK를 초기화해야 합니다.

• 라이브러리를 사용하기 위해 다음과 같이 import 명령어로 파일을 가져와 주십시오.

  import com.coresight.storagecoresdk.StorageCoreManager;
  import com.coresight.storagecoresdk.StorageCoreApi;
  import com.coresight.storagecoresdk.Models.Enums.*;
  

• MainActivity > onCreate 함수에서 다음과 같이 initSDK 함수를 호출해 주십시오.

  StorageCoreManager.initSDK(this, "https://storagecore.gamereport.naverncp.com", "YWtoaWw6YWtoaWw=", "1.0", "GOOGLE", "media_account@gmail.com", "testuserid01", "TestCharID", "testnickname01");
  

SDK Method 개요

클래스

• public class StorageCoreManager
  • 게임 로그를 Coresight StorageCore로 전송

StorageCoreApi 생성자

• 데이터 전달을 위한 기본 생성자
• 기본 정보를 파라미터로 객체를 생성

Syntax

StorageCoreApi(string Url, string AuthKey, string TargetVer, string ChannelCode, string ChannelID, string MemberID, string CharID, string NickName).
// Example
m_api = new StorageCoreApi(serverIp, authKey, gameVersion, channelCode, channelID, memberID, charID, nickName);

Parameters

SDK Method 요약

• SetAccountLevel

  • 유저의 레벨이 성장할 때 호출하여 캐릭터의 레벨 정보를 갱신
  주의

  캐릭터 레벨의 변경이 아닌 계정 레벨의 변경을 의미합니다. 하나의 계정에서 여러 개의 캐릭터를 사용할 때 ResourceChangeInfo를 통해서 변경합니다. 단, 계정과 캐릭터가 1 대 1 매핑일 경우에는 사용해도 무방합니다.

  public void SetAccountLevel(int AccountLevel)
  
  /* SampleCode */ 
  // 50레벨로 설정
  StorageCoreManager.GetInstance().GetApi().SetAccountLevel(50);
  

• SetCharacterID

  • 게임 중 유저가 사용하고 있는 캐릭터를 보유 중인 다른 캐릭터로 변경

  public void SetCharacterID(string CharacterID)
  
  /* SampleCode */ 
  // 사용하는 캐릭터 "7777777"로 변경
  StorageCoreManager.GetInstance().GetApi().SetCharacterID("77777777");
  

• SetMemberID

  • 유저의 회원 아이디 설정
  • 최초 GameReport Instance 생성 시 생성자를 통해 MemberID를 넣을 수 없는 경우 사용
    • 예) 게임 첫 실행 시 MemberID가 없을 때 Empty로 GameReport Instance하고 계정 발급 후에 MemberID를 설정
  주의

  MemberID는 사용자별로 고유한 것을 사용해야 합니다. 그렇지 않으면 지표가 부정확해질 수 있습니다.

  public void SetMemberID(string MemberID)
  
  /* SampleCode */
  // 계정 아이디를 "MID0000007"로 설정
  StorageCoreManager.GetInstance().GetApi().SetMemberID("MID0000007");
  

• SetNickName

  • 유저의 NickName 설정
    • 예) 게임 첫 실행 시 닉네임이 없을 때 Empty로 GameReport Instance하고 계정 발급 후에 NickName을 설정
    • 닉네임 쿠폰을 사용하여 닉네임을 변경할 때 사용

  public void SetNickName(string NickName)
  
  /* SampleCode */ 
  // 닉네임을 "타노스"로 설정
  StorageCoreManager.GetInstance().GetApi().SetNickName("타노스");
  

• SetChannelID

  • 게임 앱  설치 시 사용한 채널사(애플스토어, 구글스토어, 원스토어 등)에서 발급하는 ID 정보 설정
  • 게임 서비스 채널의 아이디를 변경할 때 사용하여 ChannelID를 갱신

  public void SetChannelID(string ChannelID)
  
  /* SampleCode */ 
  // 채널 아이디를 "0000001234567"로 설정
  StorageCoreManager.GetInstance().GetApi().SetChannelID("0000001234567");
  

• SetChannelCode

  • 스토어의 이름인 게임 서비스 채널 코드 설정
    • 예) iOS, AOS, Onestore 등의 스토어 이름을 설정

  public void SetChannelCode(string ChannelCode)
  
  /* SampleCode */ 
  // 채널 코드를 "GOOGLE"로 설정합니다.
  StorageCoreManager.GetInstance().GetApi().SetChannelCode("GOOGLE");
  

• GetInstance

  • StorageCoreManager 객체 초기화

• ConnectInfos Log

  • 사용자의 게임 로그인/로그아웃 로그를 전송하고 성과를 분석
  • 사용자의 게임 콘텐츠(스테이지, 던전, PVP, 상점 등) 진입/이탈 로그를 전송하고 성과를 분석

• ContentActInfos

  • 사용자가 게임 콘텐츠를 수행 완료 시점에 다양한 로그를 전송하고 콘텐츠 난이도, 게임 리소스 밸런스, 게임 사용자가 느끼는 어려움을 분석
  • 포함 정보
    • 콘텐츠 수행 중에 같이 콘텐츠를 수행한 게임 자원
    • 콘텐츠 수행 중에 사용된 아이템
    • 콘텐츠 수행 중에 사용한 스킬
    • 콘텐츠 수행 중에 착용한 장비
    • 콘텐츠 수행 중에 제거(Kill)한 적

  Method	Return	설명
  ClearPartnersInfo	void	파트너 정보 저장을 위한 목록 초기화
  AddPartnersInfo	void	파트너 정보 추가
  GetPartnersInfo	List<PartnersInfo>	파트너 정보 조회
  ClearWearItemInfos	void	WearItem 정보 저장을 위한 목록 초기화
  AddWearItemInfos	void	WearItem 데이터 추가
  GetWearItemInfos	List<WearItemInfo>	WearItem 데이터 조회
  ClearSkillInfos	void	스킬 정보 저장을 위한 스킬 목록 초기화
  AddSkillInfos	void	캐릭터가 사용하는 스킬을 스킬 목록에 추가
  GetSkillInfos	List<SkillInfo>	저장된 스킬 목록 조회
  ClearItemInfos	void	아이템 정보 저장을 위한 목록 초기화
  AddItemInfos	void	아이템 정보 추가
  GetItemInfos	List<ItemInfo>	저장된 아이템 목록 조회
  ClearEnemyInfos	void	콘텐츠에서 대전한 상대편 정보 저장을 위한 목록 초기화
  AddEnemyInfos	void	콘텐츠에서 대전한 상대 정보 추가
  GetEnemyInfos	List<EnemyInfo>	AddEnemyInfos 통해서 저장한 EnemyInfo 정보 조회

• AdPerformInfos

  • 게임 실행 시 게임 앱에서 배너 노출 정보와 배너 클릭 로그를 전송하고 사용자의 반응을 분석
  • 사용자가 참여한 다양한 캠페인(이벤트) 로그를 전송하고 게임 사용자의 참여율을 분석

  Method	Return	설명
  ClearJoinContents	void	파트너 정보 저장을 위한 목록 초기화
  AddJoinContents	void	파트너 정보 추가

• FileDownloadInfos

  • 게임 업데이트 중에 다운로드 및 설치하는 파일 로그를 전송하고 다운로드 및 설치 과정에서 발생하는 문제를 분석

• InstallInfos

  • 게임 첫 실행 및 게임 계정 생성 로그를 전송하고 서비스 중인 게임을 분석
  주의

  InstallInfos 로그는 게임 로그 분석의 기준이 되는 로그로 전송하지 않을 경우 다양한 분석에 제약이 발생할 수 있습니다.

• FriendshipInfos

  • 게임에서 발생하는 친구 관계에 대한 로그를 전송하고 로그를 통해서 게임 내 친구 관계를 검색
  참고

  FriendshipInfos 로그는 분석되지 않는 로그입니다. 필요 시 로그 검색 기능을 통해서 확인할 수 있습니다.

• ItemChangeInfos

  • 사용자가 다양한 게임 아이템 획득/소비 직후 로그를 전송하고 아이템 밸런스, 게임 기획에 대한 사용자의 반응을 분석

  • 게임 내에서 사용하는 유료, 무료 아이템 모두 분석

  • 포함 정보

    • 아이템 수량 변화의 목적
    • 각각의 아이템 수량 변화 경로
    • 한 번의 행위로 획득/소비한 여러 개의 아이템

  • 여러 가지의 ItemChangeInfos 정보를 누적 전송을 위해 객체 설정

    Method	Return	설명
    ClearItemChangeInfoList	void	아이템 변경 내역 저장을 위한 목록 초기화
    AddItemChangeInfoList	void	아이템 변경 내역 추가
    GetItemChangeInfoList	List<ItemChangeInfo>	AddItemChangeInfoList를 통해서 저장한 아이템 변경 내역 리스트 반환

  • ItemChangeInfos에 포함되는 ItemsInfo 객체 정보 설정

    Method	Return	설명
    ClearItemChangeInfos	void	저장한 아이템 수량 변화(획득/소비) 정보 초기화
    AddItemChangeInfos	void	아이템 획득/소비 시의 해당 아이템 상세 정보 추가
    GetItemChangeInfos	List<ItemsInfo>	AddItemChangeInfos를 통해 추가한 아이템 변화(획득/소비) 정보 반환

• VMoneyChangeInfos

  • 게임 안에서 사용되는 모든 재화 수량 변화(획득/소비) 로그를 전송하고 게임의 재화의 흐름을 분석
  참고

  게임 안에서 재화뿐만 아니라 재화와 유사한 형태를 가진 게임 자원도 분석할 수 있습니다.

  • 여러 가지의 VMoneyChangeInfos 정보를 누적 전송을 위해 객체 설정

    Method	Return	설명
    ClearVMoneyChangeInfoList	void	저장한 재화 수량 변화(획득/소비) 정보 초기화
    AddVMoneyChangeInfoList	void	재화의 수량 변화(획득/소비) 정보 추가
    GetVMoneyChangeInfoList	List<VMoneyChangeInfo>	AddVMoneyChangeInfoList를 통해서 추가한 재화 변경(획득/소비) 내역  정보 반환

• ResourceChangeInfos

  • 게임 안에서 사용되는 아이템들의 특성 변화 로그를 전송하고 게임 콘텐츠 밸런스, 아이템 밸런스, 콘텐츠와 아이템의 연관 관계, 게임 기획에 대한 사용자의 반응을 분석

• BuyInfos

  • 현금/카드/쿠폰/상품권 구매 등의 구매 로그를 전송하고 매출을 분석
  • 매출 분석을 통해서 매출 유저 분석, 아이템 분석, 아이템과 아이템의 관계를 분석

SDK Method 상세

InstallInfos

게임 첫 실행 및 게임 계정 생성 로그를 전송하고 서비스 중인 게임의 설치/계정 생성 상황을 분석

API 호출 시점

Enumerations 콘텐츠

• InstallType
  게임 앱 설치 관련 로그 전송 시 설치/계정 생성에 대한 구분을 지정

• ResultType
  게임 설치(게임 리소스 파일 패치) 성공 여부 지정

Method 설명

string InstallInfos(InstallType AppInstallType, string ReferrerURL, string APPVersion, StateType DeviceInstallStateType, ResultType DeviceInstallResult, string InstallErrorMessage, string PushToken)

샘플 소스

// 게임 설치 후 게임 최초 실행 시 설치 로그 남기기 (필수) 
StorageCoreManager.GetInstance ().GetApi ().InstallInfos (InstallType.INSTALL, StorageCoreManager.GetReferrerName(), "APPVersion", StateType.FINISH, ResultType.SUCCESS, "InstallErrorMessage", "");

// 계정 생성  로그 남기기 (필수) 
StorageCoreManager.GetInstance ().GetApi ().InstallInfos (InstallType.ACCOUNT, StorageCoreManager.GetReferrerName(), "APPVersion", StateType.FINISH, ResultType.SUCCESS, "InstallErrorMessage", "");

// 게임 로그인 (필수 / ConnectInfos를 통해 남길 수 있는 정보로 ConnectInfos에서 확인) 
StorageCoreManager.GetInstance().GetApi().ConnectInfos(ConnectType.APP, "Login", FlowType.IN); 

// 캐릭터 생성 프로세스 
// 인스턴스 객체 생성 (필수 / ItemChangeInfos를 통해 남길 수 있는 정보로 ItemChangeInfos에서 확인) 
StorageCoreManager scManager = StorageCoreManager.GetInstance(); 

// 아이템 데이터 저장전 데이터 array 초기화 
scManager.ClearItemChangeInfos (); 

// 캐릭터 생성 정보 넣기 
// 계정 생성 후 캐릭터 생성 로그 남기기
scManager.AddItemChangeInfoList(FlowType.IN, ChangeType.INIT, "ChangeDetail1", "ContentName", "ContentCode", scManager.GetItemChangeInfos());

FileDownloadInfos

게임 앱 추가 설치(게임 리소스 파일 패치)할 때 다운로드 로그를 전송하고, 다운로드 에러 발생 시 검색을 통해 에러를 확인

API 호출 시점

Enumerations

• MethodType/Enum
  유저가 게임의 리소스 파일을 받을 때의 전송 방식 지정

Method 설명

string FileDownloadInfos(string FileName, int FileSeq, string FileVersion, string ErrorMessage)

샘플 소스

//다운로드 순서 1번인 파일 "{FileName}"을 다운로드 받는 중에 "ErrorMessage" 에러가 발생되어 다운로드 로그를 저장
StorageCoreManager.GetInstance ().GetApi ().FileDownloadInfos ("hero1.png", 1, "0.1.0", "ErrorMessage");
StorageCoreManager.GetInstance ().GetApi ().FileDownloadInfos ("contents1.json", 2, "FileVersion", "ErrorMessage");
StorageCoreManager.GetInstance ().GetApi ().FileDownloadInfos ("item_bs.csv", 3, "FileVersion", "ErrorMessage");

BuyInfos

현금/카드/선물하기/상품권을 통해 구매한 로그를 전송하고 게임의 매출을 상세하게 분석

• 매출 분석(첫 구매/재구매 비율)
• 매출 분석(아이템 또는 레벨별)
• 구매 현황 분석(구매 유저의 추가 아이템 구매 현황)

API 호출 시점

Enumerations 콘텐츠

• PurchaseType
  유저가 유료 아이템을 구매 또는 획득하는 게임 자원 종류를 지정

• CurrencyType
  유료 아이템 구매 시 결제한 금액의 화폐 종류 지정

• PayToolCode
  유료 아이템 구매 시 결제 수단을 지정

• ResultType
  유료 아이템 구매 결과 지정

Method 설명

BuyInfos(string OrderNO, string GoodsCode, PurchaseType PayPurchaseType, string ItemCode, string ItemName, int Amount, CurrencyType CurrencyCode, float TotalPrice, ToolCodeType PayToolCode, DateTime Sdate, DateTime Edate, string ReceiveMemberID, int Balance, ResultType PayResultType, string PayResultMessage)

샘플 소스

//아이템 구매일시 변수 선언
System.DateTime today = System.DateTime.Now; 

//구매 로그 전송
StorageCoreManager.GetInstance().GetApi().BuyInfos("OrderNO", "GoodsCode" ,PurchaseType.PURCHARSE, "ItemCode", "ItemName", 100, CurrencyType.USD, 100.99, ToolCodeType.CARD, today, today.AddDays(10), "ReceiveMemberID", 100, ResultType.SUCCESS, "PayResultMessage");

ContentActInfos

게임 안에서 사용자의 게임 콘텐츠 수행 로그를 전송하고 콘텐츠 난이도, 캐릭터 밸런스, 아이템 밸런스 등을 분석

API 호출 시점

Enumerations 콘텐츠

• StageType
  게임 안에서 사용자가 수행하는 콘텐츠의 종류를 지정

• AutoType
  사용자가 콘텐츠를 수행할 때 사용했던 게임 수행 방법을 지정

• ResultType
  사용자가 게임 콘텐츠를 수행한 결과를 지정

• PartnerType
  콘텐츠를 같이 수행한 파트너 또는 게임 리소스의(친구, 펫, 길드원 등) 종류를 지정

Params Data Class

• PartnersInfo
  사용자가 게임 콘텐츠 수행 시 함께 수행한(도움을 주는) 게임 파트너(친구(캐릭터)/길드원/펫/카드)의 상세 정보를 저장

• WearItemInfo
  사용자가 게임 콘텐츠 수행 시 착용(장착)한 아이템 정보를 저장
  착용 또는 장착한 아이템(무기, 장신구, 의류등)

• SkillInfo
  사용자가 게임 콘텐츠 수행 시 사용한 캐릭터 스킬 정보를 사용한 스킬 순서대로 저장

• ItemInfo
  게임 안에서 콘텐츠 수행 시 사용한 아이템 정보를 사용한 아이템 순서대로 저장

• EnemyInfo
  게임 안에서 콘텐츠 수행 시 제거한 게임 자원(몬스터, 펫, PVP의 상대 캐릭터, 보스 몬스터)의 정보를 저장

Method 설명

// PartnersInfo의 내용 초기화
public void ClearPartnersInfo()

// List<PartnersInfo>에 파트너 정보 내역을 하나씩 추가
public void AddPartnersInfo(string MemberID, string PartnerCharUQCode, int PartnerHP, string PartnerID, int PartnerLevel, int PartnerMP, PartnerType PartnerType)

// AddPartnersInfo를 통해 추가한 장착 파트너 정보 내역 조회
public List<PartnersInfo> GetPartnersInfo()

// WearItemInfo의 내용 초기화
public void ClearWearItemInfos()

// List<WearItemInfo>에 장착 아이템 내역을 하나씩 추가
public void AddWearItemInfos(string PartnerID, string ItemCode, string ItemDeckCode, string ItemDeckName, string ItemGrade, int ItemLevel, string ItemName)

// AddWearItemInfos를 통해서 추가한 장착 아이템 내역 조회
public List<WearItemInfo> GetWearItemInfos()

// SkillInfos의 내용 초기화
public void ClearSkillInfos()

// List<SkillInfo>에 콘텐츠 수행 시 사용한 스킬 내역을 하나씩 추가
public void AddSkillInfos(string PartnerID, int SkillDamage, int SkillDuration, string SkillName, string SkillType)

// AddSkillInfos를 통해 추가했던 사용 스킬 내역 조회
public List<SkillInfo> GetSkillInfos()

// ItemInfo의 내용 초기화
public void ClearItemInfos()

// List<ItemInfo>에 콘텐츠 수행 시 사용한 아이템 내역을 하나씩 추가
public void AddItemInfos(string PartnerID, int ItemAmount, int ItemDuration, string ItemName)

// AddItemInfos를 통해 추가했 사용 스킬 내역 조회
public List<ItemInfo> GetItemInfos()

// List<EnemyInfo>의 내용 초기화
public void ClearEnemyInfos()

// List<EnemyInfo>에 콘텐츠 수행 시 제거한 게임 자원(몬스터, 펫, PVP의 상대 캐릭터, 보스 몬스터) 내역을 하나씩 추가
public void AddEnemyInfos(string PartnerID, int EnemyAttack,int EnemyDefense,string EnemyID,int EnemyLevel,int EnemyStamina)

// AddEnemyInfos를 통해 저장한 대전 상대 정보 반환
public List<EnemyInfo> GetEnemyInfos()

// 게임 안에서 사용자의 게임 콘텐츠 수행 로그 전송
public void ContentActInfos(StageType ContentActStageType, string StageName, AutoType IsAuto, string StageGrade, string StageResultGrade, int StagePlayTime, ResultType StageResult, IEnumerable<PartnersInfo> StagePartnersInfo, int RemainHP, int RemainMP, IEnumerable<WearItemInfo> WearItemInfo, IEnumerable<SkillInfo> UseSkillInfo, IEnumerable<ItemInfo> UseItemInfo, int EnemyKill, IEnumerable<EnemyInfo> EnemyKillInfo)

샘플 소스

• 스테이지 수행 로그

// 객체 초기화
StorageCoreManager scManager = StorageCoreManager.GetInstance(); 

// 파트너 정보 초기화 
scManager.ClearPartnersInfo(); 
// 파트너 추가 1 
scManager.AddPartnersInfo("1000", "2",100,"1001",10,50, PartnerType.ETC); 
// 파트너 추가 2 
scManager.AddPartnersInfo("1001", "3", 105, "1002", 11, 55, PartnerType.ETC); 

// 착용 장비 추가를 위한 초기화 
scManager.ClearWearItemInfos(); 
// 착용 장비 추가 1 
scManager.AddWearItemInfos(“PartnerID”, "1","1","1","A",1,"Helmet"); 
// 착용 장비 추가 2 
scManager.AddWearItemInfos(“PartnerID”, "2", "1","1", "B", 1, "Shield"); 

// 사용한 스킬 추가를 위한 초기화 
scManager.ClearSkillInfos(); 
// 스테이지에서 사용한 스킬 추가1 
scManager.AddSkillInfos(“PartnerID”, 100, 10,"Fire Ball","Magic"); 
// 스테이지에서 사용한 스킬 추가2 
scManager.AddSkillInfos(“PartnerID”, 50, 5, "ICE Ball", "Magic"); 

// 스테이지에서 사용한 아이템 정보 추가를 위한 초기화 
scManager.ClearItemInfos(); 
// 스테이지에서 사용한 아이템 추가1 
scManager.AddItemInfos(“PartnerID”, 10,4,"Potion"); 
// 스테이지에서 사용한 아이템 추가2 
scManager.AddItemInfos(“PartnerID”, 1, 5, "Mana Potion"); 

// 스테이지에서 제거한 몬스터 또는 캐릭터 정보 추가를 위한 초기화 
scManager.ClearEnemyInfos(); 
// 스테이지에서 제거한 몬스터 또는 캐릭터 정보 추가 1 
scManager.AddEnemyInfos(“PartnerID”, 40, 10, "1001", 2, 10); 
// 스테이지에서 제거한 몬스터 또는 캐릭터 정보 추가 2 
scManager.AddEnemyInfos(“PartnerID”, 50, 20, "1002", 3, 20); 

// 콘텐츠 수행 로그 전송 
scManager.GetApi().ContentActInfos(StageType.STAGE, "StageName01",  AutoType.AUTO, "StageGrade", "StageResultGrade", 100, ResultType.SUCCESS, scManager.GetPartnersInfo(), 100, 100, scManager.GetWearItemInfos(),  scManager.GetSkillInfos(), scManager.GetItemInfos(), 10,  scManager.GetEnemyInfos());

ResourceChangeInfos

게임에서 사용되는 다양한 리소스들의 정성적인(능력치) 변화 로그를 전송하고 게임 리소스 밸런스를 분석

API 호출 시점

Enumerations 콘텐츠

• ObjectType
  변화의 주체를 지정
  예: 펫 강화, 무기 변화, 무기 소켓 변화, 의류 강화, 드론 강화

• ChangeStateType
  계정, 캐릭터, 카드 및 게임 주체의 정성적 변화를 구분 지정

• ResultType
  계정, 캐릭터, 카드 및 게임 주체의 정성적 변화 작업의 성공 여부를 지정

Method 설명

다양한 리소스들의 정성적인(능력치) 변화 로그를 전송

public void ResourceChangeInfos(ObjectType ChangeObjectType, string UniqueCode, long SeqCode, string Name, string TargetUniqueCode, string TargetSeqCode, string TargetName, ChangeActType ResourceChangeStateType, string BeforeLevel, string AfterLevel, string BeforeLevelDesc, string AfterLevelDesc, ResultType ChangeResultType, string MoneyCode, string MoneyName, int MoneyAmount)

샘플 소스

//{UniqueCode} 아이템을 레벨업하고, 레벨업의 결과는 성공일 때 

//게임 리소스의 정성적 변화 로그 전송
StorageCoreManager.GetInstance().GetApi().ResourceChangeInfos(ObjectType.ITEM, "{UniqueCode}", 2, "Name", “TargetUniqueCode”, “TargetSeqCode”, “TargetName”, ChangeStateType.LEVEL, "1", "2", "{BeforeLevelDesc}", "{AfterLevelDesc}", ResultType.SUCCESS, “MoneyCode”, “MoneyName”, 100);

VMoneyChangeInfos

게임 안에서 획득/소비하는 모든 재화 로그를 전송하고 현금성/비현금성 재화의 흐름을 분석

API 호출 시점

Enumerations 콘텐츠

• MoneyChangeType
  게임 재화의 획득/소비 경로를 지정

• FlowType
  게임 머니 변화의 구분 값을 지정

• Money Type
  게임 재화의 현금성/비현금성 재화 구분을 지정

Method 설명

// VMoneyChangeInfo의 내용 초기화
public void ClearVMoneyChangeInfoList()

// List<VMoneyChangeInfo>에 재화의 사용 내역을 하나씩 추가
public void AddVMoneyChangeInfoList(FlowType MoneyFlowType, string MoneyName, MoneyChangeType MoneyChangeType, string MoneyChangeDetail, string ContentName, string ContentCode, MoneyType MoneyType, long Amount, long HoldAmount, string MoneyChangeName = “”)

// AddVMoneyChangeInfoList를 통해 추가했던 재화의 획득/소비 내역 조회
public List<VMoneyChangeInfo> GetVMoneyChangeInfoList()

// 게임 안에서 획득/소비하는 모든 재화 로그 전송
public void VMoneyChangeInfos(IEnumerable<VMoneyChangeInfo> VMoneyChangeInfoList)

샘플 소스

// {MoneyName}의 게임 머니를 토글을 통해 획득한 경우 
StorageCoreManager scManager = StorageCoreManager.GetInstance(); 

//재화 변경내역 목록 초기화 
scManager.ClearVMoneyChangeInfoList(); 

//재화 변경내역 추가 
//경험치 획득
scManager.AddVMoneyChangeInfoList(FlowType.IN, "MoneyName", MoneyChangeType.INIT,"MoneyChangeDetail1", "ContentName", "ContentCode", MoneyType.EXP, 1000, 50000); 

//경험치 획득
scManager.AddVMoneyChangeInfoList(FlowType.IN, "MoneyName", MoneyChangeType.DEAL,"MoneyChangeDetail2", "ContentName", "ContentCode", MoneyType.EXP, 2000, 40000); 

//비현금성 재화 "빨간보석"을 분해를 통해서 획득
scManager.AddVMoneyChangeInfoList(FlowType.IN, "MoneyName", MoneyChangeType.DISMANTLE,"MoneyChangeDetail3", "빨간보석", "CD0002", MoneyType.GOLD, 3000, 30000); 

//길드 전쟁 참여 시 "신발"이라는 스테미나를 사용
scManager.AddVMoneyChangeInfoList(FlowType.OUT, "MoneyName", MoneyChangeType.GUILDACTION, "MoneyChangeDetail4", "신발", "CD0003", MoneyType.STAMINA, 4000, 20000); 

//현금 구매를 통해서 다이아몬드를 획득
scManager.AddVMoneyChangeInfoList(FlowType.IN, "MoneyName", MoneyChangeType.CASH, "MoneyChangeDetail5", "다이아몬드", "ContentCode", MoneyType.CASH, 5000, 10000, "MoneyChangeName"); 

//재화 변경 내역 전송 
StorageCoreManager.GetInstance().GetApi().VMoneyChangeInfos(scManager.GetVMoneyChangeInfoList());

ItemChangeInfos

게임 안에서 사용자의 게임 아이템 획득/소비(수량의 변화) 로그를 전송하고 아이템의 흐름을 분석

API 호출 시점

Enumerations 콘텐츠

• ChangeType
  아이템이 양적으로 변화된 사유를 지정

• FlowType
  아이템 양적 변화의 구분 값을 지정

Param 데이터 클래스

• ItemsInfo
  획득한 아이템 각 정보를 저장
  여러 가지의 아이템을 획을/소비했을 경우 하나씩 모두 추가

Method 설명

// List<ItemChangeInfo>의 내용 초기화

public void ClearItemChangeInfoList()

// List<ItemChangeInfo>에 여러 경로를 통한 아이템 수량 변화를 하나씩 추가
public void AddItemChangeInfoList(FlowType ItemFlowType, ChangeType ItemChangeType, string ChangeDetail, string ContentName, string ContentCode, IEnumerable<ItemsInfo> ItemsInfo, string ChangeName = "")

// AddItemChangeInfoList를 통해서 추가한 아이템 수량 변화 내역 조회
public List<ItemChangeInfo> GetItemChangeInfoList()

// List<ItemChangeInfo>의 내용 초기화
public void ClearItemChangeInfos()

// List<ItemsInfo>에 아이템 수량 변화 내용을 추가
// 한 번의 행위로 여러 개의 아이템 획득/소비 시 아이템에 대한 정보
public void AddItemChangeInfos(int ItemAmount,string ItemGrade, byte ItemImputeType,int ItemLevel,string ItemName,string ItemUniqueCode, string MoneyCode, string MoneyName, int MoneyAmount)

// AddItemChangeInfos를 통해 추가했던 아이템 수량 변화 내역 조회
public List<ItemsInfo> GetItemChangeInfos()

// 아이템 수량 변화 로그 전송
public void ItemChangeInfos(IEnumerable<ItemChangeInfo> ItemChangeInfoList)

샘플 소스

//{MoneyName}의 게임 머니를 토글을 통해 획득한 경우 
StorageCoreManager scManager = StorageCoreManager.GetInstance(); 

//획득한 아이템을 목록에 추가하기 위한 목록 초기화 
scManager.ClearItemChangeInfos (); 

//획득한 아이템 추가 ***************************************************************************************************************************
//콘텐츠에서 "zombie_A"개 제거 후 아이템 3개 획득 - List<ItemsInfo>에 아이템 추가
scManager.AddItemChangeInfos (1, "B", 1, 1, "legend Sword", "1001", "M100100", "Ruby", 100); 
scManager.AddItemChangeInfos (2, "C", 1, 1, "Iron Shield ", "1002", "M100200", "Gold", 100); 
scManager.AddItemChangeInfos (5, "D", 1, 1, "Iron Shield ", "1007", "M100200", "Gold", 100);

//List<ItemChangeInfo>에 아이템 로그셋에 획득한 아이템을 추가하여 아이템 로그셋 추가
scManager.AddItemChangeInfoList(FlowType.IN, ChangeType.STAGEACTION, "zombie_A 제거", "zombie_A", "Cts0100100", scManager.GetItemChangeInfos());
//획득/소비한 아이템 추가  ***************************************************************************************************************************

//획득/소비한 아이템 추가 ***************************************************************************************************************************
//콘텐츠에서 "zombie_KING"개 제거 후 아이템 2개 획득 - List<ItemsInfo>에 아이템 추가 
scManager.AddItemChangeInfos (1, "B", 1, 1, "legend Sword", "1001", "M100100", "Ruby", 100);  
scManager.AddItemChangeInfos (2, "C", 1, 1, "Iron Shield", "1002", "M100200", "Gold", 100);  

//List<ItemChangeInfo>에 아이템 로그셋에 획득한 아이템을 추가하여 아이템 로그셋 추가
scManager.AddItemChangeInfoList(FlowType.IN, ChangeType.STAGEACTION, "zombie_KING 제거", "zombie_A", "Cts0100100", scManager.GetItemChangeInfos());

//콘텐츠에서 "zombie_KING"개 제거 후 하나의 물약 10개 소비 - List<ItemsInfo>에 아이템 추가
scManager.AddItemChangeInfos (10, "C", 1, 1, "Commu_Potion", "HP5011", "M100200", "Gold", 100);

//List<ItemChangeInfo>에 아이템 로그셋에 획득한 아이템을 추가하여 아이템 로그셋 추가
scManager.AddItemChangeInfoList(FlowType.OUT, ChangeType.STAGEACTION, "zombie_KING 제거", "zombie_KING", "Cts0100100", scManager.GetItemChangeInfos());

//획득/소비한 아이템을 추가  ***************************************************************************************************************************

//아이템 수량 변화 로그 전송
StorageCoreManager.GetInstance ().GetApi ().ItemChangeInfos (scManager.GetItemChangeInfoList());

ConnectInfos

로그인/로그아웃 로그를 전송하고 게임 유저 접속 현황을 분석
게임 안의 콘텐츠(스테이지, 던전, PVP, 상점 등)에 입장/퇴장 로그를 전송하고 콘텐츠 활용도를 분석

API 호출 시점

Enumerations 콘텐츠

• ConnectType
  콘텐츠의 형식을 정의

• FlowType
  게임 머니 변화의 구분 값을 지정

Method 설명

public void ConnectInfos(ConnectType connectType, string contentName, FlowType entryType)

샘플 소스

게임 로그인 또는 게임 로그아웃

// 로그인, 로그아웃
// 게임 로그인 로그 전송
StorageCoreManager.GetInstance().GetApi().ConnectInfos(ConnectType.APP, "Login", FlowType.IN);

// 게임 로그아웃 로그 전송
r.GetInstance().GetApi().ConnectInfos(ConnectType.APP, "Logout", FlowType.OUT);

콘텐츠 진입 또는 콘텐츠 이탈

// 콘텐츠 입장, 퇴장
// 스테이지1-1 입장 로그 전송
StorageCoreManager.GetInstance().GetApi().ConnectInfos(ConnectType.CONTENT, “스테이지1-1”, FlowType.IN);  

// 스테이지1-1 퇴장 로그 전송
StorageCoreManager.GetInstance().GetApi().ConnectInfos(ConnectType.CONTENT, “스테이지1-1”, FlowType.OUT);

AdPerformInfos

게임 앱 안에 노출되는 배너(광고, 공지)에 대한 로그를 전송하고 인게임 배너에 대한 유저의 반응을 분석
게임 앱 안에서 특정 업적(특정 레벨, 특정 퀘스트, 특정 스테이지 도달 등) 달성 로그를 전송하고 이벤트에 대한 유저의 반응을 분석

API 호출 시점

Enumerations 콘텐츠

• ContentType
  추적하고 싶은 대상에 대한 구분을 지정

• AdsActType
  시스템과 유저의 행위 형식 지정
  시스템에서 표시할 때와 유저가 클릭할 때로 나누어 지정

Params 데이터 클래스

• JoinContent
  이벤트 참여 내용을 저장
  이벤트에 여러 단계가 있을 경우 하나하나 단계별로 로그를 저장

Method 설명

// 저장된 List<JoinContent> 값 초기화
public void ClearJoinContents()

// List<JoinContent>에 이벤트 내용 추가
public void AddJoinContents(int JoinChoice, int JoinLevel, int JoinStep)

List<JoinContent> GetJoinContents()

// 저장된 List<JoinContent> 값 초기화
public string AdPerformInfos(ContentType PromoteContentType, AdsActType PromoteAdsActType, string PromoteContentName, string PromoteContent, string PromoteJoinKey, IEnumerable<JoinContent> PromoteJoinContent, string ReferrerPageName)

샘플 소스

StorageCoreManager scManager = StorageCoreManager.GetInstance(); 

//콘텐츠의 단계가 있는 경우 단계를 하나씩 추가
scManager.ClearJoinContents(); 
scManager.AddJoinContents(1, 10,2); 
scManager.AddJoinContents(2, 12, 1); 

//로그 전송
AdPerformInfo StorageCoreManager.GetInstance().GetApi().AdPerformInfos(ContentType.EVENT, AdsActType.IMPRESSION, "promotecontentname", "promotecontent","promotejoinkey", scManager.GetJoinContents(), "referrerPageaName");

FriendshipInfos

게임 내 친구 관련 정보 저장

API 호출 시점

Enumerations 콘텐츠

• RequestType
  친구 정보를 저장할 때 유저의 행위 지정

Method 설명

// 사용자에게 친구 요청/요청 거부/요청 수락/삭제 
public void  FriendshipInfos(RequestType FriendRequestType, string FriendMemberId, string CharID, string FriendNickName, string FriendCharId, int FriendLevel)

샘플 소스

//레벨1이면서 회원 번호가 {FriendMemberId}이고, 닉네임이 {FriendMemberId}인 사용자에게 친구를 요청
string StorageCoreManager.GetInstance().GetApi().FriendshipInfos(RequestType. ASK, "FriendMemberId", "FriendNickName", 1);

//레벨1이면서 회원번호가 {FriendMemberId}이고, 닉네임이 {FriendMemberId}인 사용자에게 친구 관계를 동의
StorageCoreManager.GetInstance().GetApi().FriendshipInfos(RequestType. AGREE, "FriendMemberId", "FriendNickName", 1);