دستگاه‌ها را برای استفاده از Privacy Sandbox در Android پیکربندی کنید

تعدادی تنظیمات وجود دارد که می‌توانید برای دستگاه‌هایی که Privacy Sandbox در Android دارند آن‌ها را فعال یا غیرفعال کنید.

رابط کاربری کنترل کاربر Privacy Sandbox را نمایش دهید

Privacy Sandbox در Android به کاربران دستگاه اجازه می‌دهد کنترل کنند که آیا APIهای حفظ حریم خصوصی (PPAPI) و زمان اجرا SDK در دستگاه‌های خودشان فعال هستند یا نه. از پیش‌نمایش برنامه‌نویس 5، تنظیم نمایش رابط کاربری کنترل کاربر به‌طور پیش‌فرض غیرفعال می‌شود. برای اهداف توسعه و آزمایش، ممکن است بخواهید رابط کاربری کنترل کاربر را فعال کنید. برای فعال کردن رابط کاربری کنترل کاربر، از دستورات adb زیر استفاده کنید:

برای ساخت های بتا و تولیدی:

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

برای پیش نمایش های برنامه نویس:

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

به طور پیش فرض، کنترل کاربر در دستگاه غیرفعال است. برای فعال کردن Privacy Sandbox API و SDK Runtime در دستگاه، روی کلید جابجایی ضربه بزنید.

نمودار
رابط کاربری کنترل کاربر Privacy Sandbox در دستگاه Android.

Privacy Sandbox را در دستگاه فعال کنید

در حالی که بخش قبلی به کاربر دستگاه امکان می داد انتخاب کند که آیا می خواهد Privacy Sandbox روی دستگاه خود اجرا شود یا خیر، این بخش توضیح می دهد که چگونه یک توسعه دهنده می تواند API ها را در دستگاه با استفاده از دستورات adb فعال کند.

PPAPI را در دستگاه فعال کنید

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

PPAPI را غیرفعال کنید

برای اهداف توسعه و آزمایش، می توانید با اجرای دستورات زیر دسترسی PPAPI را در دستگاه فعال یا غیرفعال کنید:

برای فعال کردن روی false تنظیم کنید:

adb shell device_config put adservices global_kill_switch false

برای غیرفعال کردن روی true تنظیم کنید:

adb shell device_config put adservices global_kill_switch true

SDK Runtime را در دستگاه فعال کنید

adb shell device_config put adservices disable_sdk_sandbox false

مراحل ثبت نام را ارسال کنید

پس از تکمیل ثبت نام، چند مرحله اضافی وجود دارد که باید انجام دهید تا دستگاه خود را برای استفاده از APIهای جعبه ایمنی حریم خصوصی آماده کنید.

با این مراحل باید فایل ثبت نام را به اجبار در دستگاه خود دانلود کنید:

  1. شما باید یک ایمیل از طرف پشتیبانی Privacy Sandbox با شناسه حساب ثبت نام خود و یک URL که به فایل ثبت نام اشاره دارد دریافت کنید.
  2. در دستگاهی که نسخه پیش‌نمایش برنامه‌نویس را اجرا می‌کند، فهرست ثبت‌نام را با استفاده از این دستور لغو کنید.

    adb shell device_config put adservices mdd_measurement_manifest_file_url
    "<insert URL provided>"
    
  3. (اختیاری اما توصیه می شود) Verify override مسیر تعیین شده در مرحله قبل را برمی گرداند.

    adb shell device_config get adservices mdd_measurement_manifest_file_url
    
  4. یک تماس API از یکی از APIهای حفظ حریم خصوصی را راه اندازی کنید. (مثلا registerSource() از Attribution Reporting API، getTopics() از Topics API، یا joinCustomAudience() از Protected Audience API). انتظار می رود این تماس با شکست مواجه شود.

  5. کار دانلود را به اجبار اجرا کنید.

    adb shell cmd jobscheduler run -f com.google.android.adservices.api  14
    
  6. اکنون می توانید شروع به فراخوانی APIهای حفظ حریم خصوصی در پیش نمایش برنامه نویس کنید. تماسی که در مرحله 4 برقرار کردید اکنون باید موفقیت آمیز باشد.

غیرفعال کردن ثبت نام

در نسخه‌های پیش‌نمایش برنامه‌نویس، می‌توانید با اجرای دستورات adb غیرفعال‌سازی ثبت‌نام زیر، بدون ثبت‌نام به APIهای مخاطب محافظت شده و موضوعات دسترسی داشته باشید.

مخاطب محافظت شده

adb shell setprop debug.adservices.disable_fledge_enrollment_check true

موضوعات

adb shell setprop debug.adservices.disable_topics_enrollment_check true

گزارش اسناد

adb shell device_config put adservices disable_measurement_enrollment_check "true"