효율적이고 응답이 빠른 서비스를 유지하기 위해 애널리틱스는 게임 또는 애플리케이션의 특정 인스턴스가 전송할 수 있는 스탠다드 및 커스텀 이벤트에 다음과 같은 제한을 부여합니다.
이벤트를 전송하는 모든 AnalyticsEvent 함수는 AnalyticsResult 열거형에서 값을 반환합니다. 애플리케이션이 이러한 제한 중 하나를 초과하면 AnalyticsResult
값이 발생하는 특정 오류를 식별합니다.
AnalyticsResult |
Limit Exceeded |
---|---|
AnalyticsResult.TooManyRequests |
시간당 100개 이벤트 |
AnalyticsResult.TooManyItems |
이벤트당 10개 파라미터. |
AnalyticsResult.SizeLimitReached |
500바이트의 데이터 또는 100자의 이벤트 이름 |
참고: 인스턴스당 100개 이벤트 제한은 대부분의 Unity 애널리틱스 사용자에게 적합한 기본값입니다. 게임이나 애플리케이션에 더 높은 이벤트 제한이 필요하면 애널리틱스 지원 팀에 연락하여 요구사항에 맞는 제한을 알아보십시오.
단일 커스텀 또는 스탠다드 이벤트의 일부로 최대 500바이트/문자의 데이터를 전송할 수 있습니다. 이 제한은 모든 파라미터 이름의 결합된 문자열 길이와 파라미터 값의 다음 크기(데이터 타입에 따라 다름)를 계산합니다.
C# 데이터 타입 | Size |
---|---|
byte, ubyte | 1 |
short, ushort | 4(int로 전환됨) |
Int, uint | 4 |
long, ulong | 8 |
float | 8(double로 전환됨) |
double | 8 |
decimal | 8(double로 전환됨) |
문자열 | 문자열 길이 |
object |
ToString() 호출 후 문자열 길이 |
예를 들어 다음 이벤트는 67바이트/문자의 데이터 길이 제한을 사용합니다.
Dictionary<string, object> data = new Dictionary<string, object>();
data.Add("int_param", 32); // 9 characters + 4 bytes
data.Add("bool_param", true); // 10 characters + 1 byte
data.Add("float_param", 3.3f); // 11 characters + 8 bytes
data.Add("string_param", "String value"); // 12 characters + 12 characters
AnalyticsResult result = AnalyticsEvent.Custom("custom_event", data);
자체적으로 필수 또는 옵션 파라미터를 정의하는 스탠다드 이벤트를 전송하면 이벤트 길이, 필수 및 옵션 파라미터 값이 다른 커스텀 데이터와 함께 500바이트 제한에 포함됩니다.
이벤트 이름 길이 자체는 100자를 초과할 수 없지만, 이 길이는 이벤트 데이터의 500바이트 제한 계산에 포함되지 않습니다.