Dukungan IAB AS

Panduan ini menguraikan langkah-langkah yang diperlukan untuk mendukung pesan peraturan negara bagian Amerika Serikat sebagai bagian dari UMP SDK. Gabungkan petunjuk ini dengan Memulai, yang menjelaskan cara menjalankan aplikasi dengan UMP SDK dan menyiapkan pesan. 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 Amerika Serikat, sebaiknya gunakan versi 2.1.0 atau yang lebih tinggi.
• Selesaikan Mulai. Pastikan untuk menerapkan titik entri opsi privasi dan merendernya jika diperlukan. Dengan menyelesaikan panduan ini, Anda memiliki titik entri untuk menayangkan pesan peraturan negara bagian Amerika Serikat kepada pengguna.
• Membuat 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.

Menetapkan tag untuk pengguna di bawah usia dewasa

Untuk menunjukkan apakah pengguna berusia di bawah usia dewasa, tetapkan setTagForUnderAgeOfConsent (TFUA). Saat Anda menetapkan TFUA ke true, UMP SDK tidak 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 untuk mematuhi COPPA dan peraturan relevan lainnya.

Penting: UMP SDK tidak meneruskan tag TFUA yang ditetapkan pada permintaan izin ke Google Mobile Ads SDK. Anda harus menetapkan tagForUnderAgeOfConsent atau tagForChildDirectectedTreatment secara eksplisit pada permintaan iklan. Jika Anda tidak menetapkan tagForUnderAgeOfConsent atau tagForChildDirectectedTreatment pada permintaan iklan, UMP SDK tidak akan mengumpulkan informasi apa pun yang memungkinkan Google menentukan apakah pengguna di bawah usia dewasa menggunakan aplikasi Anda atau tidak. Untuk informasi selengkapnya tentang batasan pemrosesan data bagi pengguna ini, lihat Memberi tag pada permintaan iklan dari aplikasi untuk perlakuan untuk anak-anak.

Contoh berikut menetapkan TFUA ke benar 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 ->
      // ...
    })

Membaca pilihan izin

Setelah pengguna membuat keputusan peraturan negara bagian Amerika Serikat, Anda dapat membaca pilihan mereka 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

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 penekanan pesan peraturan negara bagian AS. Untuk mengetahui detail selengkapnya tentang debugGeography, lihat Memaksa geografi.

Catatan: UMPDebugGeographyRegulatedUSState hanya tersedia di UMP versi 3.1.0 atau yang lebih tinggi.