Version: 2022.3
언어: 한국어
Unity 애널리틱스 DataPrivacy API
애널리틱스 지표, 세그먼트, 용어

레거시 애널리틱스:Unity 애널리틱스 및 PIPL

중국의 전국 인민 대표 대회는 중국 시민의 개인정보 보호를 위해 개인정보 보호법(PIPL)을 통과시켰습니다. 이 법률은 2021년 11월 1일에 발효되며, 중국 내 플레이어는 개인정보 처리에 대한 옵트인 동의와 개인정보의 중국 외부 전송에 대한 옵트인 동의를 제공해야 합니다.

이 법률을 준수하기 위해 Unity는 중국 내 플레이어가 이 두 가지 모두에 대한 옵트인 동의를 제공하기 전까지 데이터 수집을 차단해야 합니다. 즉 2021년 11월 1일부터 중국 내 플레이어의 개인정보 처리가 중단됩니다. 개인정보에 의존하는 분석 보고 및 플레이어 참여 시스템은 중국 내 플레이어에 대해 이용할 수 없습니다.

애널리틱스 개인정보 보호 플러그인에는 이 두 가지 옵트인에 대한 플레이어 동의를 전달하는 관련 기능이 포함되어 있습니다. 개발자는 동의 절차를 활용하기 위해 Unity 개인정보 처리방침 레퍼런스와 함께 개인정보 보호 플러그인을 게임에 추가해야 합니다. 동의 절차가 완료되면 옵트인한 중국 내 플레이어에 대한 데이터 수집이 재개됩니다.

Unity 애널리틱스 개인정보 보호 플러그인

Unity 애널리틱스 개인정보 보호 플러그인을 사용하면 플레이어가 SDK의 데이터 수집을 제어할 수 있습니다. 이 플러그인은 Unity 애널리틱스 라이브러리 패키지에 포함되어 있습니다. Unity 에디터의 패키지 관리자(Window > Package Manager)를 사용하여 프로젝트에서 패키지가 활성화되었는지 다시 확인할 수 있습니다.

이 플러그인은 다음 플랫폼을 지원하지 않습니다.

  • Linux
  • Windows Phone
  • Tizen
  • Apple TV
  • Blackberry

참고: 2018.3 이전 버전의 Unity의 경우 Unity 에셋 스토어의 Unity 애널리틱스 개인정보 보호 에셋 패키지를 사용해야 합니다. 에셋 스토어 버전은 Unity 4.7, 5.1+, 2017.1+, 2018.1, 2018.2로 사용 가능합니다.

플레이어에게 동의 절차 제공

개인정보 보호 플러그인에는 사용자 인터페이스의 적절한 위치에 배치할 수 있는 Unity UI 버튼 프리팹이 포함되어 있습니다. 플레이어가 이 버튼을 클릭하면 웹 브라우저에서 플레이어 개인정보 보호 페이지가 열리고, 여기에서 플레이어는 다음을 제공할 수 있습니다.

1. 분석을 위해 개인정보를 수집하는 것에 대한 동의
2. 중국 본토 외부로 개인정보를 전송하는 것에 대한 동의

또한 개발자는 Data Privacy API를 사용하여 자체 사용자 인터페이스를 제공하고 플레이어 개인정보 보호 페이지를 열 수 있습니다.

중요: 플레이어가 브라우저의 팝업 차단 기능을 사용 중이라면 브라우저에서 개인정보 보호 페이지가 열리지 않을 수 있습니다. 브라우저에 따라 페이지가 차단되었음을 알리는 경우도 있고, 아무런 알림을 표시하지 않는 경우도 있습니다. 팝업 차단 기능이 설정되어 있으면 페이지가 열리지 않을 수 있음을 플레이어에게 알리는 메시지를 사용자 인터페이스에 추가하는 것도 좋습니다.

Unity 솔루션 구현

개인정보 보호 플러그인이 제공하는 UI 버튼을 구현하려면 다음 단계를 따르십시오.

  1. 씬에 캔버스 게임 오브젝트가 아직 없다면 새로 추가해야 합니다. 캔버스를 추가하면 Unity가 EventSystem을 자동으로 추가합니다.
  2. DataPrivacyButton 프리팹(Packages/Analytics Library/DataPrivacy 폴더에 있음)을 프로젝트 창에서 씬의 캔버스 게임 오브젝트로 드래그합니다.
  3. 필요에 따라 버튼의 포지션, 그래픽스, 텍스트를 조정합니다.
  4. 버튼은 Data Privacy API에 이미 연결되어 있으므로 중국 내 플레이어가 클릭하면 플레이어의 개인정보 관리 페이지가 웹 브라우저에서 열립니다.

참고: Packages 폴더의 버튼 프리팹은 읽기 전용 버전입니다. 씬 계층 구조에서 버튼 인스턴스를 변경할 수 있지만, 변경한 내용을 원본 프리팹에 다시 저장할 수는 없습니다.

커스텀 솔루션 구현

커스텀 사용자 인터페이스 버튼을 사용하는 경우 사용자의 개인정보 옵트인 페이지 URL을 요청한 후 해당 URL을 브라우저 또는 웹 뷰에서 열 수 있습니다.

  1. 플레이어에게 데이터 수집 및 전송에 대한 옵트인 기능을 알려주는 UI 컴포넌트를 생성합니다. 개인정보 보호 플러그인의 Packages/Analytics Library/DataPrivacy 폴더에 이 아이콘이 포함되어 있습니다. Unity는 Unity 게임에서 개인정보 보호 제어 컨트롤에 직면하는 플레이어에게 일관된 시각적 신호를 제공할 수 있도록 개인정보 보호 프롬프트에서 이 아이콘을 사용할 것을 권장합니다.
  2. 플레이어가 옵트인 또는 옵트아웃을 선택하면 DataPrivacy.FetchPrivacyUrl() 메서드를 호출합니다. 이 메서드는 네트워크 요청이 완료되면 호출되는 Action<string> 오브젝트를 가져옵니다. 네트워크 요청이 실패하는 경우 또 다른 Action<string> 함수를 선택적으로 전달할 수 있습니다.
  3. FetchPrivacyUrl() 요청에 대한 핸들러에서 Application.OpenURL() 메서드를 사용하여 브라우저에서 URL을 엽니다.

예를 들어, 다음 스크립트는 게임 오브젝트 클릭에 대한 반응으로 플레이어 개인정보 보호 페이지를 엽니다.

using System;
using UnityEngine;
using UnityEngine.Analytics;

public class OptOutHandler : MonoBehaviour {

    static void OnFailure(string reason)
    {
        Debug.LogWarning(String.Format("Failed to get data privacy page URL: {0}", reason));
    }

    void OnURLReceived(string url)
    {
        Application.OpenURL(url);
    }

    public void OpenDataURL()
    {
        DataPrivacy.FetchPrivacyUrl(OnURLReceived, OnFailure);
    }


    void OnMouseOver(){
        if(Input.GetMouseButtonUp(0)){
            OpenDataURL();
        }
    }
}

자세한 내용은 Unity 애널리틱스 DataPrivacy API 문서를 참조하십시오.

Unity 애널리틱스 DataPrivacy API
애널리틱스 지표, 세그먼트, 용어