SDK 적용 개요

[SDK 적용 개요]

1. 개요

• Class StorageCoreManager

• public class StorageCoreManager

• 게임 로그를 Coresight StorageCore로 전송을 담당합니다.

2. StorageCoreApi 생성자

• 데이터 전달을 위한 기본 생성자.

• 기본 정보를 파라메터로 객체를 생성.

3. Syntax

\1. StorageCoreApi(string Url, string AuthKey, string TargetVer, string ChannelCode, string ChannelID, string MemberID, string CharID, string NickName).

\2. //예제

\3. m_api = new StorageCoreApi(serverIp, authKey, gameVersion, channelCode, channelID, memberID, charID, nickName);

4. Parameters

• Url Rest API URL 정보

• AuthKey Rest API인증을 위한 인증키

• TargetVer 게임 앱의 버전.

• ChannelCode 게임 서비스 채널의 채널코드 예 : iOS, AOS, Onestore 등의 스토어 명

• ChannelID 특정 채널사(애플스토어, 구글스토어, 원스토어)등에서 사용자가 가입 시 입력한 ID 정보

• MemberID 게임에서 발행하는 회원 아이디 회원 아이디는 회원 별로 유일한 코드. 빈 값이나 NULL 데이터가 들어있는 경우 집계에서 제외됩니다. 공백,탭, 개행 문자가 들어있는 경우 제거 후 집계됩니다**.

• CharID 게임에서 발행하는 캐릭터의 아이디 하나의 회원 코드에 여러 개를 발행하되 현재 접근하는 캐릭터의 아이디. 빈 값이나 NULL 데이터가 들어있는 경우 집계에서 제외됩니다. 공백,탭, 개행 문자가 들어있는 경우 제거 후 집계됩니다**.

• NickName 회원 또는 캐릭터에 대응되는 별명.

SDK Method Summary

1. Method Summary

• SetAccountLevel 로그인 시 캐릭터의 레벨을 설정합니다. 캐릭터의 레벨이 성장할 때 호출하여 캐릭터의 레벨 정보를 갱신합니다.

• SetCharacterID 유저가 로그인 시 캐릭터를 선택할 때 캐릭터 아이디를 설정합니다. 유저가 보유하고 있는 캐릭터 중 다른 캐릭터를 선택할 때 호출하여 정보를 갱신합니다.

• SetMemberID 유저가 로그인 시 회원 아이디를 설정합니다. 유저가 로그인 시 호출하여 정보를 갱신합니다.

• SetNickName 유저가 로그인 시 닉네임을 설정합니다. 유저가 로그인 시 호출하여 닉네임 정보를 갱신합니다.

• SetChannelID 특정 채널사(애플스토어, 구글스토어, 원스토어)등에서 사용자가 가입 시 입력한 ID 정보를 설정합니다. 게임 서비스 채널 아이디 변경시 호출하여 갱신합니다.

• SetChannelCode 게임 서비스 채널의 채널코드를 설정합니다. 예를 들어 iOS, AOS, Onestore 등의 스토어 명을 설정합니다. 게임 서비스 채널 코드 변경시 호출하여 갱신합니다.

• GetInstance StorageCoreManager 객체를 초기화 합니다.

• ConnectInfos Log 게임 앱과 게임 안에 컨텐츠에 대한 사용 로그를 저장합니다.

• ContentActInfos 게임 안에 컨텐츠를 수행했을 때 로그를 저장합니다.

A. AdPerformInfos

• 인 게임에서 배너의 노출과 클릭한 로그를 저장합니다.

B. FileDownloadInfos

• 게임 패치 파일 다운 로그를 저장합니다.

• 다운로드 되는 모든 파일의 로그를 저장합니다.

C. InstallInfos

• 게임 설치 로그를 저장합니다.

D. FriendshipInfos

• 친구 관계에 대한 로그를 저장합니다.

E. ItemChangeInfos

• 다수의 아이템 변경내역을 리스트화 하여 전송합니다.

• 아이템 수량 변화의 로그를 저장합니다.

F. VMoneyChangeInfos

• 게임 안에서 사용되는 모든 재화의 수량 변화 로그를 저장합니다.
• 다수의 재화 변경내역을 리스트화 하여 전송합니다.

G. ResourceChangeInfos

• 게임 안에 사용되는 모든 아이템의 질적인 변화 로그를 저장합니다.

H. BuyInfos

• 현금/카드/쿠폰/상품권등 현금 또는 현금화되는 재화로 구매가 발생되었을 때 로그를 저장합니다.

I. String

• String 항목은 100자 이내로만 지정해야 합니다.

Methods Detail – InstallInfos

[InstallInfos]

• 앱을 설치할 때 로그를 호출하여 로그를 저장합니다.

• API Call Point 게임 앱을 설치 후 최초 실행할 때 로그를 저장합니다. 게임 앱 최초 실행 시 에러가 발생되었다면 에러코드 또는 에러 문구를 같이 전송합니다.

• Enum Constants 게임 앱의 설치와 제거를 지정합니다.

* 설치의 성공여부를 지정합니다.*

• Method Description

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

• Sample Source

• StorageCoreManager.GetInstance().GetApi().InstallInfos(InstallType.INSTALL, StorageCoreManager.GetReferrerName(), "APPVersion", “SAMSUNG GALAXY S7”,” Samsung 3rd Custom CPU Architecture MP4 2.7 GHz CPU + ARM Cortex-A55 MP4 1.7 GHz CPU”,”4GB”,” ARM Mali-G72 MP18 572 MHz GPU”,” Samsung Experience 9.0”, ResultType.SUCCESS,"-", “DSF2343J3KLER321A8EI3S0A9E”);

• StorageCoreManager.GetInstance().GetApi().InstallInfos(InstallType.INSTALL, StorageCoreManager.GetReferrerName(), "APPVersion", “SAMSUNG GALAXY S7”,” Samsung 3rd Custom CPU Architecture MP4 2.7 GHz CPU + ARM Cortex-A55 MP4 1.7 GHz CPU”,”4GB”,” ARM Mali-G72 MP18 572 MHz GPU”,” Samsung Experience 9.0”, ResultType.FAIL,"ERRCode Cx001", “DSF2343J3KLER321A8EI3S0A9E”);

Methods Detail – FileDownloadInfoss

[FileDownloadInfoss]

패치 파일 로그를 저장합니다.

• API Call Point 게임 패치 파일을 다운로드 받은 후 또는 파일 다운로드 중에 에러가 발생되었을 때 로그를 저장합니다.

  A.파일 다운로드 중에 와이파이가 끊어지는 문제로 전송이 되지 않을 때

  B.파일 다운로드 중에 CDN에 특정 파일이 존재하지 않을 때(에러 코드를 포함)

• Enum Constants 유저가 게임의 리소스 파일을 받을 때의 전송 방식을 지정합니다.

• Method Description

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

• Sample Source

• //다운로드 순서 1번인 파일 “{ FileName}”을 다운로드 받는 중에 “ErrorMessage”에러가 발생되었고 다운로드 로그를 저장함.

• StorageCoreManager.GetInstance().GetApi().FileDownloadInfos("FileName", 1, "FileVersion", "ErrorMessage");

Methods Detail – BuyInfos

[BuyInfos]

현금/카드 등의 구매로그를 저장합니다.

• API Call Point 유저가 유료 아이템 구매 완료 시점 주의) 반드시 채널사의 구매 완료 확인 후에 호출해야 합니다.

• Enum Constants** \ 유저가 유료 아이템을 구매 또는 획득하는 종류를 지정합니다.

 \<CurrencyType/Enum>
**유료** **아이템** **구매** **시** **결제한** **금액의** **화폐** **종류를** **지정합니다**.

• 유료 아이템 구매 시 결제의 수단을 지정합니다.

• 유료 아이템 구매 결과를 지정합니다.

• Method Description

• 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)

• Sample Source

• //아이템을 구매

• System.DateTime today = System.DateTime.Now;

• //Send BuyInfo
• 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");

Methods Detail – ContentActInfos

[ContentActInfos]

게임 내 컨텐츠 수행 로그를 저장합니다.

• API Call Point 모든 컨텐츠 수행 완료 시점 컨텐츠에서 소비한 모든 아이템 정보를 같이 저장합니다. 컨텐츠에서 대전한 상대 정보에 대한 정보를 같이 저장합니다. 컨텐츠를 함께 수행한 상대 정보를 같이 저장합니다. 컨텐츠 수행시 착용한 아이템 정보를 같이 저장합니다. 예 : 아래를 포함한 모든 게임 컨텐츠 종료 후 시점.

  A. PVP 종료 후 시점 B. 이벤트 던전 종료 후 시점 C. 레이드 종료 후 시점 D. 길드 전 종료 후 시점

• Enum Constants \ 컨텐츠의 종류를 정의합니다. (Enum)

• \ 스테이지 오토 수행 여부를 정의합니다. (Enum)

• \ 스테이지 수행 결과를 정의합니다. (Enum)

• \ 컨텐츠를 같이 수행한 파트너의 종류를 지정합니다**. (Enum)

• \

  스테이지를 함께 수행하는 친구/캐릭터카드/펫 등의정보 저장합니다.

• \

  컨텐츠 수행시 착용한 아이템을 저장합니다. 착용 또는 장착한 아이템 무기, 장신구, 의류 등

• \ 컨텐츠 수행 시 사용한 스킬을 저장합니다. 단, 사용한 스킬 순서대로 저장합니다. (스킬 트리 분석에 도움을 드리는 항목입니다)

• 컨텐츠 수행 시 사용한 아이템을 저장합니다.

  단, 사용한 아이템 순서대로 저장합니다.

  (스킬, 아이템, 물약, 탄약 등)

**

• / 컨텐츠 수행 시 상대에 대한 정보를 저장합니다. (Kill한 몬스터, 펫, PVP의 상대캐릭터, 보스몬스터 등)

• \

• // 컨텐츠 수행 로그를 저장합니다.

• ContentActInfos(StageType ContentActStageType, string StageName, AutoType IsAuto, string StageGrade, string StageResultGrade, int StagePlayTime, ResultType StageResult, IEnumerable StagePartnersInfo, int RemainHP, int RemainMP, IEnumerable WearItemInfo, IEnumerable UseSkillInfo, IEnumerable UseItemInfo, int EnemyKill, IEnumerable EnemyKillInfo)

1. // 컨텐츠 수행할 때 함께함 파트너정보 로그 저장을 위하여 목록을 초기화 합니다.

2. // 목록에 데이터를 저장하기 위한 초기화 작업.

3. void ClearPartnersInfo()

1. // 컨텐츠를 수행할 때 함께한 파트너 정보를 추가합니다.

2. void AddPartnersInfo(string MemberID, string PartnerCharUQCode, int PartnerHP, string PartnerID, int PartnerLevel, int PartnerMP, PartnerType PartnerType)

1. // AddPartnersInfo 를 통해서 저장된 파트너 정보 로그를 반환 합니다.

2. void GetPartnersInfo()

1. // 컨텐츠를 수행할 때 착용한 장비정보 로그 저장을 위하여 목록을 초기화 합니다.

2. void ClearWearItemInfos()

1. // 컨텐츠를 수행 할 때 착용 장비 정보를 추가 합니다.

2. void AddWearItemInfos(string PartnerID, string ItemCode, string ItemDeckCode, string ItemDeckName, string ItemGrade, int ItemLevel, string ItemName)

1. // 컨텐츠를 수행 할 때 착용 장비 정보를 추가 합니다.

2. void GetWearItemInfos()

1. // 컨텐츠에서 사용한 스킬 로그 저장을 위하여 목록을 초기화 합니다.

2. void ClearSkillInfos()

1. // 컨텐츠에서 사용한 스킬 정보를 추가 합니다.

2. void AddSkillInfos(string PartnerID, int SkillDamage, int SkillDuration, string SkillName, string SkillType)

1. // AddSkillInfos를 통해 저장한 스킬 정보를 반환 합니다.

2. List\ GetSkillInfos()

1. // 컨텐츠에서 사용한 아이템 정보 로그 저장을 위하여 목록을 초기화 합니다.

2. void ClearItemInfos()

1. // 컨텐츠에서 사용한 아이템 정보를 추가합니다.

2. void AddItemInfos(string PartnerID, int ItemAmount, int ItemDuration, string ItemName)

1. // AddItemInfos를 통해서 저장한 사용 아이템 정보를 반환 합니다.

2. List GetItemInfos()

1. // 컨텐츠에서 대전한 상대 정보 저장을 위하여 목록을 초기화 합니다.

2. void ClearEnemyInfos()

1. // 컨텐츠에서 대전한 상대 정보를 추가합니다.

2. void AddEnemyInfos(string PartnerID, int EnemyAttack,int EnemyDefense,string EnemyID,int EnemyLevel,int EnemyStamina)

1. // AddEnemyInfos를 통해서 저장한 대전 상대 정보를 반환 합니다.

2. List GetEnemyInfos()

• Sample Source <스테이지 수행 로그>

• //인스턴스 생성

• 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");
• // 스테이지에서 Kill한 몬스터 또는 캐릭터 정보 추가를 위한 초기화
• scManager.ClearEnemyInfos();
• // 스테이지에서 Kill한 몬스터 또는 캐릭터 정보 추가 1
• scManager.AddEnemyInfos(“PartnerID”, 40, 10, "1001", 2, 10);
• // 스테이지에서 Kill한 몬스터 또는 캐릭터 정보 추가 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());

Methods Detail – ResourceChangeInfos

[ResourceChangeInfos]

계정/캐릭터/아이템/펫등 게임의 자원이 변화되었을 때 호출하여 로그를 저장합니다.

• API Call Point 계정의 레벨업, 등급업 등의 작업으로 계정의 정량, 정성적인 변화가 발생되었을 때 호출합니다. 캐릭터의 레벨업, 등급업, 강화 등의 작업으로 캐릭터의 정량, 정성적인 변화가 발생되었을 때 호출합니다. 펫의 레벨업, 등급업, 강화등의 작업으로 펫의 정량, 정성적인 변화가 발생되었을 때 호출합니다. 캐릭터, 펫, 아이템의 수치 또는 옵션을 변경했을 때 호출합니다.

  A. 무기를 레벨업 했을 때 B. 갑옷 또는 장신구를 강화했을 때 C. 보석을 등급업 했을 때 D. 무기, 방어구, 장신구 등의 옵션을 변경했을 때 E. 캐릭터의 스킬을 변경했을 때

• Enum Constants \ A. 변화의 주체를 지정합니다. B. 펫의 강화, 무기의 변화, 무기 소켓의 변화, 의류의 강화, 드론의 강화

• \ 계정, 캐릭터, 카드 및 게임의 주체의 정성적 변화의 구분을 지정합니다.

• \ 변화 작업의 성공여부를 지정합니다.

• Method Description

• 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)

· Sample Source**

**

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

\2. //Send ResourceChangeInfo

\3. StorageCoreManager.GetInstance().GetApi().ResourceChangeInfos(ObjectType.ITEM, "{UniqueCode}", 2, "Name", “TargetUniqueCode”, “TargetSeqCode”, “TargetName”, ChangeActType.LEVEL, "1", "2", "{BeforeLevelDesc}", "{AfterLevelDesc}", ResultType.SUCCESS, “MoneyCode”, “MoneyName”, 100);

Methods Detail – VMoneyChangeInfos

[VMoneyChangeInfos]

게임 머니의 양적 변화가 발생했을 때 호출하여 로그를 저장합니다.

• API Call Point 게임 머니를 획득 했을 때 게임 머니를 소비 했을 때 명예 포인트로 상점에서 아이템을 구매했을 때 컨텐츠를 진행하기 위해서 스테미너를 소비했을 때 길드에 기부하고 길드포인트를 획득했을 때

A. 게임 머니는 인게임에서 화폐의 가치로 사용되는 모든 재화를 지칭합니다. B. 단, 현금은 인게임 머니가 아닙니다. C. 게임 머니 – 골드 획득/소비 – 명예 포인트 획득/소비 – 도전 포인트 획득/소비 – 길드 포인트 획득/소비 – 게임을 진행하는 스테미너 획득/소비 D. 아이템에 의한 재화 수입/지출 로그가 발생시 해당 아이템의 ItemCode 와ItemName 정보를 ContentCode와ContentName 에 넣어주어야 합니다. E. 아이템에 의한 로그가 아닐시에는 ContentCode와 ContentName에 NULL로 기입해주셔야 합니다.**

• Enum Constants \ 게임 재화의 획득/소비 경로를 지정합니다.

• \ 게임머니 변화의 구분 값을 지정합니다.

• \

  게임 재화의 현금성/비현금성 재화 구분을 지정합니다.

• Method Description

• void ClearVMoneyChangeInfoList()

1. void AddVMoneyChangeInfoList(FlowType MoneyFlowType, string MoneyName, MoneyChangeType MoneyChangeType, string MoneyChangeDetail, string ContentName, string ContentCode, MoneyType MoneyType, long Amount, long HoldAmount, string MoneyChangeName = “”)

1. List GetVMoneyChangeInfoList()

1. void VMoneyChangeInfos(IEnumerable VMoneyChangeInfoList)

• Sample Source

• // {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", "ContentName", "ContentCode", MoneyType.EXP, 3000, 30000);

• scManager.AddVMoneyChangeInfoList(FlowType.IN, "MoneyName", MoneyChangeType.EVENTREWARD, "MoneyChangeDetail4", "ContentName", "ContentCode", MoneyType.EXP, 4000, 20000);

• scManager.AddVMoneyChangeInfoList(FlowType.IN, "MoneyName", MoneyChangeType.ETC, "MoneyChangeDetail5", "ContentName", "ContentCode", MoneyType.EXP, 5000, 10000, "MoneyChangeName");

• //재화 변경내역 전송

• StorageCoreManager.GetInstance().GetApi().VMoneyChangeInfos(scManager.GetVMoneyChangeInfoList());

Methods Detail – ItemChangeInfos

[ItemChangeInfos]

** 인게임 아이템의 양적 변화가 발생했을 때 호출하여 로그를 저장합니다.

· API Call Point 인게임 아이템을 획득했을 때 인게임 아이템을 소비했을 때 주의) 인게임 아이템은 유료아이템이 아닙니다.

A. 현금 ‘**패키지**’ 아이템을 구매하는 경우는 반드시 Buy Log**에 구매로그를 같이 저장해야 합니다**. B. 단**, 현금으로 무기**, 장신구**, 인 게임 머니를 구하는 것은 포함됩니다**. C. 가챠지표**(ItemChangeType = GACHA) 10 연뽑기의 경우라도 1 건의 획득 데이터만 들어가야합니다**.

10 개의 아이템 정보는 ItemsInfos에 10 건으로 적재합니다. 10 연뽑기와 1 회뽑기는 ContentCode 와 ContentName 은 각각 분리되어야 합니다. 10 연뽑기의 경우 획득 비용(MoneyAmount)이 10 분할로 저장되어야 합니다. 총 비용이 10000 골드라면 각 아이템 획득당 1000 골드씩 저장되어야 합니다.

D. 스테이지 획득 아이템 지표 StageName 정보가 있는 컨텐츠의 경우

(ItemChangeType = STAGEACTION, PVPACTION, PVEACTION, PVMPACTION, GUILDACTION, EVENTSTAGEACTION) ContentCode 와 ContentName에 스테이지의 유니크한 이름이 적재되어야 합니다. StageName 정보가 ContentActInfos.StageName과 동일해야하며, StageType이나 StageGrade가 다르더라도 StageName을 반드시 유니크하게 지정해주셔야 올바른 집계가 나올 수 있습니다.

E. 여러 캐릭터를 뽑기나 퀘스트를 통해 수집하는 게임의 경우 캐릭터의 강화도 아이템 변화 로그로 적재해주어야 올바른 집계가 나올 수 있습니다**.**

· Enum Constants** ** 아이템의 양적인 변화가 된 사유를 지정합니다**.**

**

· ** 아이템의 양적 변화의 구분 값을 지정합니다.

**

· Param Data Class** ** *A.** 획득한 아이템 각각의 정보를 저장합니다. *B.** 여러가지의 아이템을 획을/소비했을 경우 하나씩 모두 추가합니다**.

**

·

· Method Description**

**

\1. void ClearItemChangeInfoList()

\2. void AddItemChangeInfoList(FlowType ItemFlowType, ChangeType ItemChangeType, string ChangeDetail, string ContentName, string ContentCode, IEnumerable ItemsInfo, string ChangeName = “”)

\3. List GetItemChangeInfoList()

\4. void ClearItemChangeInfos()

\5. void AddItemChangeInfos(int ItemAmount,string ItemGrade, byte ItemImputeType,int ItemLevel,string ItemName,string ItemUniqueCode, string MoneyCode, string MoneyName, int MoneyAmount)

\6. List GetItemChangeInfos()

\7. void ItemChangeInfos(IEnumerable ItemChangeInfoList)

· Sample Source**

**

\1. // {MoneyName}의 게임 머니를 토글을 통해 획득한 경우

\2. StorageCoreManager scManager = StorageCoreManager.GetInstance();

\3.

\4. //획득한 아이템을 목록에 추가하기 위해서 목록을 초기화

\5. scManager.ClearItemChangeInfos ();

\6.

\7. //획득한 아이템을 추가

\8. scManager.AddItemChangeInfos (1, "B", 2, 1, "Wood Shield", "1001", "MoneyCode", "MoneyName", 100);

\9. scManager.AddItemChangeInfos (1, "A", 2, 1, "Iron Shield ", "1002", "MoneyCode", "MoneyName", 100);

\10.

\11. //아이템 변경내역 목록 초기화

\12. scManager.ClearItemChangeInfoList();

\13.

\14. //아이템 변경내역 추가

\15. scManager.AddItemChangeInfoList(FlowType.IN, ChangeType.BUY, "ChangeDetail1", "ContentName", "ContentCode", scManager.GetItemChangeInfos());

\16. scManager.AddItemChangeInfoList(FlowType.IN, ChangeType.COLLECT, "ChangeDetail2", "ContentName", "ContentCode", scManager.GetItemChangeInfos());

\17. scManager.AddItemChangeInfoList(FlowType.OUT, ChangeType.COUPON, "ChangeDetail3", "ContentName", "ContentCode", scManager.GetItemChangeInfos());

\18. scManager.AddItemChangeInfoList(FlowType.OUT, ChangeType.DEAL, "ChangeDetail4", "ContentName", "ContentCode", scManager.GetItemChangeInfos());

\19. scManager.AddItemChangeInfoList(FlowType.IN, ChangeType.ETC, "ChangeDetail5", "ContentName", "ContentCode", scManager.GetItemChangeInfos(), "ChangeName");

\20. //아이템 변경내역 전송

\21. StorageCoreManager.GetInstance ().GetApi ().ItemChangeInfos (scManager.GetItemChangeInfoList());

Methods Detail – ConnectInfos

[ConnectInfos]

로그인 / 로그아웃 또는 컨텐츠 진입 / 이탈 로그를 저장합니다.

· API Call Point 게임에 로그인 시점 게임에 로그아웃 시점 게임의 컨텐츠에 진입 시점 게임의 컨텐츠에서 이탈 시점

· 컨텐츠 정의 단순 접속 상태가 아닌 컨텐츠 요소가 있는 모든 항목을 지칭합니다.

A. RPG – 던전(요일, 레이드 등), PvP, 퀘스트, 길드 관리 등 B. SNG – 마을 관리, 소셜 컨텐츠 등 C. FPS – 빠른 대전, 경쟁전, 장비 관리 등 D. 퍼즐 – 스테이지, 덱 관리 등 (컨텐츠 항목을 세분화 할수록 좀더 정확한 유저 분석이 가능합니다)

· Enum Constants 컨텐츠의 형식을 정의합니다**.**

· 진입과 이탈**(컨텐츠) 형식을 정의합니다**.

·

· Sample Source 게임 로그인 또는 게임 로그아웃

\1. //게임 로그인

\2. StorageCoreManager.GetInstance().GetApi().ConnectInfos(ConnectType.APP, "Login", FlowType.IN);

\3. //게임 로그아웃

\4. StorageCoreManager.GetInstance().GetApi().ConnectInfos(ConnectType.APP, "Logout", FlowType.OUT);

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

\1. //스테이지1-1 진입

\2. StorageCoreManager.GetInstance().GetApi().ConnectInfos(ConnectType. CONTENT, “스테이지1-1”, FlowType.IN);

\3. //스테이지1-1 이탈

\4. StorageCoreManager.GetInstance().GetApi().ConnectInfos(ConnectType. CONTENT, “스테이지1-1”, FlowType.OUT);

Methods Detail – AdPerformInfos

[AdPerformInfos]

게임 앱 안에 노출되는 배너(광고, 이벤트, 공지)에 대한 정보를 저장합니다. 또한, 게임 앱 안에서 특정 업적(특정 레벨, 특정 퀘스트, 특정 스테이지 도달 등) 달성 정보를 조회하는 [이벤트 분석]에서도 사용되는 항목입니다. ThinkCore에서 [이벤트 분석]으로 사용하기 위해서는 ContentType.TRACK으로 지정하여 저장합니다.

• API Call Point 인게임 배너가 클라이언트에 노출되었을 경우 노출된 인게임 배너를 사용자가 클릭했을 경우 또는, 게임 내 특정 업적을 달성할 경우

  A. 업적 달성(Ex.업적 : 20레벨 달성) B. 이벤트 클리어(Ex. 이벤트 : 첫 결제 두배 보상 이벤트) C. 퀘스트 완료(Ex. 퀘스트 : 철제 단검을 만들자!) D. 특정 스테이지 도달(Ex. Chapter1 클리어, 스테이지 12-3 최초 클리어 등) 했을 경우

• Enum Constants ** A. 인게임에 노출하는 표시창의 형식을 지정합니다. B. 광고, 이벤트, 공지의 형식으로 구분하고, 화면에 표시(노출)될 때와 표시된 화면을 클릭할 때 두번을 저장합니다. C. 추적하고 싶은 특정 컨텐츠(업적 달성, 이벤트 클리어, 퀘스트 완료, 특정 스테이지 도달 등)가 있을 경우 TRACK으로 지정합니다.

• A. 시스템과 유저의 행위 형식을 지정합니다. B. 시스템에서 표시할 때와 유저가 클릭할 때로 나누어 지정합니다.

• Params Data Class\ A. 이벤트 참여 내용을 저장합니다. B. 이벤트에 단계가 있을 경우 사용합니다. C. 이벤트에 여러 단계가 있을 경우 하나하나 단계별로 로그를 저장합니다.

• Method Description

• string AdPerformInfos(ContentType PromoteContentType, AdsActType PromoteAdsActType, string PromoteContentName, string PromoteContent, string PromoteJoinKey, IEnumerable PromoteJoinContent, string ReferrerPageName)

1. void ClearJoinContents()

1. void AddJoinContents(int JoinChoice, int JoinLevel, int JoinStep)

1. List\ GetJoinContents()

• Sample Source

• 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");

Methods Detail – FriendshipInfos

[FriendshipInfos]

게임 내 친구 관련 정보를 저장합니다.

• API Call Point 친구 요청, 수락, 삭제, 거부, 제거 등 각 행동 이후 실행

• Enum Constants \ 친구 정보를 저장할 때 유저의 행위를 지정합니다.

• Method Description

• //유저에게 친구 요청, 친구 요청을 거부하고, 친구 요청을 수락하고, 친구를 삭제합니다.

• string FriendshipInfos(RequestType FriendRequestType, string FriendMemberId, string CharID, string FriendNickName, string FriendCharId, int FriendLevel)

• Sample Source

• //레벨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);