Ta strona została przetłumaczona przez Cloud Translation API.

Konfigurowanie urządzeń pod kątem korzystania z Piaskownicy prywatności na Androidzie

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

Wyświetl interfejs użytkownika Piaskownicy prywatności

Piaskownica prywatności na urządzeniach z Androidem pozwala użytkownikom urządzeń decydować, czy interfejsy API chroniące prywatność (PPAPI) i środowisko wykonawcze SDK mają być włączone na ich urządzeniach. Od wersji przedpremierowej dla programistów w wersji 5 ustawienie wyświetlania interfejsu elementów sterujących użytkownika jest domyślnie wyłączone. Do celów programistycznych i testowych możesz włączyć interfejs użytkownika. Aby włączyć interfejs użytkownika, użyj tych poleceń adb:

Kompilacje w wersji beta i produkcyjnej:

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

W przypadku wersji przedpremierowej 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 na urządzeniu jest wyłączona. Aby włączyć interfejs API Piaskownicy prywatności i środowisko wykonawcze SDK na urządzeniu, kliknij przełącznik.

Diagram — Interfejs użytkownika Piaskownicy prywatności na urządzeniach z Androidem.

Włącz Piaskownicę prywatności na urządzeniu

W poprzedniej sekcji użytkownik urządzenia mógł wybrać, czy chce uruchomić Piaskownicę prywatności. Z tej sekcji dowiesz się, jak deweloper może włączyć interfejsy API na urządzeniu za pomocą poleceń adb.

Włącz 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

Dezaktywacja PPAPI

Do celów programistycznych i testowych możesz aktywować lub dezaktywować dostęp do PPAPI na urządzeniu, uruchamiając następujące polecenia:

Ustaw wartość false, aby aktywować:

adb shell device_config put adservices global_kill_switch false

Ustaw wartość true, aby dezaktywować:

adb shell device_config put adservices global_kill_switch true

Włącz środowisko wykonawcze SDK na urządzeniu

adb shell device_config put adservices disable_sdk_sandbox false

Czynności 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.

Aby wymusić pobranie pliku rejestracji na urządzenie, wykonaj te czynności:

Od zespołu pomocy Piaskownicy prywatności otrzymasz e-maila z identyfikatorem konta rejestracyjnego i adresem URL prowadzącym do pliku rejestracyjnego.
Na urządzeniu z wersją przedpremierową dla programistów zastąp listę rejestracji za pomocą tego polecenia.
```
adb shell device_config put adservices mdd_measurement_manifest_file_url
"<insert URL provided>"
```
(Opcjonalne, ale zalecane) Weryfikacja zastąpienia zwraca ścieżkę ustawioną w poprzednim kroku.
```
adb shell device_config get adservices mdd_measurement_manifest_file_url
```
Wywołuj wywołanie interfejsu API z jednego z interfejsów API z zachowaniem prywatności. (np. kod registerSource() z interfejsu Attribution Reporting API, getTopics() z interfejsu Topics API lub joinCustomAudience() z interfejsu Protected Audience API). Wywołanie to prawdopodobnie zakończy się niepowodzeniem.

Wymuś uruchomienie zadania pobierania.

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

Teraz możesz wywoływać interfejsy API z zachowaniem prywatności w wersji przedpremierowej dla programistów. Wywołanie wykonane w kroku 4 powinno się już powieść.

Dezaktywuj rejestrację

W wersjach w wersji przedpremierowej dla programistów możesz uzyskać dostęp do interfejsów Protected Audience API i Topics API bez konieczności rejestrowania się, uruchamiając poniższe polecenia adb umożliwiające dezaktywację rejestracji.

Chroniona grupa odbiorców

adb shell setprop debug.adservices.disable_fledge_enrollment_check true

Tematy

adb shell setprop debug.adservices.disable_topics_enrollment_check true

Raportowanie atrybucji

adb shell device_config put adservices disable_measurement_enrollment_check "true"