یادداشت‌های انتشار Android Privacy Sandbox

Privacy Sandbox در اندروید برنامه‌های پیش‌نمایش برنامه‌نویس و بتا را ارائه می‌دهد. به مرور زمان APIها و ویژگی‌های جدیدی را در پیش‌نمایش توسعه‌دهنده معرفی می‌کنیم و APIهای تثبیت‌شده را به برنامه بتا ارتقا می‌دهیم. بازخورد تشویق می شود .

اگر به تازگی وارد جعبه ایمنی حریم خصوصی در Android هستید، با نمای کلی برنامه شروع کنید. برای شروع ساختن جعبه ایمنی حریم خصوصی در پروژه خود، محیط توسعه خود را راه اندازی کنید و جعبه ایمنی حریم خصوصی را در Android در دستگاه آزمایشی یا شبیه ساز خود دریافت کنید.

نسخه های فعلی

Android VanillaIceCream پیش نمایش

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

• قابلیت ارسال تبلیغات متنی تایید شده به حراج محافظت شده اضافه شده است. این همچنین شامل فیلتر منفی برای برنامه‌هایی است که قبلاً روی دستگاه نصب شده‌اند و همچنین محدودیت فرکانس روی تعداد کلیک‌ها، نمایش‌ها، بازدیدها یا بردها را شامل می‌شود. پیاده سازی با تکرارهای قبلی متفاوت است زیرا تبلیغات متنی باید توسط فناوری تبلیغات امضا شود. نحوه پیاده‌سازی این را در راهنمای توسعه‌دهنده بخوانید.
• ContextualAds به SignedContextualAds به همراه گیرنده و تنظیم کننده مرتبط در AdSelectionConfig تغییر نام داد. getPerBuyerSignedContextualAds, setPerBuyerSignedContextualAds
• اگر یک برنامه متنی احراز هویت نشده ارسال شود، از حراج حذف خواهد شد

Attribution Reporting API

• امکان حذف منبع در صورتی که برنامه قبلاً روی دستگاه نصب شده باشد
• به روز رسانی از گزارش رویداد انعطاف پذیر ساده به گزارش رویداد انعطاف پذیر کامل

Privacy Sandbox در نسخه بتا نوامبر 2023 Android

این نسخه از Privacy Sandbox در Android Beta شامل به‌روزرسانی‌های APIهای Privacy Sandbox در دستگاه‌های عمومی Android 14 است. SDK و تصاویر دستگاه برای دانلود با استفاده از مدیر SDK Android Studio به عنوان Android API 34، Extension Level 10 در دسترس هستند و از نظر عملکردی مشابه [Developer Preview 9][b25] هستند، با چند تغییر کلیدی.

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

• فناوری‌های تبلیغاتی اکنون می‌توانند از [تخصیص مخاطبان سفارشی][b26] برای پیوستن به مخاطبان سفارشی از طرف خریدار استفاده کنند که در دستگاه حضور ندارد.
• اندروید اکنون از اجرای یک مزایده در خدمات Bidding و Auction پشتیبانی می کند.
• حراج های مخاطب محافظت شده از صورتحساب CPC پشتیبانی می کند.
• مزایده‌ها و گزارش‌های مخاطب محافظت‌شده اکنون از سرصفحه‌های نسخه داده برای سیگنال‌های پیشنهادی مطمئن پشتیبانی می‌کنند.
• حراج های مخاطب محافظت شده از فیلتر فرکانس در رویدادهای WIN پشتیبانی می کنند.
• مخاطب محافظت شده اکنون از [ادغام با Attribution Reporting API][b27] پشتیبانی می‌کند.

Attribution Reporting API

• Attribution Reporting API اکنون از [ادغام با مخاطب محافظت‌شده[b28] پشتیبانی می‌کند.

زمان اجرا SDK

• قابلیت از SDK برای بارگیری سایر SDKها در زمان اجرا SDK برای پشتیبانی از موارد استفاده میانجیگری

انتشارات گذشته

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

تاریخ انتشار: 19 دسامبر 2023

محدودیت های شناخته شده

• مشکلی وجود دارد که باعث می‌شود خدمات Google Play در پس‌زمینه از کار بیفتد و به طور مکرر به کاربر اطلاع دهد:
  • راه اندازی مجدد دستگاه ممکن است این مشکل را برطرف کند.
  • در حین آزمایش، اگر مشکلی با زمان‌بندی تماس‌های ناهمزمان دارید، دستور adb زیر را اضافه کنید تا آستانه تا زمان پایان طولانی‌تر شود:
  • adb shell device_config put adservices fledge_auction_server_overall_timeout_ms 60000;
• فقط دستگاه فیزیکی: افزودن حساب Google پشتیبانی نمی‌شود. برای رساندن دستگاه به صفحه اصلی مراحل زیر را دنبال کنید:
  • تصویر پیش نمایش را روی گوشی نصب کنید.
  • بدون اتصال به Wi-Fi یا داده تلفن همراه، از طریق جادوگر راه اندازی بروید.
  • هنگامی که در صفحه اصلی قرار گرفتید، به Wi-Fi یا داده تلفن همراه متصل شوید.
  • دستگاه را راه اندازی مجدد کنید.

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

• ما در حال معرفی قابلیت‌های جدید، [Protected App Signals][dp98]، برای پشتیبانی از ارائه تبلیغات نصب برنامه مرتبط هستیم. با این DP، ما API هایی را منتشر می کنیم تا فناوری های تبلیغاتی را فعال کنیم:
  • سیگنال‌ها را با ذخیره رویدادهای برنامه در فضای ذخیره‌سازی محافظت‌شده روی دستگاه که برای ارائه آگهی‌های نصب برنامه مرتبط استفاده می‌شود، تنظیم کنید.
  • یک مزایده محافظت‌شده در خدمات مناقصه و مزایده اجرا کنید که در محیط‌های اجرای معتمد اجرا می‌شوند، جایی که می‌توانند به سیگنال‌های مربوطه خود برای کمک به انتخاب آگهی و مناقصه دسترسی داشته باشند.

Attribution Reporting API

• این نسخه از Attribution Reporting API:
  • یکپارچه سازی مخاطب محافظت شده را اضافه می کند، که ابعاد مخاطب سفارشی را در گزارش های خلاصه جمع آوری می کند.
  • از Google Cloud Provider به عنوان TEE برای سرویس Aggregation پشتیبانی می کند.
  • فیلد shared_debug_key را برای پشتیبانی از اشکال زدایی برای انتساب بین شبکه ای بدون تغییر مسیر اضافه می کند.
  • سرصفحه‌های نسخه را در درخواست‌های گزارش اشکال‌زدایی کامل اضافه می‌کند.

شخصی سازی روی دستگاه

• انتشار اولیه برای محققان و توسعه اولیه.
• شخصی‌سازی روی دستگاه، روشی نوآورانه برای سفارشی‌سازی محصولات و خدمات و در عین حال افزایش حفاظت از حریم خصوصی کاربر نهایی را معرفی می‌کند. شخصی‌سازی روی دستگاه مجموعه‌ای از خدمات و الگوریتم‌ها را به‌عنوان بلوک‌های سازنده برای دستیابی به این هدف فراهم می‌کند، از جمله اما نه محدود به:
  • محاسبات فدرال (FC) که آموزش، ارزیابی و شخصی سازی مدل ها را با استفاده از یادگیری فدرال امکان پذیر می کند. استفاده شخصی سازی روی دستگاه از محاسبات فدرال بر اساس آموزش مدل و (در صورت نیاز اختیاری) استنتاج خواهد بود.
  • تطبیق و تطبیق متقابل مبتنی بر فیلتر فاخته بین داده‌هایی که مکان‌های متفاوتی دارند.
  • آموزش خصوصی متفاوت (DP) مدل‌های پراکنده با استفاده از تکنیک‌های جدید مانند کمینه‌سازی متناوب DP (برای آموزش داده‌های دارای موقعیت متفاوت)، و شخصی‌سازی مدل تحت بیلبورد DP. ### پیش‌نمایش برنامه‌نویس 9

تاریخ انتشار: 15 آگوست 2023

محدودیت های شناخته شده

• داده‌های مزایده ایجاد شده با فراخوانی Bidding and Auction API به‌طور خودکار در DP9 حذف نمی‌شوند.
• فراخوانی getAdSelectionData و persistAdSelectionResult زمانی که رضایت لغو می‌شود، فرآیند را خراب می‌کند.
• ویژگی فیلتر منفی با getAdSelectionData و persistAdSelectionResult کار نمی کند.

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

• فناوری‌های تبلیغاتی اکنون می‌توانند از تفویض مخاطبان سفارشی برای پیوستن مخاطبان سفارشی به تماس‌گیرنده در دستگاه استفاده کنند.
• Android اکنون از اجرای حراج در خدمات Bidding و Auction پشتیبانی می‌کند - حراج‌های مخاطب محافظت شده از صورت‌حساب CPC پشتیبانی می‌کنند.
• گزارش تعاملات API اکنون reportEvent نامیده می شود.
• روش دربندی فرکانس و انواع شمارنده تغییر نام داده شده است.
• گزارش اشکال زدایی برای به دست آوردن اطلاعات در مورد چرایی از بین رفتن حراج یا شناسایی مشکلات در منطق جاوا اسکریپت در دسترس است.

Attribution Reporting API

• این نسخه گزارش‌های اشکال‌زدایی را برای API گزارش Attribution توسط:
  • پشتیبانی از گزارش های اشکال زدایی مفصل که در وب پشتیبانی می شوند.
  • فعال کردن گزارش‌های اشکال‌زدایی اسناد بین وب و برنامه (به AdId در هر دو وب و ثبت برنامه نیاز دارد).
• فناوری های تبلیغاتی می توانند پارامترهای نویز را برای سناریوهای مختلف گزارش پیکربندی کنند.
• این نسخه به انتساب مبتنی بر مبدا منتقل می شود، به این معنی:
  • Origin برای ثبت نام استفاده می شود.
  • چندین منبع تحت یک سایت واحد پذیرفته می شود.
  • محدودیت نرخ جدید از یک مبدا برای هر برنامه منبع یا ثبت نام.
• فناوری‌های تبلیغاتی اکنون می‌توانند ثبت‌نام را برای آزمایش موارد استفاده گزارش اسناد به صورت محلی غیرفعال کنند.

زمان اجرا SDK

• SDK فقط می‌تواند راه‌اندازی یا متصل به لیست مجاز خدمات باشد.
• SDK فقط می‌تواند به زیرمجموعه‌ای از ContentProvider سیستم (مانند com.android.providers.settings.SettingsProvider ) دسترسی داشته باشد، جایی که داده‌های به‌دست‌آمده فاقد شناسه هستند و نمی‌توان از آنها برای ساخت اثر انگشت کاربر استفاده کرد. این بررسی ها همچنین برای دسترسی به ContentProvider با استفاده از ContentResolver اعمال می شود.
• SDK فقط می تواند به زیر مجموعه ای از گیرنده های پخش محافظت شده (مانند android.intent.action.AIRPLANE_MODE ) دسترسی داشته باشد.
• SDK می‌تواند فعالیتی را که متعلق به یک برنامه دیگر است راه‌اندازی کند، اما با محدودیت‌هایی در مورد آنچه می‌تواند در Intent ارسال شود.

Privacy Sandbox در نسخه بتا مارس 2023 اندروید

نسخه مارس 2023 Privacy Sandbox در اندروید بتا شامل به‌روزرسانی‌های APIهای Privacy Sandbox در دستگاه‌های عمومی Android 13 است. این نسخه شامل Ad Services Extensions 5 API است و از نظر عملکردی مشابه Developer Preview 6 است، با چند تغییر کلیدی.

محدودیت های شناخته شده

• کار واکشی پس‌زمینه که به‌طور دوره‌ای برای به‌روزرسانی مخاطبان سفارشی FLEDGE اجرا می‌شود، باعث از کار افتادن فرآیند می‌شود. به دلیل این مشکل، FLEDGE به طور پیش فرض غیرفعال است.

عمومی

• از این نسخه می‌توانید از Attribution Reporting API استفاده کنید. API قبلاً غیرفعال شده بود. اگر از API گزارش Attribution در نسخه بتا قبلی استفاده کرده‌اید، قبل از استفاده از این نسخه بتا، داده‌های برنامه یا دستگاه خود را با یکی از مراحل زیر پاک کنید:
  • در دستگاه یا شبیه‌ساز، به تنظیمات بروید و فضای ذخیره‌سازی مخصوص برنامه (نه فقط حافظه پنهان) را برای هر برنامه‌ای که برای آزمایش استفاده می‌شود پاک کنید .
  • بازنشانی کارخانه ای را در دستگاه فیزیکی یا شبیه سازی شده خود انجام دهید.
  • برای یک دستگاه شبیه سازی شده، یک عملکرد پاک کردن داده را انجام دهید.
• Attribution Reporting اکنون از کلیدهای اشکال‌زدایی پشتیبانی می‌کند، که به توسعه‌دهندگان اجازه می‌دهد تا گزارش‌های بدون تغییر و گزارش‌های بهبود یافته حریم خصوصی را از Attribution API دریافت کنند. کلیدهای اشکال‌زدایی فرصتی را فراهم می‌کنند که در حین انتقال به جعبه ایمنی حریم خصوصی، نحوه ساختار گزارش‌ها را بیشتر مشاهده کنید.
• Attribution Reporting اخیراً با یک اشکال در خدمات تبلیغاتی روبرو شده است که در آن registerSource و registerTrigger با استثناء شکست می‌خورند. اگر این مشکلات را در حین توسعه تجربه کردید، یک راه حل برای شما ایجاد شده است و این مشکلات باید به مرور زمان برطرف شوند.
• عملکرد پیش‌نمایش Topics API اکنون با Privacy Sandbox در پیش‌نمایش‌های برنامه‌نویس Android برابری می‌کند. تماس‌گیرنده Topics API می‌تواند پیش‌نمایش موضوعات را بدون گنجاندن تماس بازیابی موضوع در محاسبه دوره هفتگی یا تأثیر بر فهرست موضوعات مشاهده‌شده برای تماس‌گیرنده، مشاهده کند. برای جزئیات به قسمت shouldRecordObservation مراجعه کنید.

• برای فعال کردن آزمایش در FLEDGE در Android، در برنامه بتا ثبت نام کنید و از همان حساب Google برای ورود به دستگاه های آزمایشی خود استفاده کنید. در غیر این صورت، تلاش برای فراخوانی API ها باعث ایجاد یک پیام IllegalStateException با پیام "سرویس در دسترس نیست" می شود. FLEDGE باید در نسخه بتا بعدی بازیابی شود.

  در عین حال، آزمایش با استفاده از پیش‌نمایش‌های برنامه‌نویس می‌تواند ادامه یابد و تشویق می‌شود، و FLEDGE را می‌توان به صورت دستی در دستگاه‌هایی با اخطارهای زیر فعال کرد:

  می توانید FLEDGE را با دستورات adb زیر فعال کنید. با این حال، این باعث از کار افتادن فرآیند واکشی پس‌زمینه می‌شود که بر معیارهای سلامت سیستم تأثیر منفی می‌گذارد. این یک راه حل دائمی نیست زیرا ممکن است این مقادیر توسط پلت فرم بازنشانی شوند.

  adb shell device_config set_sync_disabled_for_tests persistent
  adb shell setprop debug.adservices.fledge_select_ads_kill_switch false
  adb shell setprop debug.adservices.fledge_custom_audience_service_kill_switch false
  adb shell device_config put adservices fledge_background_fetch_enabled true
  

انتشارات گذشته

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

تاریخ انتشار: 23 می 2023

محدودیت های شناخته شده

• در حالی که فیلترهای درپوش فرکانس نوع WIN می توان به تبلیغات مخاطب محافظت شده اضافه کرد، نوع WIN هنوز پشتیبانی نمی شود و فیلترهای این نوع نادیده گرفته می شوند.
• برای گزارش برداشت‌های برنده به خریداران برنده حراج‌های مخاطب محافظت‌شده، خریداران باید در جعبه ایمنی حریم خصوصی ثبت‌نام کنند. این الزام را نمی توان نادیده گرفت.
• برای دسترسی به تنظیمات جعبه ایمنی حریم خصوصی در دستگاهی که جعبه ایمنی حریم خصوصی در دسترس است، به تنظیمات > Google > تبلیغات > جعبه ایمنی حریم خصوصی بروید.
• نمی توان پروژه ها را با شبیه سازها در Android Studio Giraffe اجرا کرد. سایر نسخه های اندروید استودیو باید به خوبی کار کنند. در تاریخ 26 می 2023، یک اصلاح برای Android Studio Giraffe ارائه خواهد شد.

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

• FLEDGE به API مخاطب محافظت شده تغییر نام داده است.
• مخاطب محافظت شده به طور پیش فرض در نسخه بتا مارس 2023 غیرفعال شد. این مشکل حل شده است و مخاطبان محافظت شده اکنون برای تعداد محدودی از کاربران ارائه شده است.
• ویژگی های جدید زیر را اضافه کرد:
  • محدودیت فرکانس
  • گزارش تعامل
  • تبلیغات متنی را در یک حراج قرار دهید
  • فیلترینگ تبلیغات منفی نصب برنامه
  • URI های از پیش ساخته شده یک کتابخانه از منطق از پیش تعریف شده برای استفاده در فرآیند حراج توسط adtech ها به جای جاوا اسکریپت آنها
  • نسخه سازی برای مناقصه و امتیازدهی توابع جاوا اسکریپت

Attribution Reporting API

• فیلترهای ماشه OR اضافه شد. این بدان معنی است که فیلترها اکنون از یک مجموعه فیلتر تشکیل شده اند که لیستی از نقشه های فیلتر است. اگر هیچ یک از نقشه های فیلتر در مجموعه با داده های فیلتر منبع مطابقت نداشته باشد، شی event_trigger_data نادیده گرفته می شود.
• پنجره انقضای نمایش و گزارش برای APIهای تجمع و رویداد جدا شده است.
• اضافه شدن پشتیبانی از کلیدهای deduplication در گزارش های جمع آوری.
• scheduled_report_time برای برابری با Privacy Sandbox برای وب به گزارش‌های رویداد اضافه شد.
• تخصیص بین شبکه ای بدون تغییر مسیر اجرا شد.

زمان اجرا SDK

• ارتباط SDK به SDK را برای فرآیند برنامه و فرآیند زمان اجرا SDK پیاده سازی کرد.
• پشتیبانی از فعالیت SDK سفارشی

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

تاریخ انتشار: 26 ژانویه 2023

FLEDGE در Android API

• پارامتر custom_audience_signals در متدهای جاوا اسکریپت زیر تغییر نام داده است:
  • generateBid() به custom_audience_bidding_signals تغییر نام داده است.
  • scoreAd() به custom_audience_scoring_signals تغییر نام داده است.
  • reportWin() به custom_audience_reporting_signals تغییر نام داده است.
• این نسخه نادیده گرفتن selectAds جدیدی اضافه می کند که AdSelectionFromOutcomeConfig برای مقایسه نتایج selectAds استفاده می کند. این SDK‌های فناوری تبلیغات را قادر می‌سازد که از این API برای اجرای میانجی‌گری آبشار استفاده کنند. جزئیات بیشتر در راهنمای توسعه دهنده ذکر شده است.
• API selectAds() اکنون از کش برای پیشنهاد و امتیازدهی منطقی جاوا اسکریپت که در طی فرآیند انتخاب آگهی واکشی شده است، پشتیبانی می کند.
  • کش را می توان با هدرهای Cache-Control که توسط سرورها در طول تماس واکشی جاوا اسکریپت برگردانده می شود، کنترل کرد. از no-cache یا no-store برای جلوگیری از ذخیره شدن پاسخ های جاوا اسکریپت و حداکثر سن برای کنترل مدت زمان کش استفاده کنید.
  • max-age ورودی کش فعلی به طور پیش فرض روی دو روز تنظیم شده است.

Attribution Reporting در Android API

• این نسخه پشتیبانی از تغییر مسیرهای زنجیره ای برای registerSource() و registerTrigger() اضافه می کند. مصرف کننده API اکنون می تواند از تغییر مسیر HTTP به عنوان پاسخ سرور استفاده کند.

نسخه بتا اولیه، ژانویه 2023

تاریخ انتشار: 9 ژانویه 2023

Privacy Sandbox در Android Beta 1 نشان‌دهنده اولین در دسترس بودن APIهای Privacy Sandbox در دستگاه‌های عمومی است و بهبودهایی را به مناطق فهرست‌شده بعدی اضافه می‌کند.

عمومی

• Privacy Sandbox در Android Beta 1 از نظر عملکردی معادل Developer Preview 5 است و برخی از ویژگی‌ها و محدودیت‌های اضافی در زیر ذکر شده است.
• توسعه‌دهندگان باید یک فرآیند ثبت‌نام را برای استفاده از APIهای مرتبط با تبلیغات (از جمله Topics، FLEDGE، و Attribution Reporting) تکمیل کنند. فرآیند ثبت‌نام هویت توسعه‌دهنده را تأیید می‌کند و داده‌های خاص توسعه‌دهنده مورد نیاز APIها را جمع‌آوری می‌کند.
• با انتشار جعبه ایمنی حریم خصوصی در اندروید بتا 1، برنامه‌نویسانی که ثبت‌نام کرده‌اند و جزئیات را به فهرست مجاز ارسال کرده‌اند، ممکن است این فرصت را پیدا کنند که روی دستگاه‌های فیزیکی خود آزمایش کنند. برای توسعه در برابر API های پایدار در نسخه، افزونه های SDK Ad Services Extensions 4 را دانلود کنید.

موضوعات API

• Android Topics Classifier Colab به توسعه دهندگان اجازه می دهد تا درک بهتری از نحوه عملکرد مدل طبقه بندی کننده داشته باشند.

Attribution Reporting API

• گزارش انتساب غیرفعال شده است و برای استفاده در این نسخه در دسترس نیست. دسترسی به این API باید در نسخه بتا بعدی دوباره فعال شود. تشویق می‌شوید به آزمایش با پیش‌نمایش‌های برنامه‌نویس ادامه دهید.

زمان اجرا SDK

انتظار می رود محدودیت های زیر در نسخه اصلی پلتفرم اندروید برطرف شود:

• ارائه تبلیغات در یک نمای قابل پیمایش مانند RecyclerView در حال حاضر به درستی کار نمی کند. در صورت تغییر اندازه عنصر ممکن است دچار jank شوید. رویدادهای اسکرول لمسی کاربر به درستی به زمان اجرا منتقل نمی شوند.
• ارائه WebView در فرآیند SDK Runtime در دسترس نیست.
• فضای ذخیره سازی برای هر SDK در دسترس نیست.
• پشتیبانی از getAdId و getAppSetId API هنوز فعال نشده است.

پیش نمایش توسعه دهنده 6

تاریخ انتشار: 31 اکتبر 2022

Privacy Sandbox در Android Developer Preview 6 بهبودهایی را در زمینه‌های زیر اضافه می‌کند:

عمومی

• در آماده سازی برای عرضه تولید، Developer Preview 6 پرچمی را برای غیرفعال کردن دسترسی به API حفظ حریم خصوصی به طور پیش فرض معرفی کرد. برای اهداف آزمایشی، با اجرای دستور زیر، دسترسی API حفظ حریم خصوصی را در پیش‌نمایش توسعه‌دهنده فعال کنید:

  adb shell device_config put adservices global_kill_switch false
  

• APIهای AdIdManager و AppSetIdManager به خدمات Google Play نسخه 22.36.16 یا بالاتر نیاز دارند.

  • در یک دستگاه مجهز به Android، تأیید کنید که نسخه صحیح در زیر تنظیمات > برنامه‌ها > خدمات Google Play فهرست شده است.
  • اگر می‌خواهید سرویس‌های Google Play را به نسخه مناسب به‌روزرسانی کنید، با یک حساب Google در دستگاه آزمایشی یا شبیه‌ساز Android خود وارد شوید. سپس به فروشگاه Google Play > نماد نمایه > تنظیمات > درباره بروید. در زیر عنوان نسخه Play Store ، روی Update Play Store ضربه بزنید.
  • این مرحله فقط برای توسعه و آزمایش قابل اجرا است و پس از اینکه جعبه ایمنی حریم خصوصی برای کاربران عمومی عرضه شد، دیگر مورد نیاز نخواهد بود.

موضوعات API

• یک API پیش‌نمایش برای تغییر دادن یا عدم ثبت getTopics به عنوان ناظر اضافه شد.
• تغییرات جزئی در کد اولیه برای کلاس GetTopicsRequest .
• راهنمای ادغام موضوعات منتشر شد.

FLEDGE در Android API

• اگر در حال آزمایش روی سرورهای واقعی هستید، فعال کردن API اکنون اعمال می شود. لطفاً این مراحل را برای پیکربندی دستگاه خود دنبال کنید. اگر از برنامه‌های حذف از راه دور موجود در برنامه نمونه استفاده می‌کنید، این مراحل لازم نیست.
• شکستن تغییرات:
  • Url در پارامترها با Uri جایگزین شد. این برای همه APIهای FLEDGE و جاوا اسکریپت سفارشی برای منطق مناقصه و امتیازدهی اعمال می شود.
  • فیلد owner از ورودی های Custom Audience API حذف شد.
• مخاطبان سفارشی ناقص اکنون فوراً واجد شرایط بازخوانی پس‌زمینه هستند.
• محدودیت حافظه جاوا اسکریپت اکنون روی 10 مگابایت تنظیم شده است. این در مورد مناقصه و منطق امتیاز دهی صدق می کند.

Attribution Reporting API

• متخصصان تبلیغات قبل از اینکه بتوانند از API گزارش انتساب در پیش‌نمایش برنامه‌نویس 6 استفاده کنند، باید ثبت‌نام کنند. برای اطلاعات بیشتر به ثبت نام برای حساب Sandbox حریم خصوصی مراجعه کنید.
• این نسخه کلیدهای اشکال زدایی را معرفی می کند که به توسعه دهندگان اجازه می دهد تا گزارش های بدون تغییر را همراه با گزارش های ارتقا یافته حریم خصوصی از Attribution Reporting API دریافت کنند. کلیدهای اشکال‌زدایی این فرصت را فراهم می‌کنند که در حین انتقال با جعبه ایمنی حریم خصوصی، نحوه ساختار گزارش‌ها را بیشتر مشاهده کنید.

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

عمومی

• قبل از اینکه بتوانید به APIهای Privacy Sandbox در Developer Preview 5 دسترسی داشته باشید، ابتدا باید APIها را فعال کرده و مجوزهای خاص API را پیکربندی کنید .
  • طراحی‌های Privacy Sandbox در Android به کاربران اجازه می‌دهد کنترل کنند که آیا APIهای حفظ حریم خصوصی و زمان اجرای SDK در دستگاهشان فعال هستند یا خیر. این تنظیمات به‌طور پیش‌فرض در پیش‌نمایش برنامه‌نویس 5 غیرفعال هستند. می‌توانید دسترسی API را با استفاده از دستور adb فعال کنید.
  • برنامه تماس گیرنده باید مجوزهای ویژه API را در مانیفست و تنظیمات AdServices مربوطه مشخص کند که دسترسی به SDK های تعبیه شده را کنترل می کند.
• برنامه‌ها هنگام اجرا در پیش‌زمینه باید با APIهای حفظ حریم خصوصی تماس بگیرند.
• AdIdManager و AppSetIdManager در حال حاضر عملیاتی نیستند. آنها در نسخه بعدی فعال خواهند شد.

زمان اجرا SDK

• sendData() در نسخه بعدی منسوخ خواهد شد.
• loadSdk() اکنون یک شی IBinder را برمی گرداند تا ارتباط دو طرفه بین SDK فعال در زمان اجرا و برنامه های تعریف شده در AIDL را تسهیل کند.
• برنامه‌ها به رویدادهای چرخه حیات SDK با قابلیت زمان اجرا اضافی دسترسی دارند، مانند زمانی که فرآیند SDK پایان می‌یابد.

Attribution Reporting API

این نسخه ویژگی‌های اضافی را در API گزارش Attribution معرفی می‌کند، از جمله:

• پشتیبانی از گزارش تجمع رمزگذاری شده
• پشتیبانی از برنامه های متقابل و اندازه گیری وب .
• سرصفحه‌های تلفیقی در پاسخ‌های ثبت منبع و راه‌انداز:
  • منبع: Attribution-Reporting-Register-Aggregatable-Source اکنون بخشی از Attribution-Reporting-Register-Source است.
  • Trigger: Attribution-Reporting-Register-Event-Trigger, Attribution-Reporting-Register-Aggregatable-Trigger-Data and Attribution-Reporting-Register-Aggregatable-Values ​​در یک سرصفحه واحد با نام Attribution-Reporting-Register-Event-Trigger ادغام شده اند.
  • Attribution-Reporting-Redirects هنوز یک عنوان جداگانه است

FLEDGE در Android API

این نسخه شامل چندین ویژگی و بهبود جدید و همچنین تغییرات شکسته است:

• شکستن تغییرات:
  • runAdSelection() به selectAds() تغییر نام داده است.
  • پارامتر AdSelectionConfig.Builder.setAdSelectionSignals() را با AdSelectionSignals جایگزین کرد که نشان دهنده یک شی JSON است.
  • استفاده از String برای نشان دادن خریدار/فروشنده فناوری تبلیغات با شی AdTechIdentifier جایگزین شد.
  • کلاس‌های TestCustomAudienceManager و TestAdSelectionManager برای لغو واکشی جاوا اسکریپت از راه دور اضافه شد.
  • صاحب یک مخاطب سفارشی باید نام بسته برنامه تماس باشد.
• API های FLEDGE اکنون برنامه تماس گیرنده را در برابر مجموعه ای از محدودیت ها و محدودیت هایی که در راهنمای توسعه دهنده توضیح داده شده است تأیید می کنند. در زیر چند نمونه قابل توجه ذکر شده است.
  • selectAds و reportImpression اکنون دارای محدودیت های زمانی اجرا هستند و پس از آن تماس قطع می شود.
  • selectAds و reportImpression اکنون محدودیتی برای حافظه مصرف شده در طول اجرای جاوا اسکریپت دارند. اگر مصرف حافظه از محدودیت های پیکربندی شده بیشتر شود، API ها با خطا مواجه می شوند.
  • selectAds و reportImpression اکنون شی AdSelectionConfig را اعتبار می‌دهند تا اطمینان حاصل شود که فیلدها از نظر نحوی معتبر هستند و نشانی‌های اینترنتی زیر eTLD+1 استفاده شده در قسمت فروشنده هستند.
  • AdServices اکنون مخاطبان سفارشی را در زمان ایجاد اعتبار می کند. برخی از این اعتبارسنجی شامل اطمینان از اعتبار زمان انقضا است و محدودیتی را برای تعداد مخاطبان سفارشی که یک برنامه می‌تواند ایجاد کند و اندازه کل تبلیغات ارائه شده در تماس joinCustomAudience اعمال می‌کند. اعتبارسنجی همچنین باعث می‌شود که URI‌های ارائه‌شده برای سیگنال‌ها و بازیابی منطق قیمت‌گذاری و واکشی پس‌زمینه همگی تحت دامنه خریدار باشند.
• فراداده مخاطب سفارشی هر روز با یک فرآیند واکشی پس‌زمینه به‌روزرسانی می‌شود.
• وقتی برنامه «مالک» حذف نصب شود، مخاطبان سفارشی حذف می‌شوند.
• پشتیبانی برای مشخص کردن سیگنال‌های امتیازدهی معتمد و داده‌های مناقصه معتمد در حین انتخاب آگهی اضافه شد. نمونه کد را برای فرمت پاسخ ببینید .
• FLEDGE برای APIهای Android به WebView نسخه 105.0.5195.58 یا بالاتر بستگی دارد. برای جزئیات به اطلاعات راه اندازی در راهنمای توسعه دهندگان مراجعه کنید.

• مشکلات شناخته شده:

  • هنگامی که به یک مخاطب سفارشی می‌پیوندید، در حال حاضر پلتفرم به‌روزرسانی‌های پس‌زمینه را فوراً انجام نمی‌دهد، اگر هر یک از متادیتا یا مقادیر AdData خالی یا null باشد. تا زمانی که یک روز بعد به‌روزرسانی نشود، مخاطبان سفارشی برای انتخاب آگهی واجد شرایط نیستند. نسخه آینده مخاطبان سفارشی ناقص را فورا واجد شرایط به‌روزرسانی‌های واکشی پس‌زمینه می‌کند. محدودیت حافظه پیش‌فرض فعلی برای اجرای جاوا اسکریپت بسیار کم است و ممکن است باعث شود که بارهای کاری معمولی باعث از کار افتادن JavascriptEngine در دستگاه‌ها شود. اجرای جاوا اسکریپت شما ممکن است به طور غیرمنتظره ای با پیام خطای "Fatal javascript OOM in CALL_AND_RETRY_LAST" خاتمه یابد.

    شما می توانید به صورت دستی این مشکل را با پیکربندی آستانه حافظه مناسب با دستور زیر حل کنید:

    adb shell "device_config put adservices fledge_js_isolate_enforce_max_heap_size 10485760"
    

  • تبلیغات مخاطب سفارشی که با ساختار JSON مورد نیاز مطابقت ندارد، در طول واکشی پس‌زمینه به‌روزرسانی می‌شوند.

موضوعات API

• طبقه بندی به روز شده برای طبقه بندی برنامه های تلفن همراه.
• پیشنهاد طراحی و نمونه برنامه‌ها را با راه‌اندازی رابط کاربری تنظیمات برای مشاهده موضوعات اختصاص‌یافته به‌روزرسانی کرد.

به روز رسانی ابزار

Android Studio Canary از ساخت SDK APK با نوع ماژول جدید پشتیبانی می کند. راهنمای برنامه‌نویس SDK Runtime به‌روزرسانی شده است و نمونه برنامه‌های Privacy Sandbox در GitHub این به‌روزرسانی را منعکس می‌کند.

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

تاریخ انتشار: 14 جولای 2022

Privacy Sandbox در Android Developer Preview 4 بهبودهایی را در زمینه‌های زیر اضافه می‌کند:

زمان اجرا SDK

• اکنون برنامه ها می توانند با افزودن sendData() با SDK های فعال شده در زمان اجرا (RE-SDK) ارتباط برقرار کنند.
• فضای ذخیره سازی محلی اکنون در فرآیند SDK Runtime در دسترس است.
• یک SDK همچنین می‌تواند تبلیغات یا محتوای ویدئویی مستقل را در زمان اجرا SDK ارائه دهد.
• توضیحاتی در مورد استفاده از انعکاس اضافه شد تا قابلیت استفاده از بازتاب را شامل شود، مشروط بر اینکه محتوا در RE-SDK دیگری نباشد.

Attribution Reporting API

این نسخه تغییراتی را برای بهبود وضوح در مورد استفاده از Attribution Reporting API، مانند:

• تغییرات در قالب گزارش انبوه برای بهبود خوانایی.
• فیلدهای سرصفحه به روز شده برای ویژگی های فیلتر تبدیل و قابلیت پیشنهاد قیمت.
• توضیحات اضافه شده در مرجع WebApp API برای توضیح ثبت منبع و راه‌انداز، و همچنین حفظ حریم خصوصی و در دسترس بودن API رضایت.

FLEDGE در Android API

این نسخه شامل ویژگی های جدیدی برای کمک به تست و اشکال زدایی و همچنین بهبودهای داخلی است:

• پشتیبانی اضافه شده برای نادیده گرفتن URL های راه دور برای بازیابی منطق جاوا اسکریپت در طول توسعه.
• گزارش خطا در هنگام انتخاب آگهی بهبود یافته است.
• مخاطبان سفارشی غیرفعال اکنون در حین انتخاب آگهی فیلتر می شوند.

موضوعات API

این نسخه شامل چندین تغییر قابل توجه در Topics API است که از همه مهمتر آنهاست:

• نوع بازگشتی getTopics() API به نوع شیء جدید Topic تغییر یافته است که شناسه‌های عدد صحیحی را که با موضوعات در طبقه‌بندی مطابقت دارند و اطلاعات مربوط به طبقه‌بندی‌کننده و نسخه‌های طبقه‌بندی را محصور می‌کند. شما باید هر برنامه موجود را با استفاده از این API به روز کنید.
• Topics API اکنون به یک مجوز عادی جدید نیاز دارد.
• معرفی سیستم «طبقه‌بندی کننده روی دستگاه» برای تخصیص پویا موضوعات بر اساس اطلاعات برنامه در دسترس عموم.

مشکلات شناخته شده

• انتشار اولیه این تصاویر دستگاه (نسخه 6) در شبیه ساز اندروید نسخه 31.2.10 بارگیری نمی شود. تصاویر دستگاه به‌روزرسانی‌شده‌ای که مشکل را برطرف می‌کنند، از 27 ژوئیه 2022 در دسترس قرار گرفته‌اند.

  توجه: اگر تصاویر دستگاه ویرایش 6 را قبل از 27 ژوئیه 2022 نصب کرده اید، قبل از اینکه بتوانید تصویر به روز شده را نصب کنید، باید تصویر قدیمی را حذف نصب کنید.

پیش نمایش توسعه دهنده 3

تاریخ انتشار: 9 ژوئن 2022

Privacy Sandbox در Android Developer Preview 3 عملکردی را برای Attribution Reporting API و FLEDGE در Android اضافه می کند.

Attribution Reporting API

Attribution Reporting API حریم خصوصی کاربر را با حذف اتکا به شناسه‌های کاربر بین حزبی بهبود می‌بخشد و از موارد استفاده کلیدی برای اندازه‌گیری اسناد و تبدیل در بین برنامه‌ها پشتیبانی می‌کند.

این نسخه شامل منابع برنامه‌نویس برای کمک به آزمایش ویژگی‌های Attribution Reporting API زیر است:

• منبع اسناد را ثبت کنید و رویدادها را راه اندازی کنید
• منبع اولویت بندی شده و پس از نصب را تمرین کنید
• دریافت گزارش رویداد
• گزارش های انبوهی را دریافت کنید که در این نسخه رمزگذاری نشده است

یک برنامه نمونه و سرور فناوری آگهی مرجع برای کمک به آزمایش ارائه شده است

مشکلات شناخته شده:

• Attribution Reporting API هنوز گزارش‌های انبوه را طبق طرح پیشنهادی رمزگذاری نمی‌کند. برای اهداف آزمایشی، بارهای گزارش به صورت متن شفاف ارسال می شود تا زمانی که رمزگذاری اجرا شود.

FLEDGE در اندروید

FLEDGE در اندروید روش جدیدی را برای نمایش تبلیغات بر اساس مخاطبان سفارشی تعریف شده توسط توسعه دهندگان برنامه و تعاملات درون برنامه آنها معرفی می کند. این راه حل اطلاعات و تبلیغات مرتبط را به صورت محلی ذخیره می کند و چارچوبی را برای هماهنگ کردن گردش کار انتخاب آگهی ارائه می دهد.

این نسخه شامل منابع توسعه دهنده برای کمک به آزمایش FLEDGE زیر در ویژگی های Android است:

• به یک مخاطب سفارشی بپیوندید یا ترک کنید و مشاهده کنید که چگونه مقادیر پارامترها ممکن است بر نتایج حراج تأثیر بگذارد
• کد حراج جاوا اسکریپت را از نقاط پایانی راه دور واکشی کنید
• حراج های تبلیغاتی روی دستگاه را پیکربندی و راه اندازی کنید
• مدیریت گزارش گیری
• یک برنامه نمونه و پیکربندی سرور ساختگی برای کمک به آزمایش ارائه شده است

مشکلات شناخته شده:

• یک مخاطب سفارشی می‌تواند حتی قبل از «زمان فعال‌سازی» در انتخاب آگهی شرکت کند.

پیش نمایش توسعه دهنده 2

تاریخ انتشار: 17 می 2022

پیش‌نمایش توسعه‌دهنده 2 شامل پیش‌نمایش‌های اولیه APIهای گزارش انتساب MeasurementManager است.

• برای ثبت رویدادهای تبلیغات برنامه و دریافت داده های گزارش سطح رویداد برای انتساب برنامه به برنامه، می توانید registerSource() و registerTrigger() فراخوانی کنید. اجرای فعلی ما از انتساب آخرین لمس استفاده می کند. گزارش ها طبق تعریف پنجره های گزارش برنامه ریزی شده است. برای اطلاعات بیشتر به مرجع API MeasurementManager مراجعه کنید.

• بارگذاری گزارش واقعی در پایان بازه های زمانی ثابت انجام می شود، نه در زمان دقیق برنامه ریزی شده. فاصله بارگذاری گزارش به طور پیش فرض 4 ساعت است، اما می توان با دستور adb زیر آن را لغو کرد:

  adb shell device_config put adservices measurement_main_reporting_job_period_ms <duration in milliseconds>
  

• یک نمونه برنامه و سرور فناوری آگهی مرجع برای آزمایش APIها در نسخه بعدی منتشر خواهد شد.

• سایر ویژگی‌های API گزارش انتساب MeasurementManager مانند گزارش انبوه، انتساب پس از نصب، و تغییر مسیرها در نسخه بعدی در دسترس خواهند بود.

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

تاریخ انتشار: 28 آوریل 2022

Developer Preview 1 شامل پیش نمایش های اولیه Topics API و SDK Runtime است. عملکرد FLEDGE در Android و APIهای Attribution Reporting در نسخه بعدی در دسترس خواهد بود.

• موضوعات API
  • API getTopics() در حال حاضر مقادیر آزمایشی را بر اساس طبقه‌بندی آفلاین برای مجموعه محدودی از برنامه‌ها برمی‌گرداند. طبقه بندی روی دستگاه هنوز اجرا نشده است.
  • می‌توانید از دستورات adb برای نادیده گرفتن فواصل دوره‌ها و محاسبات دوره‌ای نیرو-تریگر استفاده کنید.
  • برای جزئیات ، راهنمای توسعه‌دهنده موضوعات را بخوانید.
• زمان اجرا SDK
  • می‌توانید با استفاده از عنصر <sdk-library> جدید در فایل مانیفست برنامه SDK خود، SDK‌های دارای زمان اجرا (RE SDK) را بسته‌بندی و بسازید. RE SDK ها را بر روی یک دستگاه آزمایشی یا شبیه ساز پشتیبانی شده نصب کنید، همانطور که معمولاً یک برنامه را در طول توسعه نصب می کنید.
  • می‌توانید یک برنامه را با RE SDK ادغام کنید، آن‌ها را در زمان اجرای SDK بارگیری کنید، و تأثیر دسترسی محدود را بر روی کد SDK آزمایش کنید - مجوزها، حافظه، و ارتباطات برنامه به SDK. API های ذخیره سازی برای RE SDK ها هنوز پیاده سازی نشده اند و در نسخه های بعدی در دسترس خواهند بود.
  • یک SDK می‌تواند آگهی‌های بنری مبتنی بر WebView یا محتوا را در زمان اجرا SDK ارائه دهد.
  • برای اطلاعات بیشتر راهنمای توسعه SDK Runtime را بخوانید.
• بررسی لینت اندروید
  • بررسی‌های لینت اندروید ممکن است به اشتباه هشدارها را در پروژه‌های کامپایل‌شده با TiramisuPrivacySandbox سطح API نشان دهد. به عنوان مثال، ممکن است پیام هشداری را مشاهده کنید: "تماس نیاز به سطح API 33 دارد". می توانید به طور موقت با استفاده از حاشیه نویسی @SuppressLint("NewApi") به این موضوع رسیدگی کنید.