DataPrivacy
클래스는 플레이어의 개인정보 관리 선택 옵션에 따라 Unity 애널리틱스 서비스를 설정합니다.
네임스페이스: UnityEngine.Analytics
public class DataPrivacy
DataPrivacy
클래스는 플레이어의 개인정보 보호 설정을 가져와서 이에 기반하여 애널리틱스 서비스를 자동으로 설정합니다.
FetchPrivacyUrl()
함수를 사용하여 플레이어의 개인정보 관리 페이지의 URL을 가져옵니다. URL을 열고 플레이어에게 개인정보 보호 설정 관리 옵션을 제공합니다.
This page details three functions:
사용할 Data Privacy API를 준비합니다.
public static void Initialize()
이 함수는 숨겨진 게임 오브젝트를 만들고 DataPrivacy
클래스의 인스턴스를 게임 오브젝트의 컴포넌트로 추가합니다.
Unity 5.1 이전 버전에서는 애플리케이션을 시작할 때 UnityAnalytics.StartSDK (projectId)
를 호출한 직후 Initialize()
를 호출합니다. 최신 버전의 Unity에서는 Initialize()
가 자동으로 호출됩니다.
Fetches the player’s current opt-out status and configures the Unity Analytics service.
public static void FetchOptOutStatus(Action<bool> optOutAction = null)
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);
플레이어의 개인정보 관리 페이지의 URL을 가져옵니다.
public static void FetchPrivacyUrl(Action<string> success, Action<string> failure = null)
Action<String> success
— URL을 성공적으로 검색하여 가져오면 호출되는 액션 오브젝트. 액션에 전달되는 문자열에 URL이 포함됩니다.
[옵션] Action<String> failure
— Unity가 URL을 검색하여 가져올 수 없을 때 호출되는 액션 오브젝트. 액션에 전달되는 문자열에 실패 이유가 포함됩니다.
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은 일정 시간 동안만 유효합니다. 반드시 URL을 열기 직전에 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.