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

  • ユーザーのレベルが成長する際に呼び出してキャラクターのレベル情報を更新
  注意事項

  キャラクターレベルの変更ではなく、アカウントレベルの変更を意味します。1つのアカウントで複数のキャラクターを使用する場合、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

  • ユーザーの会員ID設定
  • 最初のGame Report Instance作成時に、コンストラクタを通じてMemberIDを入れられない場合に使用
    • 例) ゲームの初実行時にMemberIDがない場合、Game ReportのinstanceをEmptyに設定し、アカウント発行後にMemberIDを設定
  注意事項

  MemberIDはユーザー別に固有でなければなりません。そうでないと、指標が不正確になる可能性があります。

  public void SetMemberID(string MemberID)
  
  /* SampleCode */
  // アカウントIDを「MID0000007」に設定
  StorageCoreManager.GetInstance().GetApi().SetMemberID("MID0000007");
  

• SetNickName

  • ユーザーのNickName設定
    • 例) ゲームの初実行時にハンドルネームがない場合、EmptyでGame Report Instanceしてアカウント発行後にNickNameを設定
    • ハンドルネームクーポンを使用してハンドルネームを変更する際に使用

  public void SetNickName(string NickName)
  
  /* SampleCode */ 
  // ハンドルネームを「サノス」に設定
  StorageCoreManager.GetInstance().GetApi().SetNickName("サノス");
  

• SetChannelID

  • ゲームアプリのインストール時に使用したチャネル会社(Apple Store、Google Play Store、ONE Store)などで発行するID情報を設定
  • ゲームサービスチャネルのIDを変更する際に使用してChannelIDを更新

  public void SetChannelID(string ChannelID)
  
  /* SampleCode */ 
  // チャネルIDを「0000001234567」に設定
  StorageCoreManager.GetInstance().GetApi().SetChannelID("0000001234567");
  

• SetChannelCode

  • ストアの名前であるゲームサービスチャネルコードを設定
    • 例) iOS、AOS、ONE Storeなどのストア名を設定

  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>にパートナー情報を1つずつ追加
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>に装着アイテムを1つずつ追加
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>に、コンテンツ実行時に使用したスキルを1つずつ追加
public void AddSkillInfos(string PartnerID, int SkillDamage, int SkillDuration, string SkillName, string SkillType)

// AddSkillInfosを通じて追加した使用スキル履歴を照会
public List<SkillInfo> GetSkillInfos()

// ItemInfoの内容を初期化
public void ClearItemInfos()

// List<ItemInfo>に、コンテンツ実行時に使用したアイテムを1つずつ追加
public void AddItemInfos(string PartnerID, int ItemAmount, int ItemDuration, string ItemName)

// AddItemInfosを通じて追加した使用スキル履歴を照会
public List<ItemInfo> GetItemInfos()

// List<EnemyInfo>の内容を初期化
public void ClearEnemyInfos()

// List<EnemyInfo>にコンテンツ実行中に退治したゲームリソース(モンスター、ペット、PVPの相手キャラクター、ボスモンスター)を1つずつ追加
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>に財貨の使用履歴を1つずつ追加
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
  獲得したアイテムのそれぞれの情報を保存
  複数のアイテムを獲得・消費した場合、すべてを1個ずつ追加

Methodの説明

// List<ItemChangeInfo>の内容を初期化

public void ClearItemChangeInfoList()

// List<ItemChangeInfo>に複数の経路を介したアイテム数量変化を1つずつ追加
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」個退治した後、1つのポーションを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(); 

//コンテンツに段階が存在する場合、段階を1つずつ追加
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);