Konfigurowanie urządzeń do korzystania z Piaskownicy prywatności na Androida

Na urządzeniach z Androidem, na których działa Piaskownica prywatności, możesz aktywować lub dezaktywować kilka ustawień.

Wyświetlanie interfejsu użytkownika Piaskownicy prywatności

Piaskownica prywatności na Androida umożliwia użytkownikom urządzeń kontrolowanie, czy interfejsy API chroniące prywatność (PPAPI) i środowisko wykonawcze SDK są włączone na ich urządzeniach. Od wersji 5 wersji dla deweloperów ustawienie wyświetlania interfejsu sterowania użytkownika jest domyślnie wyłączone. Do celów programistycznych i testowania możesz włączyć interfejs użytkownika. Aby włączyć interfejs użytkownika, użyj tych poleceń adb:

W przypadku wersji beta i produkcyjnych:

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

Wersje przedpremierowe dla programistów:

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

Domyślnie kontrola użytkownika jest dezaktywowana na urządzeniu. Aby włączyć interfejs API i środowisko wykonawcze SDK Piaskownicy prywatności na urządzeniu, kliknij przełącznik.

Włączanie Piaskownicy prywatności na urządzeniu

W poprzedniej sekcji użytkownik urządzenia mógł wybrać, czy chce, aby Piaskownica prywatności działała na jego urządzeniu. W tej sekcji wyjaśniamy, jak deweloper może włączyć interfejsy API na urządzeniu za pomocą poleceń adb.

Włączanie PPAPI na urządzeniu

Włączanie PPAPI

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

Dezaktywowanie PPAPI

W celu tworzenia i testowania możesz aktywować lub dezaktywować dostęp PPAPI na urządzeniu, uruchamiając te polecenia:

Ustaw na false, aby aktywować:

adb shell device_config put adservices global_kill_switch false

Aby dezaktywować:true

adb shell device_config put adservices global_kill_switch true

Włączanie środowiska uruchomieniowego pakietu SDK na urządzeniu

adb shell device_config put adservices disable_sdk_sandbox false

Kroki po rejestracji

Po zakończeniu rejestracji musisz wykonać kilka dodatkowych czynności, aby przygotować urządzenie do korzystania z interfejsów API Piaskownicy prywatności.

Musisz wymusić pobranie pliku rejestracji na urządzeniu, wykonując te czynności:

1. Powinieneś/powinnaś otrzymać e-maila od zespołu pomocy Piaskownicy prywatności z identyfikatorem konta rejestracji i adresem URL, który wskazuje na plik rejestracji.

2. Na urządzeniu z wersją dla deweloperów za pomocą tego polecenia zastąpij listę subskrypcji.

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

3. (Opcjonalnie, ale zalecane) Sprawdź, czy zastąpienie zwraca ścieżkę ustawioną w poprzednim kroku.

   adb shell device_config get adservices mdd_measurement_manifest_file_url

4. Wywoływanie wywołania interfejsu API z jednego z interfejsów API chroniących prywatność. (np. registerSource() z interfejsu Attribution Reporting API, getTopics() z interfejsu Topics API lub joinCustomAudience() z interfejsu Protected Audience API). Ten wywołanie powinno zakończyć się niepowodzeniem.

5. Wymuś uruchomienie zadania pobierania.

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

6. Możesz już wywoływać interfejsy API do ochrony prywatności w wersji dla deweloperów. Połączenie wykonane w kroku 4 powinno się teraz udać.

Dezaktywowanie rejestracji

W wersjach w ramach wersji dla deweloperów możesz uzyskać dostęp do interfejsów Protected Audience API i Topics API bez rejestracji, wykonując te polecenia dezaktywacji rejestracji adb.

Protected Audience

adb shell setprop debug.adservices.disable_fledge_enrollment_check true

Tematy

adb shell setprop debug.adservices.disable_topics_enrollment_check true

Attribution Reporting

adb shell device_config put adservices disable_measurement_enrollment_check "true"