Version: 2022.3
언어: 한국어
애널리틱스 이벤트 파라미터
레거시 애널리틱스:퍼널

애널리틱스 이벤트 제한

참고:게임밍 서비스 분석은 현재 프리뷰 패키지로 제공됩니다.게이밍 서비스 분석은 게임 성능과 플레이어 행동을 쉽게 파악하여 전략적 결정을 내릴 수 있도록 해주는 개선된 서비스입니다.문서를 참조하십시오.

효율적이고 응답이 빠른 서비스를 유지하기 위해 애널리틱스는 게임 또는 애플리케이션의 특정 인스턴스가 전송할 수 있는 스탠다드 및 커스텀 이벤트에 다음과 같은 제한을 부여합니다.

  • 시간당 100개 이벤트(게임 인스턴스당)
  • 이벤트당 10개 파라미터
  • 단일 이벤트에서 전송되는 500바이트/문자의 데이터. 여기에는 파라미터 이름의 문자열 길이와 파라미터 값의 바이트 크기 또는 문자열 길이가 포함됩니다.
  • 100자의 커스텀 이벤트 이름.
  • 애널리틱스 대시보드는 특정 일에 자주 발생하는 이벤트, 파라미터, 파라미터 값 조합(카테고리화할 수 있는 파라미터 값)을 최대 5,000개까지만 표시합니다.

이벤트를 전송하는 모든 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바이트 제한 계산에 포함되지 않습니다.


  • 페이지 추가됨 10/14/2018
애널리틱스 이벤트 파라미터
레거시 애널리틱스:퍼널