إعلانات مبادرة حماية الخصوصية

الإعلان عن التبعيات

لإضافة تبعية على privacysandbox-ads، يجب إضافة مستودع Google Maven إلى مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف التبعيات للعناصر التي تحتاج إليها في ملف build.gradle ل تطبيقك أو وحدتك:

dependencies {
 
    implementation "androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12"
   
    implementation "androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12"
 
}

dependencies {

    implementation("androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12")

    implementation "androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12"
   
}

لمزيد من المعلومات عن العناصر الاعتمادية، اطّلِع على مقالة إضافة عناصر الاعتماد الخاصة بالإصدار.

الملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا واجهت مشاكل جديدة أو كان لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية عن طريق النقر على زرّ النجمة.

إنشاء مشكلة جديدة

اطّلِع على مستندات أداة تتبُّع المشاكل لمزيد من المعلومات.

الإصدار 1.1

الإصدار 1.1.0-beta12

12 آذار (مارس) 2025

تم إصدار androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12 وandroidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12. يتضمّن الإصدار 1.1.0-beta12 عمليات الربط هذه.

الميزات الجديدة

• أولوية شريحة الجمهور المخصّصة: أضفنا حقل أولوية في شريحة الجمهور المخصّصة. يتيح ذلك للمشترين تحديد قيمة الأولوية في CustomAudience. سيتم استخدام هذه القيمة لتحديد شرائح الجمهور المخصّصة التي يجب تضمينها في مزاد إذا تجاوزت مجموعة شرائح الجمهور المخصّصة للمشترين الحدود القصوى للحجم لكلّ مشترٍ.
• إعدادات البائع: تتيح هذه الميزة للبائعين تحديد مَعلمات المزاد للتحكّم في حجم الحمولة ومستخدِمي المزاد. ستسمح إعدادات مزاد البائعين للبائعين بتحديد ما يلي:
  • قائمة المشترين المسموح بهم
  • بالنسبة إلى المزادات التي يبدأها البائع المحدّد، لن يتمكّن سوى المشترين المدرَجين في القائمة المسموح بها من المساهمة CustomAudiences في المزاد.
  • الحدّ الأقصى المسموح به للحجم لكل مشترٍ
  • يمكن للبائعين تحديد حدّ لكلّ مشترٍ لتنظيم حجم البيانات التي يحمّلها كلّ مشترٍ في الحمولة التي يتمّ إرسالها إلى SellerFrontendService. إذا تجاوز حجم بيانات المشتري الحدّ الأقصى المسموح به لكلّ مشتري، سيتم استخدام الأولوية CustomAudience التي تم ضبطها في إعدادات الحمولة المشتري للحصول على البيانات ضمن الحدود المتوقّعة.
  • الحد الأقصى المسموح به لحجم الحمولة
  • قد يكون لدى البائعين المختلفين عمليات تخصيص موارد مختلفة، وقد يريدون ضبط حدّ أقصى للحجم الخاص بحمولة مزاد كل طلب. سيراعي الحد الأقصى للحجم الحِزم ذات الحجم الثابت التي تحدّدها واجهة برمجة التطبيقات ProtectedAudience.
• تعديلات الجمهور المخصّص المتأخرة: تتيح هذه الميزة للمشترين جدولة تعديلات مؤجّلة للجماهير المخصّصة. يسمح كل طلب تحديث للمتصل بجدولة تحديث متأخر باستخدام واجهة برمجة التطبيقات الجديدة scheduleCustomAudienceUpdate() API. في كلّ تعديل، يمكن للمستخدم تحديد مجموعات من شرائح الجمهور المخصّصة للانضمام إليها أو الخروج منها.

تغييرات واجهة برمجة التطبيقات

• إضافة إعدادات البائع في واجهة برمجة التطبيقات GetAdSelectionRequest (Ibb5c7)
• طرح ScheduleCustomAudienceUpdate API كإصدار تجريبي (I6b905)

الإصدار 1.1.0-beta11

30 تشرين الأول (أكتوبر) 2024

تم إصدار androidx.privacysandbox.ads:ads-adservices:1.1.0-beta11 وandroidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta11. يتضمّن الإصدار 1.1.0-beta11 هذه المراجعات.

الميزات الجديدة

• يزيل هذا التعديل إمكانية استخدام واجهتَي برمجة التطبيقات privacysandbox measurement وadid API على نظام التشغيل Android R، اللتين تم إيقافهما نهائيًا. ستؤدي الآن طلبات الحصول على فئات المدير على Android R إلى عرض قيمة فارغة.

الإصدار 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 Experimental API. (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 jetpack، ستتمكّن جميع أجهزة 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 بسبب عدم توفّر علامة uses-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() API (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 على هذه المراجعات.

إصلاح الأخطاء

• إضافة عملية تحقّق من إضافة حزمة تطوير البرامج (SDK) 5 إلى TopicsManager
• رفع الإصدار المرجعي لـ Kotlin coroutines إلى 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 على هذه المراجعات.

الميزات الجديدة

• تم تفعيل واجهة برمجة التطبيقات Preview API لخدمة 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 Extension الإصدار 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 Privacy Sandbox API كبديل فوري لواجهات برمجة تطبيقات Privacy Sandbox API المقدَّمة في Extension SDK 4.