분석 이벤트 확장 함수 설명
이 문서는 HTML5 게임 옵션을 통해 설정한 분석 제공자에게 지정된 텍스트를 전송하는 analytics_event_ext 함수에 대해 설명합니다. 이 함수는 사용 중인 제공자의 범위를 벗어난 내용을 추적하기 위해 사용자 정의 분석을 생성하는 데 사용할 수 있으며, 사용자 정의 매개변수/값 쌍도 수용합니다. 매개변수는 문자열이고 값은 실수입니다. Google Analytics의 경우 하나의 추가 쌍만 추가할 수 있으며, Flurry는 최대 7개까지 수용합니다.
함수 구문
analytics_event_ext(string, string_param, value);
매개변수 설명
| 매개변수 | 유형 | 설명 |
|---|---|---|
| string | String | 제공자에게 전송할 문자열입니다. |
| string_param | [0 - 9] String | 전송할 매개변수(문자열)입니다. |
| value | [0 - 9] Real | 매개변수의 값(실수)입니다. |
반환값
- N/A (반환값 없음)
활용 예제
아래 코드는 ini 파일에서 플레이 정보를 가져오고 현재 시간을 기록한 후, 이 정보를 분석 제공자에게 전송하는 예제입니다.
var num, time;
ini_open("Options.ini");
num = ini_read_real("Data", "Plays", 0);
num += 1;
time = current_time;
analytics_event_ext(GAME_NAME, "Plays", num, "Time", time);
ini_write_real("Data", "Plays", num);
ini_close();
이 코드는 Options.ini 파일에서 "Plays" 데이터를 읽고, 플레이 수를 증가시키며, 현재 시간을 기록한 후, 이를 분석 제공자에게 전송합니다.
추가 활용 예제
- 사용자 행동 추적
gml analytics_event_ext("UserAction", "ButtonClicked", 1); - 게임 레벨 완료 기록
gml analytics_event_ext("LevelCompletion", "Level", current_level); - 아이템 구매 기록
gml analytics_event_ext("ItemPurchase", "ItemID", purchased_item_id); - 게임 세션 시간 기록
gml analytics_event_ext("SessionTime", "Duration", session_duration); - 특정 이벤트 발생 기록
gml analytics_event_ext("SpecialEvent", "EventName", 1);
이와 같이 analytics_event_ext 함수를 활용하여 다양한 사용자 행동 및 게임 이벤트를 추적할 수 있습니다.