バージョン 5.0.0 への移行
Update your code to migrate from Analytics SDK version 4.x to version 5.0.0.
読み終わるまでの所要時間 2 分最終更新 15日前
Analytics SDK の新しい 5.0.0 バージョンには、SDK の初期化と同意フローに対する多数の変更が含まれています。このガイドは、これらの変更のナビゲートに役立ちます。
注
移行中は後方互換性のために従来の初期化と同意のロジックがバージョン 5.0.0 にまだ存在しますが、SDK が意図したとおりに動作するように、できるだけ早く新しいロジックに切り替える必要があります。従来のフロー操作は 属性でマークが付けられ、SDK の将来のバージョンで削除されます。
ObsoleteStartDataCollection()- 影響を及ぼす適切なデータプライバシー法の下でデータの収集に対する同意をプレイヤーに求め、同意を得た。
- プレイヤーは、明示的な同意を必要としないデータプライバシー法の影響を受け、明示的にオプトアウトしていない。
- プレイヤーは、どのデータプライバシー法の影響も受けない。
UnityServices.InitializeAsync()StartDataCollection()StopDataCollecton()注
新しいフローまたは古いフローからメソッドを呼び出すと、SDK はそのフローに関連付けられている呼び出しのみを受け入れるようにロックされます。両方のフローからメソッドを呼び出そうとした場合、例外がスローされます。
初期化フロー
以前は、初期化フローは以下のようなものでした。バージョン 5.0.0 より前のバージョンの SDK では、サービスの初期化により、プレイヤーの場所を調べる (また、プレイヤーが特定のプライバシー法の対象となる地域にいるかどうかを判断する) ウェブリクエストが行われます。このリクエストに失敗した場合は、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 などの起動イベントは、 メソッドが呼び出されたときに記録されるようになりましたが、以前はそうではありませんでした。データ収集が開始してから、単一セッション内で停止して再度開始した場合、それらは最初の で 1 回のみ記録されます。
StartDataCollection()StartDataCollection()オプトアウト
以前は、OptOut()StopDataCollection()RequestDataDeletion()注
データの削除メカニズムは、必要に応じてセッションをまたがっても、成功するまでリクエストの送信を試行し続けます。Analytics SDK は、 API を使用してこのステータスを記憶するため、 を呼び出すとプロセスが混乱する可能性があります。
PlayerPrefsPlayerPrefs.DeleteAll()RequestDataDeletion()