يقدّم برنامج "مبادرة حماية الخصوصية" على Android الإصدار التجريبي من واجهات برمجة التطبيقات. يمكنك استخدام إصدارات الإصدار التجريبي من البرنامج لإنشاء حلول واختبارها في اختبار محدود للإصدار العلني على الأجهزة الجوّالة التي تعمل بالإصدار 13 من Android أو الإصدارات الأحدث لجميع واجهات برمجة التطبيقات والإصدار 12 من Android أو الإصدارات الأحدث لواجهة برمجة التطبيقات Attribution Reporting API (ARA). سنبدأ في دعم نسبة صغيرة من الأجهزة وسنزيد العدد بمرور الوقت. من أجل المشاركة، يمكن للمؤسسات طلب الوصول إلى عدد محدود من الأجهزة، بالإضافة إلى تسجيل أيّ تطبيقات تستخدِم واجهات برمجة تطبيقات "مبادرة حماية الخصوصية".
بالنسبة إلى "وقت تشغيل حزمة تطوير البرامج (SDK)"، سنوفّر إصدارًا تجريبيًا مغلقًا للمطوّرين لاختبار توزيع حِزم SDK المفعَّلة في وقت التشغيل على تطبيقات محدّدة.
لاستخدام الإصدار التجريبي، على المطوّرين تجميع حلولهم باستخدام تحديث لواجهة برمجة التطبيقات لمستوى 33 من حزمة تطوير البرامج (SDK).
إضافات حزمة تطوير البرامج (SDK) لنظام التشغيل Android
يتم توفير واجهات برمجة التطبيقات الثابتة في الإصدارات التجريبية باستخدام طريقة الإصدار الجديدة لـ "إضافات حزمة تطوير البرامج (SDK) لنظام التشغيل Android". تتيح طريقة الإصدار هذه طرح ميزات Android المستقرة بين الإصدارات الرئيسية. وتتضمّن آلية جديدة لإصدار الأنظمة توفّر واجهات برمجة تطبيقات جديدة للتطبيقات على مستويات متعددة من واجهات برمجة التطبيقات باستخدام تحديثات نظام Google Play . تُعرف إضافة "مبادرة حماية الخصوصية" على حزمة تطوير البرامج (SDK) لنظام التشغيل Android باسم إضافات Ad Services. اطّلِع على مزيد من المعلومات عن إضافات حزمة تطوير البرامج (SDK) لنظام التشغيل Android.
البدء
لبدء استخدام "مبادرة حماية الخصوصية" لنظام التشغيل Android، عليك اتّباع الخطوات التالية:
الخطوة 1: التسجيل في البرنامج التجريبي
- التسجيل: أكمِل عملية التسجيل ل استخدام واجهات برمجة التطبيقات ذات الصلة بالإعلانات.
- التسجيل: عليك التسجيل للمشاركة في البرنامج التجريبي.
يتيح لك التسجيل ما يلي:
- تفعيل أجهزتك الخاصة لأغراض الاختبار الداخلي
- عليك تحديد عدد محدود من التطبيقات المنشورة على "متجر Google Play" والتي يمكنها دمج واجهات برمجة التطبيقات المخصّصة للحفاظ على الخصوصية مباشرةً أو دمج حلول حِزم تطوير البرامج (SDK) التي تستخدم واجهات برمجة التطبيقات.
- اختبِر توزيع حزمة SDK المفعَّلة في وقت التشغيل باستخدام "متجر Google Play". إذا كنت بحاجة إلى اختبار "وقت تشغيل SDK" على الجهاز فقط، فهذه الخطوة ليست مطلوبة.
الخطوة 2: إعداد بيئة التطوير
إعداد "مبادرة حماية الخصوصية" على حزمة تطوير البرامج (SDK) لنظام التشغيل Android في "استوديو Android"
الخطوة 3: ضبط أذونات AdServices
عليك الإفصاح عن الأذونات الخاصة بواجهة برمجة التطبيقات وضبط أذونات الوصول إلى حِزمة تطوير البرامج (SDK) للوصول إلى موارد تديرها واجهة برمجة التطبيقات المستهدَفة.
الخطوة 4: إعداد جهاز أو صورة محاكي
لإجراء اختبارات شاملة، عليك التفاعل مع جهاز متوافق يعمل بالإصدار 13 من نظام التشغيل Android أو استخدام صورة المحاكي للحصول على إضافة حزمة تطوير البرامج (SDK) المناسبة.
الخطوة 5: ضبط الأجهزة لاستخدام "مبادرة حماية الخصوصية" على Android
يجب ضبط الإعدادات لتفعيل (أو إيقاف) "مبادرة حماية الخصوصية" على Android لتشغيلها على الأجهزة.
تحديد المشاكل المعروفة وحلّها
لتجنُّب المشاكل المعروفة في دمج PP API على الأجهزة التي تعمل بنظام التشغيل Android 12 والإصدارات الأقدم، على المطوّرين الذين يدمجون واجهات برمجة التطبيقات لخدمات عرض الإعلانات على هذه الأجهزة اتّباع الخطوات التالية:
- تأكَّد من أنّ ملف بيان تطبيق العميل يحتوي على علامة
<uses-library>extservices. والعلامة ذات الصلة هي:
<uses-library
android:name="android.ext.adservices"
android:required="false" />
- إذا كنت تستخدم
androidx.privacysandbox.adsمكتبة jetpack، تأكَّد من استخدام الإصدار 1.1.0-beta05 أو إصدار أحدث.
ما هي الموارد المتاحة للمطوّرين؟
يتضمّن برنامج "مبادرة حماية الخصوصية" على الإصدار التجريبي من Android الأدوات والموارد التالية.
صور نظام حزمة تطوير البرامج (SDK) والمحاكي
باستخدام "استوديو Android"، يمكنك تنزيل أحدث إضافة "خدمات إعلانية" وصور نظام المحاكي من خلال "أداة إدارة حزمة تطوير البرامج (SDK)". اطّلِع على مزيد من المعلومات حول كيفية إعداد بيئة التطوير وإعداد الوصول إلى واجهة برمجة التطبيقات.
مرجع واجهة برمجة تطبيقات
يتوفّر مرجع واجهة برمجة التطبيقات الكامل.
الدعم والتعليقات
أثناء الاختبار والتطوير باستخدام "مبادرة حماية الخصوصية" على Android، راجِع ملاحظات الإصدار واستخدِم أداة تتبُّع المشاكل للإبلاغ عن المشاكل وتقديم الملاحظات.
إبقاء بيئة التطوير محدّثة
ننصحك بشدة بتحديث بيئة التطوير باستخدام أحدث إصدار. ويضمن ذلك حصولك على أحدث الميزات ورموز تصحيح الأمان، وأنّ بيئتك متوافقة مع أحدث إصدارات الموارد التي تعتمد عليها. لتلقّي إشعارات بشأن الإصدارات الجديدة، اشترِك في الرسائل الإلكترونية التي تتضمّن آخر الأخبار.