API documentation
Analisis Metrik, Segmen, dan Terminologi

Analisis Unity dan PIPL

Kongres Rakyat Nasional Cina telah melewati Hukum Perlindungan Informasi Pribadi (PIPL), untuk melindungi privasi data warga Cina. Ini efektif mulai November 1st, 2021, dan membutuhkan pemain di Cina untuk memberikan persetujuan opt-in untuk data mereka diproses dan persetujuan opt-in untuk data mereka ditransfer di luar Cina.

Untuk mematuhi undang-undang ini, Unity harus memblokir pengumpulan data dari pemain di Cina sampai mereka memberikan persetujuan mereka untuk kedua opt-ins. Ini berarti bahwa dari tanggal 1 November 2021, data dari pemain di Cina akan berhenti diproses. Pelaporan AnalyticsUnity Analytics
Lihat di Glossary
dan sistem keterlibatan pemain bergantung pada data tidak akan tersedia untuk pemain di Cina.

Plugin Privasi Data Analytics berisi fungsi yang relevan untuk berkomunikasi persetujuan pemain untuk kedua opt-ins. Sebagai pengembang, Anda harus menambahkan plugin Privasi Data ke permainan Anda bersama dengan referensi Kebijakan Privasi Unity untuk memanfaatkan aliran persetujuan. Setelah aliran persetujuan ada di tempat, pengumpulan data akan melanjutkan untuk pemain di Cina yang memilih.

Analisis Unity Database

Plugin Privasi Data Unity Analytics memberikan kontrol pemain Anda atas pengumpulan data SDK. Plugin ini adalah bagian dari paket perpustakaan Unity Analytics. Anda dapat menggunakan Manajer Paket di Editor Unity (Window > Package Manager) untuk memeriksa ulang ganda bahwa paket diaktifkan dalam proyek.

Plugin tidak mendukung platform berikut:

  • Linux
  • Windows Server
  • Tizen
  • Apple TV
  • Blackberry

Note: Untuk versi Unity sebelum 2018.3, Anda harus menggunakan Unity AnalyticsSebuah platform data yang menyediakan analitik untuk permainan Unity Anda. More info
Lihat di Glossary
Data Privacy asset packageKoleksi file dan data dari proyek Unity, atau elemen proyek, yang dikompresi dan disimpan dalam satu file, mirip dengan file Zip, dengan ekstensi .unitypackage. Paket aset adalah cara praktis berbagi dan menggunakan proyek Unity dan koleksi aset. More info
Lihat di Glossary
dari . Versi Asset StoreSebuah perpustakaan yang berkembang dari aset gratis dan komersial yang diciptakan oleh Unity dan anggota komunitas. Menawarkan berbagai aset, dari tekstur, model dan animasi ke seluruh contoh proyek, tutorial dan ekstensi Editor. More info
Lihat di Glossary
dapat digunakan dengan Unity 4.7, 5.1+, 2017.1+, 2018.1, dan 2018.2.

Menghadirkan persetujuan mengalir ke pemain

Plugin Privasi Data mencakup tombol Unity UI(User Interface) Memungkinkan pengguna untuk berinteraksi dengan aplikasi Anda. Unity saat ini mendukung tiga sistem UI. More info
Lihat di Glossary
prefabJenis aset yang memungkinkan Anda untuk menyimpan GameObject lengkap dengan komponen dan properti. Prefab bertindak sebagai template dari mana Anda dapat membuat instance objek baru di tempat kejadian. More info
Lihat di Glossary
, yang dapat Anda tempatkan di lokasi yang sesuai dari antarmuka pengguna Anda. Ketika pemain mengklik tombol ini, membuka halaman Privasi Data Pemain di browser web di mana pemain dapat memilih untuk persetujuan berikut:

1. Consent to collect data for analytics.
2. Consent to transfer data outside of mainland China.

Pengembang juga dapat menyediakan antarmuka pengguna mereka sendiri dan membuka halaman Privasi Data Pemain menggunakan .

Important: Jika pemain memiliki blocker pop-up browser diaktifkan, browser mereka dapat mencegah halaman privasi data dari pembukaan. Beberapa browser mencatat bahwa halaman telah diblokir, tetapi yang lain tidak memberikan pemberitahuan sama sekali. Pertimbangkan menambahkan pesan di antarmuka pengguna Anda yang memperingatkan pemain bahwa blocker pop-up dapat mencegah halaman dari pembukaan.

Menerapkan solusi Unity

Untuk menerapkan Data Privacy plugin-provided UI button:

  1. Jika Anda belum memiliki Area yang berisi semua elemen UI di tempat kejadian. Area Canvas ditampilkan sebagai persegi panjang di Tampilan Adegan. More info
    Lihat di Glossary
    GameObjectObjek mendasar dalam adegan Unity, yang dapat mewakili karakter, props, pemandangan, kamera, waypoints, dan banyak lagi. Fungsi GameObject didefinisikan oleh Komponen yang melekat padanya. More info
    Lihat di Glossary
    di SceneAdegan berisi lingkungan dan menu permainan Anda. Pikirkan setiap file Adegan unik sebagai tingkat yang unik. Di setiap Adegan, Anda menempatkan lingkungan, hambatan, dan dekorasi, pada dasarnya merancang dan membangun permainan Anda dalam potongan-potongan. More info
    Lihat di Glossary
    Anda, Anda harus menambahkan satu. Unity secara otomatis menambahkan ketika Anda menambahkan Canvas.
  2. Seret prefab DataPrivacyButton dari folder Project windowJendela yang menunjukkan isi folder Assets (Project tab) More info
    Lihat di Glossary
    (dalam folder Packages/Analytics Library/DataPrivacy) ke Canvas GameObject di Adegan Anda.
  3. Sesuaikan posisi, grafik, dan teks tombol yang diperlukan.
  4. Tombol sudah terhubung ke API privasi data, sehingga ketika pemain yang terletak di Cina klik di halaman manajemen data pribadi pemain akan terbuka di browser web.

Sitemap Versi dari tombol prefab di bawah folder Note: dibaca. Anda dapat membuat perubahan pada kasus tombol di hierarki Adegan, tetapi Anda tidak dapat menyimpan perubahan tersebut kembali ke prefab asli.Packages folder is read-only. You can make changes to the instance of the button in the Scene hierarchy, but you cannot save those changes back to the original prefab.

Menerapkan solusi kustom

Jika Anda menggunakan tombol antarmuka kustom, Anda dapat meminta URL halaman opt-in data pengguna, lalu buka URL di browser atau tampilan web:

  1. Buat komponen UI yang menginformasikan pemain kemampuan mereka untuk memilih untuk pengumpulan data dan transfer. Perhatikan bahwa plugin Privasi Data mencakup ikon di folder Packages/Analytics Library/DataPrivacy. Unity mendorong Anda untuk menggunakan ikon ini pada privasi data Anda untuk memberikan kue visual yang konsisten untuk pemain yang menemukan kontrol privasi data dalam permainan Unity.
  2. Ketika pemain memilih untuk memilih dalam atau keluar, sebut metode DataPrivacy.FetchPrivacyUrl(). Ini mengambil objek Action<string> yang membentang ketika permintaan jaringan selesai. Anda dapat secara opsional melewati fungsi Action<string> kedua untuk menangani kasus di mana permintaan jaringan gagal.
  3. Dalam handler Anda untuk permintaan FetchPrivacyUrl(), gunakan metode Application.OpenURL() untuk membuka URL di browser.

Sebagai contoh, script berikut membuka halaman Privasi Data Pemain dalam menanggapi klik GameObject:

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();
        }
    }
}

Lihat dokumentasi tentang informasi lebih lanjut.

API documentation
Analisis Metrik, Segmen, dan Terminologi