迁移到版本 5.0.0
Update your code to migrate from Analytics SDK version 4.x to version 5.0.0.
阅读时间5 分钟最后更新于 12 天前
新的 Analytics SDK 5.0.0 版本对 SDK 初始化和同意流程进行了大量更改。本指南将帮助您了解这些更改。
注意
版本 5.0.0 中仍然存在旧版初始化和同意逻辑，以便在迁移期间向后兼容，但您应尽早切换到新版逻辑，以确保 SDK 按预期工作。旧版流程操作标有 属性，并将在 SDK 的未来版本中移除。
ObsoleteStartDataCollection()- 您已征得玩家同意根据相应数据隐私法规收集他们的数据。
- 与玩家相关的数据隐私法规不要求用户明确同意，但他们也没有明确选择退出。
- 玩家不受任何数据隐私法规的约束。
UnityServices.InitializeAsync()StartDataCollection()StopDataCollecton()注意
从新版或旧版流程调用方法时，这会将 SDK 锁定为仅接受与该流程关联的进一步调用。如果尝试同时从这两个流程调用方法，则会抛出异常。
初始化流程
以前，初始化流程如下：在 5.0.0 版之前的 SDK 版本中，服务初始化时会发出 Web 请求来查找玩家的位置（并确定玩家是否位于受某些隐私法规约束的区域）。如果此请求失败，则会在await UnityServices.InitializeAsync();List<string> requiredConsents = await AnalyticsService.Instance.CheckForRequiredConsents();if (consents.Count > 0){ // Show UI element asking the user for their consent // bool userGaveConsent = ... foreach (string legislationIdentifier in requiredConsents) { AnalyticsService.Instance.ProvideOptInConsent(identifier, userGaveConsent); }}
CheckForRequiredConsents()StartDataCollection()StartDataCollection()注意
如需更多有关正确遵守数据隐私法规的信息，请参阅我们的页面：数据隐私、遵循 GDPR 和 CCPA 以及遵循 PIPL。您还应该咨询自己的律师。
您可以在服务初始化后随时调用await UnityServices.InitializeAsync();// Show UI element asking the user for their consent OR retrieve prior consent from storage //bool userGaveConsent = ...if (userGaveConsent){ AnalyticsService.Instance.StartDataCollection();}
StartDataCollection()注意
SDK 处于休眠状态时记录的事件将被丢弃。这些事件不会保存到缓冲区供稍后调用 时进行发送。只有在您调用 后才会记录事件。
StartDataCollection()StartDataCollection()注意
现在会在调用 方法时记录启动事件（如 gameStarted 和 clientDevice），而不是在调用此方法之前记录。如果在单个会话中启动数据收集，然后停止并再次启动，这种情况下仅在第一个 中记录一次。
StartDataCollection()StartDataCollection()选择退出
以前，OptOut()StopDataCollection()RequestDataDeletion()注意
数据删除机制会继续尝试发送请求，直到请求成功，如有必要，甚至可以跨会话发送请求。Analytics SDK 使用 API 记住此状态，因此调用 可能会中断该过程。
PlayerPrefsPlayerPrefs.DeleteAll()RequestDataDeletion()