커스텀 이벤트 스크립팅

AnalyticsTracker 컴포넌트를 사용하는 대신 Analytics.CustomEvent를 호출하여 스크립트를 통해 직접 커스텀 이벤트를 보낼 수 있습니다. 아래의 예제를 참조하십시오.

// Reference the Unity Analytics namespace
using UnityEngine.Analytics;

//  Use this call for wherever a player triggers a custom event
Analytics.CustomEvent(string customEventName,
IDictionary<string, object> eventData);

*Analytics.CustomEvent Input Parameters*
*Name*	*Type*	*Description*
customEventName	string	Name of custom event. Name cannot include the prefix “unity.” — This is a reserved keyword.
eventData	dictionary	Additional parameters sent to Unity Analytics at the time the custom event was triggered. eventData key cannot include the prefix “unity.” — This is a reserved keyword.

아래는 커스텀 이벤트에 대한 몇몇 주의 사항입니다.

이벤트 데이터의 각 파라미터는 동일한 데이터 타입을 가져야 합니다. 예를 들어, 레벨 파라미터를 숫자로 보내고 문자열으로 변경하지 말아야 합니다. 이러한 경우 오류가 동작하여 데이터 해석이 어렵게 됩니다.
- 부울(true/false)
- 문자열(문자)
- 숫자(정수, 실수 등)
커스텀 이벤트는 디폴트로 최대 10개의 파라미터를 가질 수 있습니다.
- 전달되는 파라미터가 그 이상인 경우 호출이 실패하며 AnalyticsResult.TooManyItems 값을 반환합니다.
사전 콘텐츠는 500자로 제한되어 있습니다.
- 이 값을 초과하여 전달되는 경우 호출이 실패하며 AnalyticsResult.SizeLimitReached 값을 반환합니다.
한 사용자당 1시간마다 사용할 수 있는 커스텀 이벤트의 수는 최대 100입니다.
- 이 값을 초과하여 호출되는 경우 호출이 실패하며 AnalyticsResult.TooManyRequests 값을 반환합니다.
애널리틱스 시스템에서 파라미터가 어떻게 해석되는지 고려해야 합니다.
- 모든 number, int, float는 문자열으로 보내졌을 경우에도 숫자로 해석됩니다.
- ’categorizable’로 간주되는 것은 문자열과 부울뿐입니다.
- 따라서 무언가의 합이나 평균을 구하고 싶은 경우 숫자로 보내야 합니다. 예를 들어, ’51’나 51로 보내면 됩니다. 레벨이나 옵션과 같이 분류를 원하는 경우에는 문자열으로 분석되도록 해야 합니다. 예를 들어 ’51’로 보내면 됩니다.

아래 예제를 통해 게임이 종료되는 시점에서 사용자의 인벤토리에 무엇이 있는지 파악할 수 있습니다.

// Reference the Collections Generic namespace
  using System.Collections.Generic;

  int totalPotions = 5;
  int totalCoins = 100;
  string weaponID = "Weapon_102";
  Analytics.CustomEvent("gameOver", new Dictionary<string, object>
  {
    { "potions", totalPotions },
    { "coins", totalCoins },
    { "activeWeapon", weaponID }
  });