مرحلة التجربة والتقييم الموحّدة لمدى الصلة بالموضوع والقياس

المواضيع والإطارات المحدودّة ومساحة التخزين المشتركة: keywords: product:PrivacySandbox, docType:Guide, topicAdSetup, contentTypeSolution, category:Web, apiGroupAds, audienceAdBuyer, audienceAdSeller, audienceAdMeasurementProvider, skill:Beginner

تتضمّن "مبادرة حماية الخصوصية" مجموعة من الاقتراحات لإتاحة حالات استخدام الإعلانات بدون الحاجة إلى التتبّع على مستوى المواقع الإلكترونية. توفّر فترات اختبار Origin فرصة للمطوّرين لتقييم تقنيات الويب الجديدة وتقديم ملاحظاتهم بشأنها من خلال الاختبار في الواقع. تقدّم مرحلة التجربة والتقييم في الملاءمة والقياس في "مبادرة حماية الخصوصية" تجربة واحدة تتيح للمواقع الإلكترونية إجراء تجارب موحّدة على مستوى Attribution Reporting وProtected Audience API وTopics وFenced Frames وShared Storage. يمكن للمطوّرين الاشتراك في مرحلة التجربة والتقييم هذه التي تتيح لك اختبار Topics API وProtected Audience API وAttribution Reporting API. يرشدك هذا الدليل خلال خطوات الإعداد للوصول إلى واجهات برمجة التطبيقات، ويوضّح كيفية التحقّق من صحة الإعدادات، ويقدّم المزيد من المراجع لاختبار واجهات برمجة التطبيقات.

التحقّق من حالة الفترة التجريبية الأصلية

حزيران (يونيو) 2023

زيادة بنسبة% 7 في ميزة "التجميع الخاص" في الإصدار الثابت

ستصبح Private Aggregation API متوفرة لنسبة% 7 من زيارات الإصدار الثابت من Chrome اعتبارًا من الثلاثاء 6 حزيران (يونيو) 2023. ستتوفّر واجهة برمجة التطبيقات في مجموعة التجربة والتقييم الموحّدة الرئيسية (%5) ومجموعة Protected Audience المعزولة (%1) ومجموعة Shared Storage المعزولة (%1). لن تتغيّر طريقة توزيع الزيارات على "شريحة الجمهور المحمية" و"مساحة التخزين المشتركة"، لأنّه تتم إضافة "التجميع الخاص" إلى التجارب المعزولة الحالية.

تخصيص الزيارات اعتبارًا من الثلاثاء 6 حزيران (يونيو):

واجهة برمجة التطبيقات تخصيص الزيارات الحالة
تقارير تحديد المصدر موحَّد - %5 %6 من عدد الزيارات الثابتة اعتبارًا من 13 آذار (مارس) 2023
معزولة - %1 - ARA فقط
الإطارات المضمّنة موحَّد - %5 ‫7% من عدد الزيارات الثابتة اعتبارًا من 13 آذار (مارس) 2023
العزل - %1 - مساحة التخزين المشتركة + التجميع الخاص + الإطارات المُحدودة فقط
معزول - %1 - الجمهور المحمي + التجميع الخاص + الإطارات المُقيّدة فقط
Protected Audience موحَّد - %5 %6 من عدد الزيارات الثابتة اعتبارًا من 13 آذار (مارس) 2023
معزول - %1 - الجمهور المحمي + التجميع الخاص + الإطارات المُقيّدة فقط
التجميع الخاص موحَّد - %5 ‫7% من عدد الزيارات الثابتة اعتبارًا من 6 حزيران (يونيو) 2023
معزول - %1 - الجمهور المحمي + التجميع الخاص + الإطارات المُقيّدة فقط
العزل - %1 - مساحة التخزين المشتركة + التجميع الخاص + الإطارات المُحدودة فقط
مساحة التخزين المشتركة موحَّد - %5 %6 من عدد الزيارات الثابتة اعتبارًا من 13 آذار (مارس) 2023
العزل - %1 - مساحة التخزين المشتركة + التجميع الخاص + الإطارات المُحدودة فقط
المواضيع موحَّد - %5 %6 من عدد الزيارات الثابتة اعتبارًا من 13 آذار (مارس) 2023
معزولة - %1 - المواضيع فقط

اطّلِع على آخر الأخبار السابقة حول الفترة التجريبية الأصلية.

نيسان (أبريل) 2023

زيادة بنسبة% 1 في ميزة "التجميع الخاص" في الإصدار الثابت

ستتوفّر مرحلة التجربة والتقييم لواجهة برمجة التطبيقات Private Aggregation API بنسبة% 1 من زيارات الإصدار الموحّد من Chrome التجريبية اعتبارًا من الاثنين 17 نيسان (أبريل). تتوفّر دالة sendHistogramReport() الخاصة بالتجميع الخاص لاستخدامها في وحدات عمل Protected Audience API وShared Storage.

ستظهر عملية تخصيص الزيارات على النحو التالي اعتبارًا من الاثنين 17 نيسان (أبريل):

واجهة برمجة التطبيقات تخصيص الزيارات الحالة
تقارير تحديد المصدر موحَّد - %5 %6 من عدد الزيارات الثابتة اعتبارًا من 13 آذار (مارس) 2023
معزولة - %1 - ARA فقط
الإطارات المضمّنة موحَّد - %5 ‫7% من عدد الزيارات الثابتة اعتبارًا من 13 آذار (مارس) 2023
معزولة - %1 - مساحة تخزين مشتركة (اختيار عنوان URL) + إطارات محصورة فقط
معزولة - %1 - Protected Audience API + إطارات محصورة فقط
Protected Audience API موحَّد - %5 %6 من عدد الزيارات الثابتة اعتبارًا من 13 آذار (مارس) 2023
معزولة - %1 - Protected Audience API + إطارات محصورة فقط
التجميع الخاص موحَّد - %1 %1 من عدد الزيارات الثابتة اعتبارًا من 17 نيسان (أبريل) 2023
مساحة التخزين المشتركة (اختيار عنوان URL) موحَّد - %5 %6 من عدد الزيارات الثابتة اعتبارًا من 13 آذار (مارس) 2023
معزولة - %1 - مساحة تخزين مشتركة (اختيار عنوان URL) + إطارات محصورة فقط
المواضيع موحَّد - %5 %6 من عدد الزيارات الثابتة اعتبارًا من 13 آذار (مارس) 2023
معزولة - %1 - المواضيع فقط

آذار (مارس) 2023

تعديل المخطط الزمني

لقد أبلغنا في البداية بأنّنا سنبدأ التجارب المنفصلة يوم الاثنين 13 آذار (مارس) 2023، ولكن ستبدأ التجارب الجديدة الآن يوم الخميس 16 آذار (مارس) 2023 بسبب الوقت الإضافي المطلوب لإعداد التجارب. سيتم أيضًا رفع معدّل استخدام واجهة برمجة التطبيقات Protected Audience API من ‎4% إلى ‎5%، وذلك يوم الخميس، 16 آذار (مارس) 2023.

زيادة معدّل زيادة Protected Audience API بنسبة% 1

في الشهر الماضي، خفضنا مؤقتًا عدد الزيارات إلى مرحلة التجربة والتقييم في Protected Audience API من% 5 إلى% 4 من الإصدار الثابت من Chrome المخصّص للاختبار. لقد انتهى الاختبار الأولي، ونخطّط لزيادة استخدام Protected Audience API إلى% 5 من% 4 في التجربة الموحّدة يوم الخميس 16 آذار (مارس) 2023.

وستكون مجموعة المستخدمين الذين تمّت زيادة عددهم هي نفسها مجموعة المستخدمين الذين تمّ إيقاف عرض إعلاناتهم. ومع ذلك، انتهت صلاحية مجموعات الاهتمامات السابقة، لأنّه مرّ أكثر من 30 يومًا على إيقافها.

التجارب المعزولة

لتحسين عملية الاختبار ومواصلة مراقبة مقاييس واجهات برمجة التطبيقات التجريبية الأصلية، نعمل على إنشاء تجارب معزولة لكل واجهة برمجة تطبيقات، بالإضافة إلى التجربة الموحّدة الحالية. سيتم إنشاء تجارب جديدة لميزة "إعداد تقارير تحديد المصدر" وTopics ومجموعة من Protected Audience API وFenced Frames ومجموعة من عملية اختيار عنوان URL في "مساحة التخزين المشتركة" وFenced Frames. في كل تجربة معزولة، لن تتوفّر سوى واجهات برمجة التطبيقات المحدّدة للمستخدمين في تلك المجموعة.

واجهة برمجة التطبيقات تخصيص الزيارات في التجربة المنعزلة
تقارير تحديد المصدر 1%
Protected Audience API + "الصور المُقسّمة" 1%
مساحة التخزين المشتركة (اختيار عنوان URL) + الإطارات المُحدودة 1%
المواضيع 1%

اعتبارًا من الخميس 16 آذار (مارس)، ستبدأ في تلقّي% 1 إضافية من زيارات الإصدار الثابت من Chrome لواجهات برمجة التطبيقات المذكورة أعلاه، بالإضافة إلى% 5 من الزيارات التيتلقّاها من التجربة الموحّدة الحالية. سيتم تخصيص المستخدِمين الجدد لكل تجربة.

تخصيص الزيارات

في ما يلي توزيع الزيارات الحالي لتجارب المصادر الموحّدة اعتبارًا من يوم الثلاثاء 28 شباط (فبراير):

واجهة برمجة التطبيقات تخصيص الزيارات في التجربة الموحّدة الحالية
تقارير تحديد المصدر 5%
الإطارات المضمّنة 5%
Protected Audience API 4%‎
مساحة التخزين المشتركة (اختيار عنوان URL) 5%
المواضيع 5%

ستظهر عملية تخصيص الزيارات على النحو التالي اعتبارًا من الخميس 16 آذار (مارس)، بعد إعادة زيادة سعة Protected Audience API وبدء التجارب الجديدة المعزولة:

واجهة برمجة التطبيقات تخصيص الزيارات الجديدة الحالة
تقارير تحديد المصدر موحَّد - %5 %6 من عدد الزيارات الثابتة اعتبارًا من 16 آذار (مارس) 2023
معزولة - %1 - ARA فقط
الإطارات المضمّنة موحَّد - %5 %7 من عدد الزيارات الثابتة اعتبارًا من 16 آذار (مارس) 2023
معزولة - %1 - مساحة تخزين مشتركة (اختيار عنوان URL) + إطارات محصورة فقط
معزولة - %1 - Protected Audience API + إطارات محصورة فقط
Protected Audience API الإصدار المُدمَج: %5 (%4 من المساحة المخصّصة حاليًا +% 1 من المساحة الاحتياطية) %6 من عدد الزيارات الثابتة اعتبارًا من 16 آذار (مارس) 2023
معزولة - %1 - Protected Audience API + إطارات محصورة فقط
مساحة التخزين المشتركة
(اختيار عنوان URL) 		موحَّد - %5 %6 من عدد الزيارات الثابتة اعتبارًا من 16 آذار (مارس) 2023
معزولة - %1 - مساحة تخزين مشتركة (اختيار عنوان URL) + إطارات محصورة فقط
المواضيع موحَّد - %5 %6 من عدد الزيارات الثابتة اعتبارًا من 16 آذار (مارس) 2023
معزولة - %1 - المواضيع فقط

لن تؤثّر هذه التغييرات في إعداد رمز الأمان الحالي لإصدار الإصدار التجريبي من التطبيق الأصلي، ولن يكون عليك تجديد رمز الأمان أو إنشاء رمز جديد.

كانون الثاني (يناير) 2023

في إطار التحقيق في حالات التراجع في Chrome، سنخفض مؤقتًا عدد الزيارات إلى مرحلة التجربة والتقييم في Protected Audience API من% 5 إلى% 4 من الإصدار الثابت من Chrome، وذلك اعتبارًا من 26 كانون الثاني (يناير) 2023. نتوقع أن يستغرق التحقيق شهرًا تقريبًا، وسنُعلمك عند إعادة زيادة عدد الزيارات.

سيتم تطبيق هذا التغيير تلقائيًا، ولن يؤثّر في الرموز المميّزة الحالية لإصدار الإصدار التجريبي من التطبيق الأصلي. بالنسبة إلى المستخدمين الذين يمثّلون نسبة% 1 من الزيارات التي سيتم إيقافها تدريجيًا، ستظل مجموعات الاهتمامات ظاهرة في متصفّحاتهم. سيكون المستخدمون نفسهم جزءًا من عملية زيادة السعة، ويمكن إعادة استخدام مجموعات الاهتمامات الخاصة بهم. ومع ذلك، تنتهي صلاحية مجموعات الاهتمامات بعد 30 يومًا، وقد يستغرق التحقيق في الانحدار وقتًا أطول من ذلك.

بالإضافة إلى ذلك، ستتم زيادة نطاق مرحلة التجربة والتقييم لواجهة برمجة التطبيقات URL Selection API في Shared Storage إلى% 5 من عدد زيارات الإصدار الثابت من Chrome اعتبارًا من 26 كانون الثاني (يناير) 2023.

واجهة برمجة التطبيقات ملاحظات
تقارير تحديد المصدر متوفّرة في الإصدار الثابت، وتمّ رفعها إلى% 5 اعتبارًا من 26 تشرين الأول (أكتوبر) 2022.
المواضيع متوفّرة في الإصدار الثابت، وتمّ رفعها إلى% 5 اعتبارًا من 26 تشرين الأول (أكتوبر) 2022.
Protected Audience API متوفّرة في الإصدار الثابت، وسيتم خفضها مؤقتًا إلى% 4 اعتبارًا من 26 كانون الثاني (يناير) 2023.
الأُطر المُحدودة تتوفّر في الإصدار الثابت، وستزيد إلى% 5 اعتبارًا من 9 تشرين الثاني (نوفمبر) 2022.
مساحة التخزين المشتركة متوفّرة في الإصدار الثابت، وستزيد بنسبة% 5 اعتبارًا من 26 كانون الثاني (يناير) 2023.

تشرين الثاني (نوفمبر) 2022

ستتوفّر واجهة برمجة التطبيقات selectURL في Shared Storage في مرحلة التجربة والتقييم بنسبة% 1 من زيارات الإصدار الثابت من Chrome اعتبارًا من 9 تشرين الثاني (نوفمبر).

كما أعلنّا سابقًا في مقالة المدونة زيادة نسبة مرحلة التجربة والتقييم لميزة "الملاءمة والقياس" في "مبادرة حماية الخصوصية" إلى%5، أصبحت نسبة استخدام ميزتَي "إعداد تقارير تحديد المصدر" وTopics الآن% 5، وستتوفّر أيضًا واجهة برمجة التطبيقات Protected Audience API وميزة "الأطر المُقيّدة" في 9 تشرين الثاني (نوفمبر).

واجهة برمجة التطبيقات ملاحظات
تقارير تحديد المصدر متوفّر في الإصدار الثابت، وتمّ رفعه إلى% 5 اعتبارًا من 26 تشرين الأول (أكتوبر).
المواضيع متوفّر في الإصدار الثابت، وتمّ رفعه إلى% 5 اعتبارًا من 26 تشرين الأول (أكتوبر).
Protected Audience API متوفّرة في الإصدار الثابت، وسيتمّ زيادتها إلى% 5 اعتبارًا من 9 تشرين الثاني (نوفمبر).
الأُطر المُحدودة متوفّرة في الإصدار الثابت، وسيتمّ زيادتها إلى% 5 اعتبارًا من 9 تشرين الثاني (نوفمبر).
مساحة التخزين المشتركة ستتوفّر في الإصدار الثابت، بدءًا من 1% اعتبارًا من 9 تشرين الثاني (نوفمبر).

تشرين الأول (أكتوبر) 2022: زيادة بنسبة% 5

تتوفّر حاليًا ميزات "تقارير تحديد المصدر" وTopics وProtected Audience API و"الأطر المُقيّدة" في الإصدار الثابت من Chrome، وستكون هذه الميزات جزءًا من الزيارات المتزايدة.

سنبدأ بزيادة عدد الزيارات إلى "تقارير تحديد المصدر" وTopics API اعتبارًا من هذا الأسبوع، وسنزيد من عدد الزيارات إلى Protected Audience API وFenced Frames اعتبارًا من 9 تشرين الثاني (نوفمبر).

يمكنك الاطّلاع على مزيد من المعلومات في مشاركة المدوّنة زيادة نسبة المشاركين في الفترة التجريبية لميزة "الملاءمة والقياس" في "مبادرة حماية الخصوصية" إلى%5.

واجهة برمجة التطبيقات ملاحظات
تقارير تحديد المصدر يتوفّر في الإصدار الثابت، وسيتمّ زيادته إلى% 5 بعد 26 تشرين الأول (أكتوبر).
المواضيع يتوفّر في الإصدار الثابت، وسيتمّ زيادته إلى% 5 بعد 26 تشرين الأول (أكتوبر).
Protected Audience API متوفّرة في الإصدار الثابت، وسيتمّ زيادتها إلى% 5 اعتبارًا من 9 تشرين الثاني (نوفمبر).
الأُطر المُحدودة متوفّرة في الإصدار الثابت، وسيتمّ زيادتها إلى% 5 اعتبارًا من 9 تشرين الثاني (نوفمبر).
مساحة التخزين المشتركة لا تتوفّر هذه الميزة حاليًا إلا في الإصدار M105 والإصدارات الأحدث من الإصدارات التجريبية وإصدارات Canary وإصدارات المطوّرين.

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

تم منح هذا التمديد لإعطاء المنظومة المتكاملة الوقت الكافي في قناة الإصدار الثابت ل مواصلة اختبار تحسينات واجهة برمجة التطبيقات والتحقق منها، مع تقديم ملاحظات بما يتوافق مع المخطط الزمني العلني الحالي.

لم يطرأ أي تغيير على المخطط الزمني العام لمبادرة حماية الخصوصية.

واجهات برمجة التطبيقات المضمّنة في الفترة التجريبية:

واجهة برمجة التطبيقات ملاحظات
تقارير تحديد المصدر دليل المطوِّر لإصدار الإصدار التجريبي من التطبيق
Protected Audience API دليل المطوِّر لإصدار الإصدار التجريبي من التطبيق
المواضيع دليل المطوِّر لإصدار الإصدار التجريبي من التطبيق
الإطارات المُقسّمة اطّلِع على إرشادات Protected Audience API لاستخدام مرحلة التجربة والتقييم.
مساحة التخزين المشتركة لا تتوفّر هذه الميزة حاليًا إلا في الإصدار M105 والإصدارات الأحدث من الإصدارات التجريبية وإصدارات Canary وإصدارات المطوّرين.

آب (أغسطس) 2022

أيار (مايو) 2022

يصبح الإصدار التجريبي من Topics متاحًا لنسبة% 50 من المستخدمين من الإصدار التجريبي 102 من Chrome.

واجهات برمجة التطبيقات المضمّنة في الفترة التجريبية:

واجهة برمجة التطبيقات ملاحظات
تقارير تحديد المصدر دليل المطوِّر لإصدار الإصدار التجريبي من التطبيق
Protected Audience API دليل المطوِّر لإصدار الإصدار التجريبي من التطبيق
المواضيع دليل المطوّر لمحاولة الإصدار الأول تم إيقاف Topics مؤقتًا في الفترة التجريبية الأصلية بسبب خطأ أثر بدوره في استقرار المتصفّح.
الإطارات المُقسّمة تمّت إضافة "الإطارات المحدودّة" إلى التجربة الأصلية. اطّلِع على إرشادات Protected Audience API لاستخدام التجربة.

نيسان (أبريل) 2022

تبدأ الفترة التجريبية لميزة "الإصدارات الأصلية" بنسبة محدودة من المستخدمين الذين يستخدمون الإصدار التجريبي من Chrome 102.

واجهات برمجة التطبيقات المضمّنة في الفترة التجريبية:

واجهة برمجة التطبيقات ملاحظات
تقارير تحديد المصدر مشاركة فردية حول الهدف من التجربة (I2E) تتوفّر ميزة "تقارير تحديد المصدر" أيضًا كمحاولة فردية لتحديد المصدر.
Protected Audience API مشاركة فردية حول الهدف من التجربة (I2E) تتوفّر Protected Audience API على أجهزة الكمبيوتر المكتبي فقط مع مجموعة فرعية من الوظائف.
المواضيع مشاركة فردية حول الهدف من التجربة (I2E)

الاشتراك في الفترة التجريبية الأصلية وضبطها

لتفعيل الفترة التجريبية للإصدار الأصلي على موقعك الإلكتروني، عليك تسجيل رمز مميّز تم تخصيصه للفترة التجريبية للإصدار الأصلي ودمجه (سلسلة تستند إلى الوقت للوصول إلى الفترة التجريبية للإصدار الأصلي). اطّلِع على مزيد من المعلومات في مقالة البدء في استخدام ميزات Chrome المخصّصة للمطوّرين التجريبية.

يتم منح الرموز المميّزة لتجربة Origin على الفور، ويمكنك إلغاؤها أو إعادة إنشائها في أي وقت.

في كل صفحة تريد استخدام الإصدار التجريبي الأصلي فيها، عليك تضمين رمز ترويجي للإصدار التجريبي مع رمز HTML أو استجابة تلك الصفحة المحدّدة.

استخدِم علامة <meta> في قسم <head> في الصفحة:

<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">

بدلاً من ذلك، يمكنك تضمين عنوان HTTP التالي في استجابة الصفحة:

Origin-Trial: TOKEN_GOES_HERE

الإعداد باستخدام إطار iframe

إذا كنت تستخدِم ميزات مرحلة التجربة والتقييم ضمن إطار iframe (مثل joinAdInterestGroup() في Protected Audience API)، يجب تقديم الرمز المميّز داخل إطار iframe ومطابقة مصدر إطار iframe.

ضبط الإعدادات على مستوى المواقع الإلكترونية باستخدام JavaScript

إذا كنت تستخدِم ميزات الإصدار التجريبي من التطبيق الأصلي من خلال JavaScript على مستوى الموقع الإلكتروني، أي أنّك مزوّد JavaScript التابع لجهة خارجية والمضمّن في صفحة المستوى الأعلى، عليك إجراء ما يلي:

  • اختَر مطابقة الجهات الخارجية عند التسجيل في الإصدار التمهيدي لميزة "الشراء داخل التطبيق".
  • يجب أن يكون حقل "مصدر الويب" هو مصدر النص البرمجي.
  • أدرِج علامة <meta> في صفحة المستوى الأعلى (أي صفحة الطرف الأول ، وليس المحتوى الخاص بك) من النص البرمجي. على سبيل المثال:
const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);

تصحيح أخطاء مرحلة التجربة والتقييم

يمكنك التحقّق من حالة الفترة التجريبية للإصدار الأصلي في لوحة أدوات المطوّرين > التطبيقات.

حالة الرمز المميّز &quot;تمّت العملية بنجاح&quot; و&quot;مفعّل&quot;
حالة نجاح الرمز المميّز وتفعيله
  1. انتقِل للأسفل إلى لوحة اللقطات.
  2. اختَر الإطار الذي تتوقّع ضبط الرمز المميّز فيه. على سبيل المثال، العلوي إطار للصفحة ذات المستوى الأعلى أو إطار iframe المحدّد للصفحات المضمّنة.
  3. في اللوحة اليمنى، انتقِل للأسفل إلى قسم إصدارات Origin التجريبية.
  4. من المفترض أن يظهر لك إدخال لتجربة PrivacySandboxAdsAPIs.
  5. وسِّع هذا الإدخال للاطّلاع على حالة الفترة التجريبية الأصلية وعلامات المعيّنة.

تقتصر الفترة التجريبية الأصلية على جزء من مستخدمي Chrome وقد لا يكون متصفّحك ضمن مجموعة التجربة. ونتيجةً لذلك، قد تظهر لك رسالة TrialNotAllowed باللون الأحمر بجانب PrivacySandboxAdsAPIs. عند توسيع الإدخال للتحقّق من حالة الرمز المميّز، إذا ظهرت رسالة Success خضراء، هذا يعني أنّ إعدادات الإصدار التجريبي من المصدر صحيحة. ستظهر للمستخدمين المؤهَّلين الرسالة التي تم ضبطها على Enabled.

حالة &quot;نجاح الرمز المميّز&quot; غير مفعّلة.
حالة نجاح الرمز المميّز وعدم تفعيله:

إذا ظهرت لك رسائل مختلفة، يمكنك الرجوع إلى تحديد المشاكل وحلّها في تجارب Chrome التمهيدية للحصول على قائمة تحقّق مفصلة للتأكّد من إعدادات التجربة التمهيدية.

رصد العناصر

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

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // Attribution Reporting enabled
}

if ('runAdAuction' in navigator) {
  // Protected Audience API enabled
}

if ('browsingTopics' in document) {
  // Topics enabled
}

if ('HTMLFencedFrameElement' in window) {
  // Fenced Frames enabled
}

if ('sharedStorage' in window) {
  // Shared Storage enabled
}

if (window?.sharedStorage?.selectURL instanceof Function) {
  // optionally check specifically for the selectURL function in Shared Storage
}

تحديد أهلية المستخدم

يتم تشغيل الإصدار التجريبي من الإصدار الأصلي لعدد صغير من مستخدمي Chrome. ويجب أيضًا أن تكون الوظائف ذات الصلة مفعّلة في إعداداتهم ليصبحوا مؤهّلين للاستفادة من الإصدار التجريبي:

إعدادات المتصفح

لكي يكون المستخدم مؤهلاً للاستفادة من الفترة التجريبية، يجب استيفاء الشروط التالية:

  • استخدام إصدار وقناة من Chrome تم فيها بدء مرحلة تجربة وتقييم Topics

  • أن تكون ضمن المجموعة التجريبية النشطة في Chrome

إعدادات المستخدم

لكي يكون المستخدم مؤهلاً للاستفادة من الفترة التجريبية، يجب أن يستوفي أيضًا الشروط التالية:

  • تفعيل الفترة التجريبية لمبادرة حماية الخصوصية من خلال الانتقال إلى الإعدادات > الأمان والخصوصية > مبادرة حماية الخصوصية، أو من خلال chrome://settings/adPrivacy
  • تفعيل ملفات تعريف الارتباط التابعة لجهات خارجية من خلال الإعدادات > الأمان والخصوصية > ملفات تعريف الارتباط وبيانات المواقع الإلكترونية الأخرى التي تم ضبطها على "السماح بكل ملفات تعريف الارتباط" أو "حظر ملفات تعريف الارتباط التابعة لجهات خارجية في وضع التصفّح المتخفي"، ويمكن الوصول إليها أيضًا من خلال chrome://settings/cookies
  • أن تكون في جلسة تصفّح عادية وليس في وضع التصفّح المتخفي

على الرغم من أنّ الفترة التجريبية الأصلية لن تظهر كنشطة إلا للمستخدمين المؤهَّلين، يمكنك أيضًا استخدام إشارات المطوّرين للاختبار على موقعك الإلكتروني المخصّص للإصدارات العلنية.

التحكّم في مشاركتك في الفترة التجريبية الأصلية

تظل آلية الإصدار التجريبي من المصدر كما هي: يمكنك الحصول على رمز الإصدار التجريبي من المصدر للسياقات التي تريد تجربة واجهات برمجة التطبيقات فيها. مع توسيع نطاق اختبار الميزة، يجب التأكّد من مراقبة مستوى الزيارات التي اخترت تفعيل الميزة فيها والتحكّم فيه.

من الطرق الجيدة اتّباع الخطوات التالية:

  1. أدرِج رمزَي الإصدار التجريبي الأصليَين تلقائيًا في جميع السياقات التي تريد إجراء التجربة فيها.
  2. استخدِم ميزة رصد الميزات للبحث عن واجهات برمجة التطبيقات النشطة.
  3. إذا كانت واجهات برمجة التطبيقات نشطة (وبالتالي، يكون المتصفّح مؤهّلاً لهذه تجربته)، اختَر ما إذا كنت تريد استخدامها أم لا استنادًا إلى معايير تجربتك. على سبيل المثال، إذا كانت لديك بالفعل بنية أساسية لاختبار أ/ب بهدف إجراء تجارب على نسبة مئوية من عدد الزيارات أو أخذ عيّنات أو بعض السمات الأخرى، يمكنك في هذه المرحلة تحديد الميزات التي ستستخدمها بشكل نشط.

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

التحكّم في مرحلة التجربة والتقييم حسب المنطقة الجغرافية

لا يمكنك إيقاف إصدار تجريبي من مصدر في مناطق معيّنة. تكون تجارب المصدر فعالة على الصفحات التي تحتوي على الرمز المميّز، والذي يتم تضمينه من خلال عناوين HTTP (من جهة الخادم) أو علامات HTML الوصفية (من جهة العميل).

إذا كان بإمكانك تحديد الموقع الجغرافي للمستخدم، يمكنك كتابة رمز لتضمين رمز مفتاح بدء الفترة التجريبية استنادًا إلى معلومات الموقع الجغرافي هذه. على سبيل المثال، يمكنك محاولة استخدام عناوين IP لتحديد الموقع الجغرافي للمستخدم. يمكن تزوير عناوين IP، لذا هذا الحلّ ليس مضمونًا.

ومع ذلك، يمكن أن يضبط مصدر جغرافي معيّن سياسة الأذونات للتحكّم في الميزات التي يمكن استخدامها. على سبيل المثال، us.example.com وuk.example.com هما مصدران جغرافيان يمكن التحكّم فيهما. ولا يعني ذلك أنّه تم إيقاف مرحلة تقييم وتجربة ميزة في أحد المناطق.

من خلال سياسة الأذونات، يضيف الموقع الإلكتروني مقتطفًا صغيرًا من الرمز إلى صفحاته يقدّم تعليمات للمتصفّح. عند تحميل الصفحة، يقرأ المتصفّح تعليمات سياسة الأذونات وسيسمح بالميزات (أو واجهة برمجة التطبيقات) أو حظرها على النحو الموضّح في سياسة الأذونات. إذا أراد موقع إلكتروني حظر واجهة برمجة تطبيقات في منطقة معيّنة، يمكن للمطوّر ضبط سياسة لجميع الصفحات المطلوبة من تلك المنطقة.

تجديد الرمز المميّز

تنتهي صلاحية الرموز المميّزة لإصدار Origin التجريبي بعد ستة أسابيع من تاريخ إصدارها (أو في نهاية الفترة التجريبية إذا كان ذلك أقرب).

من المهم تجديد علامات التشفير الجديدة ونشرها خلال هذه الفترة لكي تتمكّن من استخدام ميزات الفترة التجريبية الأصلية بدون انقطاع.

لا يستغرق تجديد الرموز المميّزة سوى بضع دقائق، ويمكنك نشر رموز مميّزة متعددة لمحاولة الإصدار التجريبي نفسها ضمن الصفحة نفسها. يمكنك نشر رمز مميّز تم تجديده قبل انتهاء صلاحية رمزك المميّز الحالي، وبالتالي لن تتوقّف الخدمة عن العمل لدى المستخدمين.

الاختبار على الجهاز

للحصول على إرشادات محدّدة حول اختبار المطوّرين المحليين، يُرجى الاطّلاع على:

لا تكون واجهات برمجة التطبيقات مفعّلة تلقائيًا، ويجب تفعيلها باستخدام علامات بغرض الاختبار. يجب التأكّد من تفعيل إعدادات الضبط نفسها أعلاه، ثم اتّباع الخطوات التالية:

  • استخدِم إصدارًا وقناة من Chrome تتوفّر فيها الميزات.
  • فعِّل جميع واجهات برمجة التطبيقات المتعلّقة بالخصوصية في عرض الإعلانات ضمن chrome://settings/adPrivacy.

اطّلِع على أدلة المطوّرين لمعرفة مدى توفّر واجهات برمجة تطبيقات وميزات معيّنة و علامات إضافية لإعدادات أكثر دقة.