Version: 2018.2
Unity Analytics と EU の一般データ保護規則 (GDPR)
Analytics 指標、セグメント、用語

Unity Analytics DataPrivacy API

DataPrivacy クラスは、プレイヤーのデータプライバシー管理の選択に基づいて Unity Analytics を設定します。

NAMESPACE: UnityEngine.Analytics

    public class DataPrivacy

DataPrivacy クラスは自動的にプレイヤーのデータプライバシー状況を取得し、それに応じて Unity Analytics を設定します。

FetchPrivacyUrl() 関数を使用して、プレイヤーの個人データ管理ページの URL を取得します。URL を開いて、プレイヤーにデータのプライバシー設定を管理するオプションを提供します。

This page details three functions:

Initialize()

Data Privacy API を使用するための準備をします。

宣言

    public static void Initialize()

説明

この関数は、非表示のゲームオブジェクトを作成し、DataPrivacy クラスのインスタンスをコンポーネントとして加えます。

Unity 5.1 以前では、アプリケーション起動の早い段階で、理想的には UnityAnalytics.StartSDK (projectId) を呼び出した直後に Initialize() を呼び出します。それより新しいバージョンの Unity では、Initialize() の呼び出しは自動的に行われます。

FetchOptOutStatus(Action<bool>)

Fetches the player’s current opt-out status and configures the Unity Analytics service.

宣言

    public static void FetchOptOutStatus(Action<bool> optOutAction = null)

パラメーター

  • [optional] Action<bool> optOutAction — The Action object to invoke when Unity has fetched the player’s opt-out status. The boolean parameter passed to your Action is true if the player has opted out of personal data collection, and false if they have not.

説明

The function configures the Analytics service as appropriate for the player’s data collection choices. Unity caches the status for use when the player’s computer or device is offline.

Unity calls FetchOptOutStatus() automatically when your game launches. You should also call the function when the player returns to your app after closing the data privacy management URL, to immediately apply any changes they made while on that page.

You can also use FetchOptOutStatus() and pass an Action<bool> function parameter to get a player’s opt-out choice. The plug-in invokes the optOutAction function you provide when the network fetch request is complete. The boolean argument passed to your action is true when the player has opted out and false, if they have not. If the network request for the player’s status fails, Unity calls your optOutAction function with the cached value (or false, if the status has never been set).

    void OnOptOutStatus(bool optOut)
        {
            if(optOut)
            {
                Debug.Log("Player has opted-out of personal data collection.");
            }
        }

        // ...
        DataPrivacy.FetchOptOutStatus(OnOptOutStatus);

FetchPrivacyUrl(Action< String>、Action< String>)

プレイヤーの個人データ管理ページの URL を取得します。

宣言

    public static void FetchPrivacyUrl(Action<string> success, Action<string> failure = null)

パラメーター

  • Action<String> success — URL が正常に取得されたときに呼び出される Action オブジェクト。 Action に渡される文字列に URL を含みます。

  • [任意] Action<String> failure — URL を取得できない時に呼び出される Action オブジェクト。Action に渡される文字列に失敗した理由を含みます。

説明

Open the URL passed to your success function in a browser or webview to give the player the opportunity to manage their data protection options. Use Application.OpenURL() to open the page.

URL は短期間有効であるため、常に、開く直前に取得するようにしてください。

Call FetchOptOutStatus() after the player returns to your game to apply any changes immediately. Otherwise, Unity applies any changes to data collection the next time the player launches your game.


  • 2018–05–18 限られた 編集レビュー でパブリッシュされたページ
  • Data Privacy ボタンを加えるエディターメニューを削除。Data Privacy Button プレハブを追加
  • Unity 2018.1 の新機能
Unity Analytics と EU の一般データ保護規則 (GDPR)
Analytics 指標、セグメント、用語