Cihazları Android'de Özel Korumalı Alan'ı kullanacak şekilde yapılandırma

Android'de Özel Korumalı Alan dokümanlarını okurken, çalıştığınız program sürümünü seçmek için Geliştirici Önizlemesi veya Beta düğmesini kullanın (talimatlar farklı olabilir).

Özel Korumalı Alan kullanıcı kontrol arayüzünü görüntüleme

Android'deki Özel Korumalı Alan, cihaz kullanıcılarının Gizliliği Koruyan API'ler (PPAPI) ve SDK Çalışma Zamanı'nın kendi cihazlarında etkinleştirilip etkinleştirilmeyeceğini kontrol etmelerine olanak tanır. Geliştirici Önizlemesi 5 sürümünden itibaren kullanıcı kontrolü kullanıcı arayüzünü görüntüleme ayarı varsayılan olarak devre dışıdır. Geliştirme ve test amacıyla, kullanıcı kontrol kullanıcı arayüzünü etkinleştirmek isteyebilirsiniz. Kullanıcı denetimi kullanıcı arayüzünü etkinleştirmek için aşağıdaki adb komutunu kullanın:

adb shell am start -n com.google.android.adservices.api/com.android.adservices.ui.settings.AdServicesSettingsActivity

Varsayılan olarak, cihazda kullanıcı denetimi devre dışıdır. Cihazda Özel Korumalı Alan API'sini ve SDK Çalışma Zamanı'nı etkinleştirmek için açma/kapatma anahtarına dokunun.

Diyagram
Şekil 1. Android cihazda Özel Korumalı Alan kullanıcı kontrol arayüzü.

Cihazda Özel Korumalı Alan'ı etkinleştir

Önceki bölüm, cihaz kullanıcısının cihazında Özel Korumalı Alan'ın çalışmasını isteyip istemediğini seçmesine olanak tanırken bu bölümde geliştiricinin, adb komutlarını kullanarak cihazda API'leri nasıl etkinleştirebileceği açıklanmıştır.

Cihazda PPAPI'yi etkinleştirin

PPAPI'yi etkinleştirme

adb shell device_config put adservices ppapi_app_allow_list \"\*\"
adb shell device_config put adservices ppapi_app_signature_allow_list \"\*\"
adb shell device_config put adservices adservice_system_service_enabled true
adb shell device_config put adservices adservice_enabled true
adb shell device_config put adservices adservice_enable_status true

PPAPI'yi devre dışı bırakma

Geliştirme ve test amacıyla, cihazda PPAPI erişimini aşağıdaki komutları çalıştırarak etkinleştirebilir veya devre dışı bırakabilirsiniz:

Etkinleştirmek için false olarak ayarlayın:

adb shell device_config put adservices global_kill_switch false

Devre dışı bırakmak için true olarak ayarlayın:

adb shell device_config put adservices global_kill_switch true

Cihazda SDK Çalışma Zamanı'nı etkinleştirin

adb shell device_config put adservices disable_sdk_sandbox false

Kayıt sonrası adımlar

Kayıt işlemini tamamladıktan sonra, cihazınızı Özel Korumalı Alan API'lerini kullanmaya hazırlamak için uygulamanız gereken birkaç adım daha vardır.

Aşağıdaki adımları uygulayarak kayıt dosyasını cihazınıza zorunlu olarak indirmeniz gerekir:

  1. Özel Korumalı Alan Destek Ekibi'nden kayıt hesap kimliğinizi ve kayıt dosyasına yönlendiren bir URL'yi içeren bir e-posta alırsınız.

  2. Geliştirici Önizleme sürümünü çalıştıran cihazınızda bu komutu kullanarak kayıt listesini geçersiz kılın.

    adb shell device_config put adservices mdd_measurement_manifest_file_url
"<insert URL provided>"

  3. (İsteğe bağlı, ancak önerilir) Doğrulama geçersiz kılma işlemi, önceki adımda ayarlanan yolu döndürür.

    adb shell device_config get adservices mdd_measurement_manifest_file_url

  4. Gizliliği Korumaya Yönelik API'lerin birinden bir API çağrısı tetikleyin. (ör. Attribution Reporting API'den registerSource(), Topics API'den getTopics() veya Protected Audience API'den joinCustomAudience()). Bu çağrının başarısız olması beklenmektedir.

  5. İndirme işini zorla çalıştırın.

    adb shell cmd jobscheduler run -f com.google.android.adservices.api  14

  6. Artık Geliştirici Önizlemesi'nde Gizliliği Koruma API'lerini çağırmaya başlayabilirsiniz. 4. adımda yaptığınız arama artık başarılı olacaktır.

Kaydı devre dışı bırak

Geliştirici Önizlemesi sürümlerinde aşağıdaki kaydı devre dışı bırakma adb komutlarını çalıştırarak, kayıt olmadan Protected Audience ve Topics API'lerine erişebilirsiniz.

Korunan Kitle

adb shell setprop debug.adservices.disable_fledge_enrollment_check true

Konular

adb shell setprop debug.adservices.disable_topics_enrollment_check true

İlişkilendirme Raporları

adb shell device_config put adservices disable_measurement_enrollment_check "true"