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

Android'de Özel Korumalı Alan çalıştıran cihazlar için etkinleştirebileceğiniz veya devre dışı bırakabileceğiniz birkaç ayar vardır.

Özel Korumalı Alan kullanıcı kontrol kullanıcı 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ı kontrolü kullanıcı arayüzünü etkinleştirmek için aşağıdaki adb komutlarını kullanın:

Beta ve üretim derlemeleri için:

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

Geliştirici Önizlemeleri için:

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

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.

Şema
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 cihazdaki API'leri nasıl etkinleştirebileceği açıklanmaktadır.

Cihazda PPAPI'yi etkinleştirme

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 msmt_api_app_allow_list \"\*\" // for attribution
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ştir

adb shell device_config put adservices disable_sdk_sandbox false

Kayıt sonrası adımlar

Kaydı tamamladığınızda, 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 hesabı 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) Geçersiz kılma işlemini doğrulama, önceki adımda ayarlanan yolu döndürür.

    adb shell device_config get adservices mdd_measurement_manifest_file_url
    
  4. Gizliliği Koruma API'lerinin 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 çağrı 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 kaydolmadan 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"