Dukungan IAB AS

Pilih platform: Android iOS Unity

Panduan ini menguraikan langkah-langkah yang diperlukan untuk mendukung pesan peraturan negara bagian AS sebagai bagian dari UMP SDK. Gabungkan petunjuk ini dengan Mulai, yang menjelaskan cara menjalankan aplikasi Anda dengan UMP SDK dan menyiapkan pesan Anda. Panduan berikut khusus untuk pesan peraturan negara bagian AS.

Prasyarat

Sebelum melanjutkan, pastikan Anda melakukan hal berikut:

  • Update ke UMP SDK versi terbaru. Untuk dukungan pesan peraturan negara bagian AS, sebaiknya gunakan versi 2.1.0 atau yang lebih tinggi.
  • Selesaikan Mulai. Pastikan untuk menerapkan titik entri opsi privasi dan menampilkannya jika diperlukan. Dengan menyelesaikan panduan ini, Anda memiliki titik entri untuk menayangkan pesan peraturan negara bagian AS kepada pengguna.
  • Buat pesan peraturan negara bagian AS untuk aplikasi.
  • Jika Anda menggunakan pesan peraturan negara bagian AS bersama dengan pesan lainnya, lihat Jenis pesan pengguna yang tersedia untuk memahami kapan pesan yang berbeda ditampilkan kepada pengguna Anda.

Untuk menunjukkan apakah pengguna berusia di bawah usia dewasa, tetapkan setTagForUnderAgeOfConsent (TFUA). Jika Anda menyetel TFUA ke true, UMP SDK tidak akan meminta izin dari pengguna. Jika aplikasi Anda memiliki audiens campuran, tetapkan parameter ini untuk pengguna anak-anak guna memastikan izin tidak diminta. Anda bertanggung jawab untuk menetapkan parameter ini jika diperlukan agar mematuhi COPPA dan peraturan lain yang relevan.

Contoh berikut menetapkan TFUA ke benar (true) pada permintaan izin UMP:

Java

ConsentRequestParameters params = new ConsentRequestParameters
    .Builder()
    // Indicate the user is under age of consent.
    .setTagForUnderAgeOfConsent(true)
    .build();

consentInformation = UserMessagingPlatform.getConsentInformation(this);
consentInformation.requestConsentInfoUpdate(
    this,
    params,
    (OnConsentInfoUpdateSuccessListener) () -> {
      // ...
    },
    (OnConsentInfoUpdateFailureListener) requestConsentError -> {
      // ...
    });

Kotlin

val params = ConsentRequestParameters
    .Builder()
    // Indicate the user is under age of consent.
    .setTagForUnderAgeOfConsent(true)
    .build()

consentInformation = UserMessagingPlatform.getConsentInformation(this)
consentInformation.requestConsentInfoUpdate(
    this,
    params,
    ConsentInformation.OnConsentInfoUpdateSuccessListener {
      // ...
    },
    ConsentInformation.OnConsentInfoUpdateFailureListener {
      requestConsentError ->
      // ...
    })

Setelah pengguna membuat keputusan terkait peraturan negara bagian Amerika Serikat, Anda dapat membaca pilihannya dari penyimpanan lokal dengan mengikuti spesifikasi Global Privacy Platform (GPP). Untuk mengetahui detail selengkapnya, lihat Detail Dalam Aplikasi. Perhatikan bahwa UMP SDK hanya mengisi kunci IABGPP_GppSID dan IABGPP_HDR_GppString.

Menguji pesan peraturan negara bagian AS Anda

Untuk menguji pesan peraturan negara bagian AS, gunakan UMPDebugGeographyRegulatedUSState debugGeography untuk memaksa UMP SDK memperlakukan perangkat pengujian Anda seolah-olah perangkat tersebut berada di negara bagian AS yang diatur. Anda juga dapat menggunakan UMPDebugGeographyOther untuk memaksa peniadaan pesan peraturan negara bagian AS. Untuk mengetahui detail selengkapnya tentang debugGeography, lihat Memaksakan geografi.