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 çeşitli ayarlar vardır.

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

Android'de Özel Korumalı Alan, cihaz kullanıcılarının Gizlilik Koruma API'lerinin (PPAPI) ve SDK Çalışma Zamanı'nın kendi cihazlarında etkin olup olmadığını kontrol etmesine olanak tanır. Geliştirici Önizlemesi 5'ten 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 yapıları 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

Kullanıcı kontrolü varsayılan olarak cihazda devre dışıdır. Cihazınızda Özel Korumalı Alan API'sini ve SDK Çalışma Zamanı'nı etkinleştirmek için açma/kapatma düğmesine dokunun.

Cihazdaki Özel Korumalı Alan API beta sürümünü etkinleştirmek/devre dışı bırakmak için Android sayfası.
Android cihazda Özel Korumalı Alan kullanıcı denetimi kullanıcı arayüzü.

Cihazınızda Privacy Sandbox'ı etkinleştirme

Önceki bölümde, cihaz kullanıcısının cihazında Özel Korumalı Alan'ın çalışıp çalışmamasını seçmesi sağlanırken bu bölümde, geliştiricilerin adb komutlarını kullanarak cihazlardaki 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, aşağıdaki komutları çalıştırarak cihazda PPAPI erişimini 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ştirme

adb shell device_config put adservices disable_sdk_sandbox false

Kayıt sonrası adımlar

Kaydolma işlemini tamamladıktan sonra, cihazınızı Özel Korumalı Alan API'lerini kullanacak şekilde hazırlamak için birkaç ek adım uygulamanız gerekir.

Kayıt dosyasını cihazınıza zorla indirmek için aşağıdaki adımları uygulamanız gerekir:

  1. Özel Korumalı Alan Destek Ekibi'nden, kayıt hesabı kimliğinizi ve kayıt dosyasını gösteren bir URL 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) Üzerine yazma işleminin önceki adımda ayarlanan yolu döndürdüğünü doğrulayın.

    adb shell device_config get adservices mdd_measurement_manifest_file_url

  4. Gizliliği Koruyan API'lerden birinden 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ı 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ımda yaptığınız arama şimdi başarılı olacaktır.

Kayıt işlemini devre dışı bırakma

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

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"