إعلانات Privacy sandbox
androidx.privacysandbox.ads.adservices.adid
androidx.privacysandbox.ads.adservices.adselection
androidx.privacysandbox.ads.adservices.appsetid
androidx.privacysandbox.ads.adservices.common
androidx.privacysandbox.ads.adservices.customaudience
androidx.privacysandbox.ads.adservices.measurement
androidx.privacysandbox.ads.adservices.topics
التعديل الأخير | الإصدار المستقر | سحب المرشح | الإصدار التجريبي | إصدار أولي |
---|---|---|---|---|
21 آب (أغسطس) 2024 | - | - | من 1.1.0 إلى 10 | - |
إعلان التبعيات
لإضافة اعتمادية على privacysandbox-ads، يجب إضافة مستودع Google Maven إلى مشروعك. الاطّلاع على مستودع Maven من Google لمزيد من المعلومات.
أضِف الملحقات التابعة للعناصر التي تحتاجها في ملف build.gradle
لـ
لتطبيقك أو الوحدة التي تستخدمها:
Groovy
dependencies { implementation "androidx.privacysandbox.ads:ads-adservices:1.1.0-beta10" implementation "androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta10" }
Kotlin
dependencies { implementation("androidx.privacysandbox.ads:ads-adservices:1.1.0-beta10") implementation "androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta10" }
لمزيد من المعلومات حول العناصر الاعتمادية، يُرجى الاطّلاع على إضافة تبعيات الإصدار.
ملاحظات
تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كان لديك أفكار لتحسين هذه المكتبة. يُرجى إلقاء نظرة على المشاكل الحالية في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة تصويتك إلى مشكلة حالية عن طريق بالنقر فوق زر النجمة.
يُرجى الاطّلاع على مستندات أداة تتبُّع المشاكل. لمزيد من المعلومات.
الإصدار 1.1
الإصدار 1.1.0-beta10
21 آب (أغسطس) 2024
تم طرح androidx.privacysandbox.ads:ads-adservices:1.1.0-beta10
وandroidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta10
. يحتوي الإصدار 1.1.0-beta10 على عمليات التنفيذ هذه.
التغييرات في واجهة برمجة التطبيقات
- أضِف الأحمال الزائدة في أداة إنشاء Java غير المتوفّرة لواجهات برمجة التطبيقات التجريبية
GetAdSelectionDataOutcome
وPersistAdSelectionResultRequest
وReportEventRequest
وFetchAndJoinCustomAudienceRequest
. (I19e7f)
الإصدار 1.1.0-beta09
10 يوليو 2024
تم طرح androidx.privacysandbox.ads:ads-adservices:1.1.0-beta09
وandroidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta09
. يحتوي الإصدار 1.1.0-beta09 على عمليات الالتزام هذه.
التغييرات في واجهة برمجة التطبيقات
- أضِف الأحمال الزائدة لأداة إنشاء Java إلى واجهة برمجة التطبيقات التجريبية
GetAdSelectionDataRequest
. (Ifbf88).
الإصدار 1.1.0-beta08
26 يونيو 2024
تم طرح androidx.privacysandbox.ads:ads-adservices:1.1.0-beta08
وandroidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta08
. يحتوي الإصدار 1.1.0-beta08 على عمليات التنفيذ هذه.
الميزات الجديدة
- تمت إضافة دعم لإشارات التطبيقات المحمية.
- دعم العديد من مقدّمي الخدمات السحابية في إجراء مزادات على خوادم B&A
التغييرات في واجهة برمجة التطبيقات
- واجهة برمجة التطبيقات التجريبية
GetAdSelectionDataRequest::seller
غير قابلة للقيم الفارغة. (I68044) - إضافة واجهة برمجة التطبيقات التجريبية
GetAdSelectionDataRequest::coordinatorOriginUri
(I18c0b) - تمت إضافة واجهة برمجة التطبيقات
updateSignals
. (Ia8512)
الإصدار 1.1.0-beta07
14 مايو 2024
تم طرح androidx.privacysandbox.ads:ads-adservices:1.1.0-beta07
وandroidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta07
. يحتوي الإصدار 1.1.0-beta07 على عمليات التنفيذ هذه.
الميزات الجديدة
- يتيح
GetTopics
الآن الردود المشفّرة كجزء منGetTopicsResponse
.
التغييرات في واجهة برمجة التطبيقات
- تمت إضافة "
EncryptedTopic
" إلى صف واحد (GetTopicResponse
). (Iab362)
الإصدار 1.1.0-beta06
17 أبريل 2024
تم طرح androidx.privacysandbox.ads:ads-adservices:1.1.0-beta06
وandroidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta06
. يحتوي الإصدار 1.1.0-beta06 على عمليات التنفيذ هذه.
ملاحظة
- اعتبارًا من الإصدار 1.1.0-beta06 من حزمة privacysandbox-ads من حماية الخصوصية، ستتمكّن جميع أجهزة Android R التي تم تفعيل الإشارات بها من الوصول إلى واجهات برمجة التطبيقات PPAPI. في جميع حالات الاستخدام التي لا تتوافق مع Android R، سيُطلب منك توفير أدوات حماية إضافية ضمن الرمز باستخدام رمز privacysandbox-ads jetpack.
الميزات الجديدة
- دعم التوافق مع الأنظمة القديمة لنظام Android R.
الإصدار 1.1.0-beta05
3 أبريل 2024
تم طرح androidx.privacysandbox.ads:ads-adservices:1.1.0-beta05
وandroidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta05
. يحتوي الإصدار 1.1.0-beta05 على عمليات التنفيذ هذه.
إصلاح الأخطاء
- تمت إضافة رسالة الخطأ التي تظهر عند عدم العثور على تعريف الفئة على أجهزة Android S بسبب عدم توفّر علامة Use-library في البيان.
الإصدار 1.1.0-beta04
24 يناير 2024
تم طرح androidx.privacysandbox.ads:ads-adservices:1.1.0-beta04
وandroidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta04
. يحتوي الإصدار 1.1.0-beta04 على عمليات التنفيذ هذه.
الميزات الجديدة
- واجهة برمجة تطبيقات جديدة لإتاحة تقارير أحداث المستخدمين بعد المزاد
- إضافة دعم لتصفية تحديد عدد مرات الظهور لإعلانات تجديد النشاط التسويقي
- إتاحة تفويض "الانضمام إلى الجمهور المخصّص"
- دعم اقتطاع سلسلة توسّط الشلال
- دعم المزادات المحمية على خوادم عروض الأسعار والمزادات
التغييرات في واجهة برمجة التطبيقات
- تقديم واجهة برمجة التطبيقات التجريبية
AdSelectionManager::selectAds(AdSelectionFromOutcomesConfig)
(I86cd2) - تقديم واجهة برمجة التطبيقات
ReportEventRequest::inputEvent
التجريبية (Ib94f3) - جعل
ReportImpressionRequest::adSelectionConfig
اختيارية (Ief280) - تقديم واجهتَي برمجة التطبيقات
AdSelectionManager::getAdSelectionData
وAdSelectionManager::persistAdSelectionResultUnified
التجريبيتَين (Ie4d0e) - لمحة عن واجهة برمجة التطبيقات التجريبية
CustomAudienceManager::fetchAndJoinCustomAudience
(I09152) - تقديم واجهة برمجة التطبيقات
AdSelectionManager::reportEvent
التجريبية (I0d7dc) - تم تقديم واجهة برمجة التطبيقات التجريبية
AdSelectionManager::updateAdCounterHistogram
وتغييرAdData
للإشارة إلى سلسلة منAdFilters
(I87b83).
إصلاح الأخطاء
- تتم الآن مطابقة معرّفات الموارد المنتظمة (URI) التي يتم إدخالها مع موقع إلكتروني/مصدر مشترك بدلاً من طلب مطابقة تامة لاسم المضيف.
- إصلاح تعذُّر الاختبار بسبب عدم توفُّر مخطَّط HTTPS (d573058)
- حلّ مشكلة عدم توفّر مخطَّط HTTPS في عناوين URL على الويب (cecdcb8)
- إضافة تعليقات توضيحية لعمليات القياس إلى واجهات برمجة تطبيقات القياس (2dba359)
الإصدار 1.1.0-beta03
15 تشرين الثاني (نوفمبر) 2023
تم طرح androidx.privacysandbox.ads:ads-adservices:1.1.0-beta03
وandroidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta03
. يحتوي الإصدار 1.1.0-beta03 على هذه الالتزامات.
الميزات الجديدة
- دعم التوافق مع الأنظمة القديمة لنظام التشغيل Android S.
الإصدار 1.1.0-beta02
4 أكتوبر 2023
تم طرح androidx.privacysandbox.ads:ads-adservices:1.1.0-beta02
وandroidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta02
. يحتوي الإصدار 1.1.0-beta02 على عمليات التنفيذ هذه.
التغييرات في واجهة برمجة التطبيقات
- تمت إزالة التحقّق من إصدار T+ من فئات طلبات القياس. لا يحتاج العملاء إلى التحقّق من إصدار نظام T+ الأساسي من جانبهم للوصول إلى صفوف طلب Privacysandbox على
MeasurementManager
. ستكون MeasurementManager فارغة مع السلوك الجديد. (Ieb105)
الإصدار 1.1.0-beta01
23 آب (أغسطس) 2023
تم طرح androidx.privacysandbox.ads:ads-adservices:1.1.0-beta01
وandroidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta01
بدون أي تغييرات. يحتوي الإصدار 1.1.0-beta01 على عمليات التنفيذ هذه.
الإصدار 1.1.0-alpha01
9 آب (أغسطس) 2023
تم طرح androidx.privacysandbox.ads:ads-adservices:1.1.0-alpha01
وandroidx.privacysandbox.ads:ads-adservices-java:1.1.0-alpha01
. يحتوي الإصدار 1.1.0-alpha01 على عمليات التنفيذ هذه.
التغييرات في واجهة برمجة التطبيقات
- تقديم قائمة
registerSource
(Iae92f) - إزالة استخدامات واجهة برمجة التطبيقات
isAtLeastU()
التجريبية (Ie9117، b/289269026)
إصلاح الأخطاء
- دمج ملفات واجهة برمجة التطبيقات التجريبية والعامة (I15da3، b/278769092)
الإصدار 1.0
الإصدار 1.0.0-beta05
7 حزيران (يونيو) 2023
تم طرح androidx.privacysandbox.ads:ads-adservices:1.0.0-beta05
وandroidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta05
. يحتوي الإصدار 1.0.0-beta05 على عمليات التنفيذ هذه.
إصلاح الأخطاء
- إضافة فحص 5 من إضافة sdk إلى
TopicsManager
- يعمل على زيادة اعتمادية الكوروتينات في لغة Kotlin إلى 1.7.1 لمنع أخطاء إنشاء الصف المكرّرة في Gradle
الإصدار 1.0.0-beta04
10 أيار (مايو) 2023
تم طرح androidx.privacysandbox.ads:ads-adservices:1.0.0-beta04
وandroidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta04
. يحتوي الإصدار 1.0.0-beta04 على عمليات التنفيذ هذه.
إصلاح الأخطاء
- يمكنك حلّ مشكلة التوقف المؤقت عند استدعاء واجهات برمجة تطبيقات قياس الخدمات الإعلانية في سلسلة المحادثات الرئيسية من قِبل المتصل. (I65361)
الإصدار 1.0.0-beta03
19 نيسان (أبريل) 2023
تم طرح androidx.privacysandbox.ads:ads-adservices:1.0.0-beta03
وandroidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta03
. يحتوي الإصدار 1.0.0-beta03 على عمليات التنفيذ هذه.
الميزات الجديدة
- تم تفعيل واجهة برمجة التطبيقات لمعاينة Topics.
الإصدار 1.0.0-beta02
22 آذار (مارس) 2023
تم طرح androidx.privacysandbox.ads:ads-adservices:1.0.0-beta02
وandroidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta02
. يحتوي الإصدار 1.0.0-beta02 على عمليات التنفيذ هذه.
إصلاح الأخطاء
- تم تفعيل واجهات برمجة تطبيقات
MeasurementManager
لإضافة حزمة تطوير البرامج (SDK) الإصدار 5 والإصدارات الأحدث. - تم إيقاف واجهات برمجة تطبيقات
MeasurementManager
لإضافة حزمة تطوير البرامج (SDK) الإصدار 4 والإصدارات الأقدم.
الإصدار 1.0.0-beta01
22 شباط (فبراير) 2023
تم طرح androidx.privacysandbox.ads:ads-adservices:1.0.0-beta01
وandroidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta01
بدون أي تغييرات ملحوظة. تم طرح الإصدار 1.0.0-beta01 من فرع داخلي.
تغييرات السلوك
- تم إيقاف تقارير تحديد المصدر وهي غير متاحة للاستخدام في هذا الإصدار.
الإصدار 1.0.0-alpha01
11 كانون الثاني (يناير) 2023
تم طرح androidx.privacysandbox.ads:ads-adservices:1.0.0-alpha01
وandroidx.privacysandbox.ads:ads-adservices-java:1.0.0-alpha01
. تم إصدار الإصدار 1.0.0-alpha01 من فرع داخلي.
- مكتبة جديدة في Jetpack تتيح الدمج مع واجهات برمجة تطبيقات الحفاظ على الخصوصية في "مبادرة حماية الخصوصية" (Topics وFLEDGE وAttribution Reporting).
- يمكن استخدام واجهات برمجة تطبيقات "مبادرة حماية الخصوصية" في Jetpack كبديل لواجهات برمجة تطبيقات "مبادرة حماية الخصوصية" المتوفّرة في حزمة تطوير البرامج (SDK) 4 للإضافة.