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

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

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

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

طرح Private Aggregation API بنسبة% 7 في الإصدار الثابت

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

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

واجهة برمجة التطبيقات تخصيص الزيارات الحالة
إعداد تقارير تحديد المصدر موحَّد - %5 ‫6% من زيارات قناة الإصدار الثابت اعتبارًا من 13 مارس 2023
معزولة - %1 - العربية فقط
الأُطر المضمّنة المستقلة موحَّد - %5 ‫7% من عدد الزيارات إلى الإصدار الثابت اعتبارًا من 13 مارس 2023
معزولة - %1 - مساحة التخزين المشتركة + التجميع الخاص + الإطارات المحصّنة فقط
معزولة - %1 - Protected Audience + Private Aggregation + Fenced Frames فقط
Protected Audience موحَّد - %5 ‫6% من زيارات قناة الإصدار الثابت اعتبارًا من 13 مارس 2023
معزولة - %1 - Protected Audience + Private Aggregation + Fenced Frames فقط
التجميع الخاص موحَّد - %5 ‫7% من عدد الزيارات على الإصدار الثابت اعتبارًا من 6 يونيو 2023
معزولة - %1 - Protected Audience + Private Aggregation + Fenced Frames فقط
معزولة - %1 - مساحة التخزين المشتركة + التجميع الخاص + الإطارات المحصّنة فقط
Shared Storage موحَّد - %5 ‫6% من زيارات قناة الإصدار الثابت اعتبارًا من 13 مارس 2023
معزولة - %1 - مساحة التخزين المشتركة + التجميع الخاص + الإطارات المحصّنة فقط
المواضيع موحَّد - %5 ‫6% من زيارات قناة الإصدار الثابت اعتبارًا من 13 مارس 2023
معزولة - %1 - المواضيع فقط

التعديلات السابقة

اطّلِع على التحديثات السابقة بشأن التجربة الأصلية.

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

طرح Private Aggregation API بنسبة% 1 في الإصدار الثابت

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

سيبدو توزيع الزيارات على النحو التالي بدءًا من الاثنين 17 أبريل:

واجهة برمجة التطبيقات تخصيص الزيارات الحالة
إعداد تقارير تحديد المصدر موحَّد - %5 ‫6% من الزيارات الثابتة اعتبارًا من 13 مارس 2023
محدود - %1 - العربية فقط
الأُطر المضمّنة المستقلة موحَّد - %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
Shared Storage (اختيار عنوان 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 يومًا على عملية الإيقاف التدريجي.

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

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

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

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

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

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

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

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

واجهة برمجة التطبيقات تخصيص الزيارات الجديدة الحالة
إعداد تقارير تحديد المصدر موحَّد - %5 ‫6% من الزيارات الثابتة اعتبارًا من 16 مارس 2023
محدود - %1 - العربية فقط
الأُطر المضمّنة المستقلة موحَّد - %5 ‫7% من زيارات الإصدار الثابت اعتبارًا من 16 مارس 2023
معزولة - %1 - مساحة التخزين المشتركة (اختيار عنوان URL) + إطارات مسيّجة فقط
معزولة - %1 - واجهة Protected Audience API + إطارات مسيّجة فقط
Protected Audience API موحَّد - %5 (النسبة الحالية% 4 +% 1 زيادة تدريجية) ‫6% من الزيارات الثابتة اعتبارًا من 16 مارس 2023
معزولة - %1 - واجهة Protected Audience API + إطارات مسيّجة فقط
Shared Storage
(اختيار عنوان 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 في "مساحة التخزين المشتركة" لتشمل% 5 من زيارات الإصدار الثابت من Chrome اعتبارًا من 26 كانون الثاني (يناير) 2023.

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

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

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

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

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

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

تتوفّر حاليًا كلّ من Attribution Reporting وTopics وProtected Audience API وFenced Frames في الإصدار الثابت من Chrome، وستكون جزءًا من الزيارات المتزايدة.

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

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

واجهة برمجة التطبيقات ملاحظات
Attribution Reporting يتوفّر في الإصدار الثابت، وستزيد النسبة إلى% 5 بعد 26 أكتوبر.
المواضيع يتوفّر في الإصدار الثابت، وستزيد النسبة إلى% 5 بعد 26 أكتوبر.
‫Protected Audience API متوفّرة في الإصدار الثابت، وستزيد إلى% 5 اعتبارًا من 9 نوفمبر.
الأُطر المضمّنة المستقلة متوفّرة في الإصدار الثابت، وستزيد إلى% 5 اعتبارًا من 9 نوفمبر.
Shared Storage لا تتوفّر هذه الميزة حاليًا إلا في الإصدارات 105 والإصدارات الأحدث من Canary وDev وBeta.

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

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

يبقى المخطط الزمني العام لمبادرة Privacy Sandbox بدون تغيير.

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

واجهة برمجة التطبيقات ملاحظات
Attribution Reporting دليل المطوِّرين الخاص بالتجربة الأصلية
‫Protected Audience API دليل المطوِّرين الخاص بالتجربة الأصلية
المواضيع دليل المطوِّرين الخاص بالتجربة الأصلية
الأُطر المضمّنة المستقلة راجِع إرشادات Protected Audience API بشأن استخدام مرحلة التجربة والتقييم.
Shared Storage لا تتوفّر هذه الميزة حاليًا إلا في الإصدارات 105 والإصدارات الأحدث من Canary وDev وBeta.

آب (أغسطس) 2022

  • تتوفّر التجربة الأصلية تدريجيًا لتشمل % 1 من مستخدمي أجهزة الكمبيوتر المكتبي من الإصدار 104 الثابت من Chrome.
  • سيتم إرسال إشعارات عند توفّر هذه الميزة لمستخدمي الأجهزة الجوّالة.
  • ستبقى القنوات السابقة للإصدار الثابت (Canary والإصدار التجريبي) عند نسبة% 50 من المستخدمين.
  • لا تتوفّر واجهات برمجة التطبيقات على متصفّح Chrome لنظام التشغيل iOS.

أيار (مايو) 2022

تتوفّر مرحلة التجربة والتقييم لما يصل إلى % 50 من المستخدمين من الإصدار التجريبي 102 من Chrome.

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

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

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

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

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

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

الاشتراك في التجربة الأصلية وإعدادها

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

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

في كل صفحة تريد استخدام التجربة الأصلية فيها، عليك تضمين رمز مميّز للتجربة مع رمز 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);

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

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

حالة النجاح للرمز المميّز مفعَّلة.
حالة نجاح الرمز المميّز مفعَّلة.
  1. انتقِل للأسفل إلى جزء الإطارات.
  2. اختَر الإطار الذي تتوقّع ضبط الرمز المميّز فيه. على سبيل المثال، الإطار الأعلى للصفحة ذات المستوى الأعلى أو إطار iframe المحدّد للصفحات المضمّنة.
  3. في اللوحة اليمنى، انتقِل للأسفل إلى قسم التجارب الأصلية.
  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 تتوفّر فيهما التجربة الأصلية

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

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

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

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

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

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

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

في هذه الحالة، ننصحك بما يلي:

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

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

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

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

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

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

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

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

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

من المهم جدًا تجديد الرموز المميزة الجديدة ونشرها خلال هذه الفترة الزمنية لضمان الاستخدام المتواصل لميزات التجربة الأصلية.

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

الاختبار محليًا

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

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

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

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