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

Cihazlar için etkinleştirebileceğiniz veya devre dışı bırakabileceğiniz çok sayıda ayar vardır geliştirmeyi öğreneceksiniz.

Özel Korumalı Alan kullanıcı kontrolü kullanıcı arayüzünü göster

Android'deki Özel Korumalı Alan, cihaz kullanıcılarının Gizliliği Koruyan API'ler (PPAPI) ve SDK Çalışma Zamanı şu uygulamalarda etkinleştirilmiş olmalıdır: kendi cihazlarıyla etkileşim kurabiliyorlar. Geliştirici Önizlemesi 5 sürümünden itibaren, Kullanıcı kontrol arayüzü varsayılan olarak devre dışıdır. Geliştirme ve test amacıyla kullanıcı kontrol arayüzünü etkinleştirmek isteyebilirsiniz. Kullanıcı kontrol arayüzünü etkinleştirmek için şu adb komutları:

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'si ve SDK Çalışma Zamanı, açma/kapatma anahtarına dokunun.

Cihazda Özel Korumalı Alan'ı etkinleştirme

Önceki bölümde, cihaz kullanıcısı kullanıcının kendi tercihine bağlı olarak Cihazlarında çalışan Özel Korumalı Alan'ın yüklü olduğu bu bölümde, bir geliştiricinin , adb komutlarını kullanarak bir cihazdaki API'leri etkinleştirebilir.

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 PPAPI erişimini etkinleştirebilir veya devre dışı bırakabilirsiniz cihazda aşağıdaki komutları çalıştırarak kontrol edebilirsiniz:

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ştirme

adb shell device_config put adservices disable_sdk_sandbox false

Kayıt sonrası adımlar

Kaydı tamamladığınızda tamamlamanız gereken birkaç ek adım bulunur. özel Korumalı Alan API'lerini kullanmaya hazır hale getirin.

Kayıt dosyasını cihazınıza zorunlu olarak aşağıdakilerle indirmeniz gerekiyor için şu adımları izleyin:

1. Özel Korumalı Alan Destek Ekibi'nden kaydınızla ilgili bir e-posta alacaksınız hesap kimliği ve kayıt dosyasını işaret eden bir URL.

2. Geliştirici Önizlemesi sürümünü çalıştıran cihazınızda kaydı geçersiz kılın bir liste oluşturabilirsiniz.

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

3. (İsteğe bağlı, ancak önerilir) Geçersiz kılmayı doğrula önceki adım.

   adb shell device_config get adservices mdd_measurement_manifest_file_url
   

4. Gizliliği Koruma API'lerinin birinden API çağrısı tetikleyin. (ör. registerSource() Attribution Reporting API'den, getTopics() Topics API veya Protected Audience API'den joinCustomAudience()) seçebilirsiniz. Bu çağrısının başarısız olması beklenir.

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 Koruyan API'leri çağırmaya başlayabilirsiniz. 4. Adım'da yaptığınız çağrı artık başarılı olacaktır.

Kaydı devre dışı bırak

Developer Preview sürümlerinde, Protected Audience ve Topics API'lerine erişebilirsiniz aşağıdaki kayıt devre dışı bırakma işlemini çalıştırarak kaydolmadan adb komutlarının ikisine katlanır.

Protected Audience

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"