메소드 구조

텐투플레이의 이벤트 메소드는 플레이어의 게임 행동을 수집하기 위하여 문장 형태로 이루어져있습니다.
예를 들어

• 플레이어 XYZ가 ABC캐릭터로 플레이를 하면서
• "마법의검"을 강화하기 위해 골드 50개를 사용하였고,
• 이로 인해 골드 1270개가 남았을 경우

다음과 같이 작성합니다.

UseCurrency(player_uuid: "XYZ", //플레이어 XYZ가
character_uuid: "ABC", //ABC 캐릭터로 플레이 하였음
currency_slug: "GOLD", // 골드를
currency_quantity: 50, //5개 사용
currency_total_quantity: 1270, //골드 1270개가 남음
where_to_entity: entity.LevelUpEquipment // 장비 레벨업에 사용함
where_to_category_slug: "검", //장비의 카테고리는 검
where_to_slug : "마법의검"); //레벨업한 장비는 마법의 검

Where, How, Why

플레이어의 행동을 문장으로 나타낼 때 중요한 것은 플레이어가 "어디서" "어떻게" "왜" 행동하였는지를 이벤트 메소드로 최대한 기술하는 것입니다.

이를 나타내기 위해서 사용하는 파라미터로는

• from_entity (from_category_slug, from_slug)
• where_to_entity (where_to_category_slug, where_to_slug)
• placed_at (placed_at_slug)

이 있습니다.

1. from_entity

캐릭터, 펫, 아이템, 재화 등을 획득하는 Get 메소드에서 어떤 행동을 통해서 플레이어가 획득하였는지를 나타냅니다. 이때 다른 메소드를 파라미터 from_entity의 값으로 사용합니다.

(예시)

GetEquipment(player_uuid: "XYZ", //플레이어 XYZ가
character_uuid: "ABC", //ABC 캐릭터로 플레이 하였음
item_slug: "마법의검", // 마법의 검을
item_quantity: 1, //1개 획득
from_entity: entity.PlayStage //스테이지 플레이할 때 획득함
from_category_slug: "비밀의 숲" // 스테이지 카테고리는 비밀의 숲
from_slug: "비밀의 숲 1-2"); // 비밀의 숲 1-2 스테이지에서 획득함

2. where_to_entity

아이템, 재화 등을 소비하는 Use 메소드에서 무엇을 하기 위해서 플레어가 소비하였는지를 나타냅니다. 이때 다른 메소드를 where_to_entity의 파라미터로 사용합니다.

(예시)

UseCurrency(player_uuid: "XYZ", //플레이어 XYZ가
character_uuid: "ABC", //ABC 캐릭터로 플레이 하였음
currency_slug: "DIAMOND", // 다이아몬드를
currency_quantity: 50, //50개 사용
currency_total_quantity: 30, //다이아몬드 30개가 남음
where_to_entity: entity.ShopPurchase // 인앱구매에 사용함
where_to_category_slug: "상점", //구매한 곳의 카테고리는 상점
where_to_slug : "GOLD 2000"); //상점에서 골드 2000 패키지를 구매

3. placed_at

플레이어가 광고를 보는 위치 및 시점을 나타냅니다. 이때 다른 메소드를 placed_at의 파라미터로 사용합니다.

(예시)

WatchAd(player_uuid: "XYZ", //플레이어 XYZ가
character_uuid: "ABC", //ABC 캐릭터로 플레이 하였음
ad_slug: "abcsef0293828zks", // 광고 ID "abcsef0293828zks"
ad_type: adType.Interstitial, //전면광고
placed_at: adPlacement.LoginApp, //게임 로그인하면 나타남
ad_status: adStatus.Start // 광고 시작
placed_at_slug: "로비"); //로비에 광고가 나타남