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

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

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

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

dependencies {

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

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

لمزيد من المعلومات حول العناصر الاعتمادية، يُرجى الاطّلاع على إضافة تبعيات الإصدار.

ملاحظات

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

إنشاء عدد جديد

راجِع مستندات "أداة تتبُّع المشاكل" للحصول على مزيد من المعلومات.

الإصدار 1.1

الإصدار 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 للإضافة.