Version: 2022.3
Analytics 事件参数
Legacy Analytics: Funnels

Analytics 事件限制

Note: Gaming Services Analytics is now available as a preview package. Gaming Services Analytics is an improved offering that allows you to easily understand game performance and player behaviors so you can make strategic decisions. See the documentation.

为了维持高效且响应迅速的服务,Analytics 会对游戏或应用程序的特定实例可发送的标准和自定义事件 (Standard and Custom Events) 数量施加限制。这些限制包括:

  • 每小时 100 个事件(每个游戏实例)。
  • 每个事件 10 个参数。
  • 在单个事件中发送 500 个字节或字符的数据,包括参数名称的字符串长度和参数值的字节大小或字符串长度。
  • 自定义事件名称 100 个字符。
  • Analytics Dashboard 仅显示给定日期的 5,000 个最常见的事件、参数、参数值组合(对于可分类的参数值)。

All of the AnalyticsEvent functions that send events, return a value from the AnalyticsResult enumeration. If an application exceeds one of the limits, the AnalyticsResult value identifies the specific error encountered:

AnalyticsResult 超出的限制
AnalyticsResult.TooManyRequests 每小时 100 个事件
AnalyticsResult.TooManyItems 每个事件 10 个参数
AnalyticsResult.SizeLimitReached 数据 500 字节或事件名称 100 个字符

注意:每个实例 100 个事件的限制是适合大多数 Unity Analytics 用户的默认值。如果您的游戏或应用程序需要更高的事件限制,请与 Analytics 支持团队联系以制定出符合您要求的限制。

单事件数据限制

在单个自定义事件或标准事件中,最多可以发送 500 个字符或字节的数据。此限制计算了所有参数名称的组合字符串长度以及参数值的以下大小(取决于数据类型):

C# 数据类型 Size
byte、ubyte 1
short、ushort 4(转换为 int)
Int、uint 4
long、ulong 8
float 8(转换为 double)
double 8
decimal 8(转换为 double)
string 字符串长度
object 调用 ToString() 后的字符串长度

例如,以下事件使用 67 个字节/字符的数据长度限制:

    Dictionary<string, object> data = new Dictionary<string, object>();
        data.Add("int_param", 32); // 9 个字符 + 4 个字节
        data.Add("bool_param", true); // 10 个字符 + 1 个字节
        data.Add("float_param", 3.3f); // 11 个字符 + 8 个字节
        data.Add("string_param", "String value"); // 12 个字符 + 12 个字符
        AnalyticsResult result = AnalyticsEvent.Custom("custom_event", data);

当您发送定义自身必需参数或可选参数的标准事件时,必需参数的名称和值的长度以及所有可选参数的长度都包含在 500 字节限制中,还包括所有自定义数据。

事件本身的名称长度不能超过 100 个字符,但此长度不计入事件数据的 500 字节限制。


  • 2018/10/14 添加页面
Analytics 事件参数
Legacy Analytics: Funnels