设置全局属性

Singular SDK 允许你定义额外的自定义属性，以便与应用程序发送的每个会话和事件一起发送到 Singular 服务器。这些属性可以代表有关用户、应用程序模式或状态或其他任何信息。一旦设置了这些属性，它们就可以作为报告中的维度，您可以用它们来细分数据。

例如，如果您有一个游戏应用程序，您可以定义一个名为 "级别 "的属性，并将其初始设置为 "0"。应用程序发送的任何会话和事件都将带有 "Level"："0".一旦用户等级提升，您就可以将该属性重置为 "1"，以此类推。然后，您就可以获得按用户等级分列的报告，包括会话、事件计数和收入数据。

• 您最多可以定义5 个全局属性。
• 它们会在应用程序运行期间持续存在（使用您给定的最新值），直到您取消设置或用户卸载应用程序。
• 每个属性的名称和值最长可包含200 个字符。如果您传递的属性名称或值较长，将被截断为 200 个字符。
• 全局属性可在用户级导出和回传中访问和使用。将来还会增加汇总报告支持。如果您有任何疑问，或对全局属性支持的更新感兴趣，请联系您的 Singular 客户成功经理！

实施

通过 SingularConfig 设置全局属性

如果你已经知道应用程序打开时的全局属性，请在初始化 SDK 之前使用withGlobalProperty方法通过SingularConfig 设置全局属性。

请注意，由于全局属性及其值会在应用程序运行期间持续存在，因此您要设置的属性可能已被设置为不同的值。使用overrideExisting 参数可告诉 SDK 是否用新值覆盖现有属性。

初始化后设置全局属性

在应用程序运行过程中的任何时候，都可以使用以下方法设置、取消设置和检索全局属性。

• 要设置全局属性，请使用setGlobalProperty方法。
• 要取消设置全局属性，请使用unsetGlobalProperty方法。
• 要获取全局属性，请使用getGlobalProperties方法。
• 要清除全局属性，请使用clearGlobalProperties方法。