文档

​
​

Development

User Acquisition

Monetization

工业

Analytics

Analytics

LiveOps
​
​
Analytics
  • Overview
  • Get started
  • Pricing
  • Concepts
  • Tutorials
    • Create a custom event
    • Record an event
    • Record events with a custom user ID
    • Record transaction events
    • Record ad impression events
    • Copy custom events to another environment
    • Create a custom dashboard
    • Edit a custom dashboard
    • Create a funnel
    • Track user acquisition
    • Create a custom audience
    • Run a query with SQL Data Explorer
    • Query parameter values with SQL Data Explorer
    • Optimize SQL Data Explorer queries
    • Set up Data Access
    • Record an event with the REST API
    • Generate a unique user ID with the REST API
    • Request data deletion with the REST API
    • Debug event reporting
    • SDK 5.0.0 migration
    • Migrate to Unity 6.2 with Analytics SDK 6.1.0
    • Request game data deletion
  • Reference
  • Privacy and consent
  • FAQ
  1. Unity Analytics

自定义用户 ID 支持

Set a custom user identifier to match your external data systems and track players across multiple devices.
阅读时间2 分钟
最后更新于 9 个月前

对于通过 Analytics SDK 发送的 Analytics 事件,可以使用自定义用户 ID 功能。
您可以选择在应用程序生命周期中的任何时间点使用核心 UnityServices 包设置 Analytics 用户 ID。请使用以下代码:
using Unity.Services.Core;void Start(){ UnityServices.ExternalUserId = "some-user-id";}
设置自定义用户 ID 是完全可选的操作。如果未设置,SDK 会按正常方式生成用户 ID。如果在旧版 Analytics 处于打开状态时设置了自定义用户 ID,则结果会出现重复计数。请在使用自定义用户 ID 之前关闭旧版 Analytics。
设置自定义用户 ID 后记录的任何事件都会使用给定的值。以前记录的事件不会更新,而是保留原始值。请注意,更改用户 ID 会给每月活跃用户计数等指标带来新用户,因此可能会影响计费。
请注意,SDK 不会保存外部用户 ID 值。如果要在一段时间内为给定用户保持一致的自定义 ID,需要进行手动保存(例如使用
PlayerPrefs
),并在每次启动应用时进行设置。
  • 如果希望 Unity 为 Analytics 生成用户 ID,无需执行任何操作。
  • 如果要使用自定义 ID 与外部数据(例如,其他分析源)匹配,则需要在初始化 UnityServices 时设置
    ExternalUserId
    。
使用 ExternalUserId 能够为不同系统中的玩家群维护一致的标识符,并确保将内部数据与 Analytics 平台提供的数据联接起来。

GetAnalyticsUserID()

AnalyticsService.Instance.GetAnalyticsUserID()
您可以使用此方法获取当前用于事件的 ID:已设置的自定义 ID 或生成的安装 ID。

Copyright © 2026 Unity Technologies
法律信息隐私政策CookiesDocumentation Terms of Use请勿出售或分享我的个人信息您的隐私选择(Cookie 设置)

“Unity”、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属公司在美国和其他地方的商标或注册商标(此处查看更多信息)。其他名称或品牌是其各自所有者的商标。

为方便起见,一些页面是机器翻译的,可能包含不准确的内容。如有信息不一致的情况,以英文版本为准。

  • 在本页上
    • GetAnalyticsUserID()


报告此页面的问题