迁移到版本 5.0.0
Update your code to migrate from Analytics SDK version 4.x to version 5.0.0.
阅读时间5 分钟最后更新于 1 个月前
新的 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()