المواضيع، والإطارات الخاضعة لقيود، ومساحة التخزين المشتركة. الكلمات الرئيسية: product:PrivacySandbox, docType:Guide, topicAdSetup, contentTypeSolution, category:Web, apiGroupAds, audienceAdbuy, audienceAd Seller, audienceAdMeasurementProvider، مهارة:مبتدئ
تتضمّن "مبادرة حماية الخصوصية" مجموعة من الاقتراحات لإتاحة استخدام الإعلانات. الحالات بدون الحاجة إلى تتبُّع إجراءات المستخدم على مواقع إلكترونية متعددة. المصدر الفترات التجريبية فرصة للمطوّرين لتقييم وتقديم تعليقات حول تقنيات الويب الجديدة من خلال الاختبار في العالم الحقيقي. تشير رسالة الأشكال البيانية مدى صلة "مبادرة حماية الخصوصية" مرحلة التجربة والتقييم توفّر تجربة واحدة تتيح للمواقع الإلكترونية تنفيذ تجارب موحّدة على مستوى Attribution Reporting وProtected Audience API وTopics وFenced Frames وShared مساحة التخزين: يمكن للمطوّرين الاشتراك في مرحلة التجربة والتقييم هذه التي تتيح لك اختبار في Topics وProtected Audience API وAttribution Reporting API. هذا النمط إلى خطوات الإعداد للوصول إلى واجهات برمجة التطبيقات، يخبرك كيفية التحقّق من صحة الإعدادات، وتوفير موارد إضافية للاختبار مقابل واجهات برمجة التطبيقات.
التحقّق من حالة مرحلة التجربة والتقييم
حزيران (يونيو) 2023
زيادة بنسبة% 7 في التجميع الخاص في القناة الثابتة
ستصبح واجهة برمجة تطبيقات التجميع الخاص بنسبة% 7 من عدد الزيارات الثابتة في Chrome اعتبارًا من يوم الثلاثاء 6 حزيران (يونيو) 2023 واجهة برمجة التطبيقات ستكون متاحة في المجموعة الرئيسية التجريبية وموحّدة للمصدر (%5)، ومحمية مجموعة معزولة عن الجمهور (%1) ومجموعة معزولة عن مساحة التخزين المشتركة (%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 في التجميع الخاص في القناة الثابتة
نظرة عامة
ستتوفَّر مرحلة التجربة والتقييم على Aggregation API بنسبة 1% من إصدار Chrome الثابت
زيارات التجربة الموحّدة من الاثنين 17 نيسان (أبريل). sendHistogramReport()
تتوفّر وظيفة التجميع الخاص لاستخدامها في Protected Audience API.
ومساحة التخزين المشتركة
المهن الصغيرة.
سيبدو تخصيص الزيارات على النحو التالي بدءًا من الاثنين 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 بسبب الوقت الإضافي اللازم لإعداد التجارب. نسبة 1% سيشهد يوم الخميس أيضًا زيادة في نسبة استخدام Protected Audience API من% 4 إلى% 5 16 آذار (مارس) 2023
استعادة الأداء بنسبة% 1 من Protected Audience API
في الشهر الماضي، خفّضنا مؤقتًا عدد الزيارات الواردة من مرحلة التجربة والتقييم في Protected Audience API من% 5 إلى% 4 من إجمالي عدد زيارات Chrome الثابتة للاختبار. انتهى الاختبار الأولي، ونخطط لإعادة استخدام Protected Audience API بنسبة% 5 بدلاً من% 4 للتجربة الموحّدة في يوم الخميس 16 آذار (مارس) 2023.
وسيمثّل المستخدمون المتزايدون مجموعة المستخدمين نفسها التي تحسَّنت. مع ذلك، انتهت صلاحية مجموعات الاهتمامات السابقة بسبب مرور أكثر من 30 يومًا على إجراء التخفيض.
التجارب المعزولة
لتحسين عملية الاختبار ومواصلة تتبُّع مقاييس واجهات برمجة التطبيقات الخاصة بمراحل التجربة والتقييم، نعمل على إنشاء تجارب معزولة لكل واجهة برمجة تطبيقات، بالإضافة إلى التجربة الموحّدة الحالية. سيتم إنشاء تجارب جديدة لكل من "تقارير تحديد المصدر" و"مواضيع الإعلانات"، وهي مزيج من Protected Audience API وFenced Frames، بالإضافة إلى عملية اختيار عناوين URL من مساحة التخزين المشتركة والإطارات المحاطة بحدود. في كل تجربة معزولة، لن تتوفّر سوى واجهات برمجة التطبيقات المخصّصة للمستخدمين في تلك المجموعة.
واجهة برمجة التطبيقات | تخصيص زيارات التجارب المعزولة |
---|---|
تقارير تحديد المصدر | 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 يومًا، وقد يستغرق التحقيق في الانحدار وقتًا أطول من ذلك.
اعتبارًا من 26 كانون الثاني (يناير) 2023، سيتم أيضًا زيادة عدد زيارات واجهة برمجة التطبيقات لتحديد عناوين URL ضمن مساحة التخزين المشتركة إلى% 5 من عدد الزيارات الثابتة في Chrome.
واجهة برمجة التطبيقات | ملاحظات |
---|---|
تقارير تحديد المصدر | متوفّرة في القناة الثابتة، وبنسبة% 5 اعتبارًا من 26 تشرين الأول (أكتوبر) 2022 |
المواضيع | متوفّرة في القناة الثابتة، وبنسبة% 5 اعتبارًا من 26 تشرين الأول (أكتوبر) 2022 |
Protected Audience API | متوفّرة في القناة الثابتة، وسيقلّت مؤقتًا إلى 4% اعتبارًا من 26 كانون الثاني (يناير) 2023 |
الإطارات المحاطة بإطار | متوفّرة في القناة الثابتة، وتزيد النسبة إلى% 5 اعتبارًا من 9 تشرين الثاني (نوفمبر) 2022 |
مساحة التخزين المشتركة | متوفّرة في القناة الثابتة، بزيادة بنسبة 5% اعتبارًا من 26 كانون الثاني (يناير) 2023 |
تشرين الثاني (نوفمبر) 2022
ستنضم واجهة برمجة التطبيقات `selectURL` لمساحة التخزين المشتركة إلى مرحلة التجربة والتقييم عند نسبة 1% من عدد الزيارات الثابتة في Chrome اعتبارًا من 9 تشرين الثاني (نوفمبر).
كما أعلنّا سابقًا في مشاركة المدونة زيادة مرحلة التجربة والتقييم ومدى الصلة بالموضوع ضمن "مبادرة حماية الخصوصية" إلى 5%، أصبحت الآن "تقارير تحديد المصدر" و"المواضيع" متوفرة بنسبة 5% مع Protected Audience API وFenced Frames بعد ذلك في 9 تشرين الثاني (نوفمبر).
واجهة برمجة التطبيقات | ملاحظات |
---|---|
تقارير تحديد المصدر | متوفّرة في القناة الثابتة، وبزيادة تبلغ 5% عن 26 تشرين الأول (أكتوبر). |
المواضيع | متوفّرة في القناة الثابتة، وبزيادة تبلغ 5% عن 26 تشرين الأول (أكتوبر). |
Protected Audience API | متوفّرة في القناة الثابتة، وبنسبة زيادة إلى% 5 اعتبارًا من 9 تشرين الثاني (نوفمبر). |
الإطارات المحاطة بإطار | متوفّرة في القناة الثابتة، وبنسبة زيادة إلى% 5 اعتبارًا من 9 تشرين الثاني (نوفمبر). |
مساحة التخزين المشتركة | ستكون متوفّرة في القناة الثابتة، بدءًا من 1% اعتبارًا من 9 تشرين الثاني (نوفمبر). |
تشرين الأول (أكتوبر) 2022: زيادة بنسبة% 5
تتوفّر تقارير Attribution وTopics وProtected Audience API وFenced Frames حاليًا في إصدار Chrome الثابت، وستكون جزءًا من عدد الزيارات المتزايد.
سنبدأ في زيادة عدد الزيارات إلى "تقارير تحديد المصدر" و"المواضيع" بدءًا من هذا الأسبوع، وسنزيد عدد الزيارات إلى Protected Audience API وFenced Frames اعتبارًا من 9 تشرين الثاني (نوفمبر).
يمكنك الاطّلاع على مزيد من المعلومات في مشاركة المدونة زيادة مرحلة التجربة والتقييم ومدى الصلة بمبادرة حماية الخصوصية إلى 5%.
واجهة برمجة التطبيقات | ملاحظات |
---|---|
تقارير تحديد المصدر | تتوفّر هذه الميزة في القناة الثابتة، وتزيد إلى% 5 بعد 26 تشرين الأول (أكتوبر). |
المواضيع | تتوفّر هذه الميزة في القناة الثابتة، وتزيد إلى% 5 بعد 26 تشرين الأول (أكتوبر). |
Protected Audience API | متوفّرة في القناة الثابتة، وبنسبة زيادة إلى% 5 اعتبارًا من 9 تشرين الثاني (نوفمبر). |
الإطارات المحاطة بإطار | متوفّرة في القناة الثابتة، وبنسبة زيادة إلى% 5 اعتبارًا من 9 تشرين الثاني (نوفمبر). |
مساحة التخزين المشتركة | هذه الميزة متاحة حاليًا فقط في الإصدار M105 من إصدارات Canary أو إصدار مطوّري البرامج أو الإصدارات التجريبية. |
تشرين الأول (أكتوبر) 2022
- تم تمديد الفترة التجريبية للمصدر إلى Chrome 110.
- مقالة بدء استخدام مراحل التجربة والتقييم في Chrome، توضّح كيفية تجديد التسجيل في مرحلة التجربة والتقييم. يشمل ذلك توفير رمز مميّز جديد للمصادر المشارِكة، وهي العملية نفسها التي تتّبعها أي إضافة أخرى للتجربة الأصلية.
تم منح هذا التمديد لمنح المنظومة المتكاملة في القناة الثابتة إلى ومواصلة اختبار التحسينات على واجهة برمجة التطبيقات والتحقّق منها مع تقديم الملاحظات متسقًا مع الجدول الزمني العام الحالي لدينا.
سيظلّ المخطط الزمني لـ "مبادرة حماية الخصوصية" العام بدون تغيير.
واجهات برمجة التطبيقات المضمّنة في الفترة التجريبية:
واجهة برمجة التطبيقات | ملاحظات |
---|---|
تحديد المصدر إعداد التقارير | المطوّر لمرحلة التجربة والتقييم. |
Protected Audience API | المطوّر لمرحلة التجربة والتقييم. |
المواضيع | المطوّر لمرحلة التجربة والتقييم. |
مجهّزة بسور الإطارات | اطّلِع على إرشادات Protected Audience API بشأن استخدام مرحلة التجربة والتقييم. |
الفيديوهات التي تمّت مشاركتها مساحة التخزين | هذه الميزة متاحة حاليًا فقط في الإصدار M105 من إصدارات Canary أو إصدار مطوّري البرامج أو الإصدارات التجريبية. |
آب (أغسطس) 2022
- يزيد مدى توفّر الإصدار التجريبي المصدر بنسبة تصل إلى 1% من مستخدمي أجهزة كمبيوتر سطح المكتب من إصدار Chrome الثابت 104.
- وستتبع التحديثات عندما يشمل التوفُّر مستخدمي الأجهزة الجوّالة.
- تظلّ القنوات الثابتة (إصدار Canary والإصدار التجريبي) مضبوطة على% 50 من المستخدمين.
- لا تتوفّر واجهات برمجة التطبيقات في متصفِّح Chrome على نظام التشغيل iOS.
أيار (مايو) 2022
يزيد مدى توفّر الإصدار التجريبي من المصدر بنسبة تصل إلى 50% من المستخدمين بعد استخدام الإصدار التجريبي من Chrome 102.
واجهات برمجة التطبيقات المضمّنة في الفترة التجريبية:
واجهة برمجة التطبيقات | ملاحظات |
---|---|
تحديد المصدر إعداد التقارير | المطوّر لمرحلة التجربة والتقييم. |
Protected Audience API | المطوّر لمرحلة التجربة والتقييم. |
المواضيع | دليل المطوِّر مرحلة التجربة والتقييم. تم إيقاف المواضيع لفترة قصيرة في مرحلة التجربة والتقييم بسبب خطأ في ثبات المتصفّح. |
مجهّزة بسور الإطارات | تمّت إضافة ميزة Fenced Frames إلى مرحلة التجربة والتقييم. الاطّلاع على إرشادات Protected Audience API لاستخدام التجربة. |
نيسان (أبريل) 2022
تبدأ الفترة التجريبية للمنشأ بنسبة محدودة من المستخدمين من الإصدار التجريبي من Chrome 102.
واجهات برمجة التطبيقات المضمّنة في الفترة التجريبية:
واجهة برمجة التطبيقات | ملاحظات |
---|---|
تحديد المصدر إعداد التقارير | نيّة فردية على مشاركة التجربة (I2E). تتوفر تقارير الإحالة أيضًا باسم مرحلة التجربة والتقييم الفردي. |
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 (مثل عناصر واجهة برمجة التطبيقات Protected Audience API)
joinAdInterestGroup()
)، حينها يجب تقديم الرمز المميّز ضمن إطار 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);
تصحيح أخطاء مرحلة التجربة والتقييم
يمكنك التحقّق من حالة مرحلة التجربة والتقييم في DevTools >. التطبيقات اللوحة.
![حالة نجاح الرمز المميّز:](https://developers.google.cn/privacy-sandbox/assets/images/token-success-status.avif?hl=ar)
- مرِّر للأسفل وصولاً إلى جزء الإطارات.
- اختَر الإطار الذي تتوقّع ضبط الرمز المميّز فيه. على سبيل المثال، يعرض الجزء العلوي إطارًا لصفحة المستوى الأعلى أو إطار iframe محددًا للصفحات المضمّنة.
- في اللوحة اليسرى، انتقِل للأسفل وصولاً إلى القسم مراحل التجربة والتقييم.
- من المفترض أن يظهر لك إدخال في الفترة التجريبية لخطة
PrivacySandboxAdsAPIs
. - وسِّع هذا الإدخال للاطّلاع على حالة مرحلة التجربة والتقييم الرموز المميزة.
تقتصر الفترة التجريبية للمصدر على جزء صغير من مستخدمي Chrome، وقد
ألا تكون في المجموعة التجريبية. نتيجةً لذلك، قد تظهر علامة TrialNotAllowed
باللون الأحمر.
رسالة ضد PrivacySandboxAdsAPIs
. عند توسيع الإدخال للتحقق من
حالة الرمز المميّز: إذا ظهرت رسالة Success
خضراء، يشير ذلك إلى مرحلة التجربة والتقييم
التهيئة صحيحة. ستظهر الرسالة التي تم ضبطها على "Enabled
" للمستخدمين المؤهَّلين.
![حالة نجاح الرمز المميّز: غير مفعّلة.](https://developers.google.cn/privacy-sandbox/assets/images/token-success-status-not-enabled.avif?hl=ar)
إذا ظهرت لك رسائل مختلفة، راجِع المقالة تحديد المشاكل في مصدر 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
- في جلسة تصفُّح عادية ووليس في وضع التصفّح المتخفي.
على الرغم من أنّ مرحلة التجربة والتقييم لن تظهر إلا على أنّها نشطة للمستخدمين المؤهَّلين، يمكنك أيضًا استخدِم بلاغات المطوّرين لإجراء اختبار مقارنةً بمرحلة الإنتاج الخاصة بك. موقعك.
التحكّم في مشاركتك في مرحلة التجربة والتقييم
تظل آليات مرحلة التجربة والتقييم كما هي: ستحصل على النسخة التجريبية. للسياقات حيث تريد تجربة واجهات برمجة التطبيقات. مع مجموعة اختبار موسعة، فيجب عليك التأكد من أنك تراقب بشكل نشط والتحكم في مستوى الزيارات التي تختار تفعيل الفترة التجريبية فيها
أفضل أسلوب هنا هو:
- ضمِّن الرموز المميّزة الخاصة بمراحل التجربة والتقييم تلقائيًا في جميع السياقات التي تريد تجربتنا.
- استخدِم رصد الميزات للبحث عن واجهات برمجة تطبيقات نشطة.
- إذا كانت واجهات برمجة التطبيقات نشطة (وبالتالي، يكون المتصفّح مؤهَّلاً لذلك) اختر ما إذا كنت تريد استخدامها بناءً على تجربتك أم لا المعايير. على سبيل المثال، إذا كانت لديك بالفعل بنية أساسية لاختبار A/B إجراء التجارب على نسبة مئوية من الزيارات أو عينات أو بعض السمات الأخرى، يمكنك في هذه المرحلة تحديد الميزات التي ستستخدمها بشكل نشط.
يمكنك منع المشاركة في مرحلة التجربة والتقييم تمامًا لأي متصفّح. على سبيل المثال عن طريق عدم تضمين الرمز المميز في الإجابة. على سبيل المثال، إذا كان لديك قد استوفت حصتك الخاصة لإجراء تجربة أو تحتاج إلى معالجة مشكلة ما خلال لفترة تجريبية، فإن عدم تضمين الرمز المميز يضمن عدم حدوث متاحة أو نشطة في الصفحة.
التحكّم في التجربة والتقييم حسب المنطقة الجغرافية
لا يمكنك إيقاف مرحلة التجربة والتقييم في مناطق محدّدة. مراحل التجربة والتقييم هي نشط على الصفحات التي تحتوي على رمز مميّز، مضمَّن من خلال عناوين HTTP (من جهة الخادم) أو علامات HTML الوصفية (من جهة العميل).
إذا كان بإمكانك تحديد الموقع الجغرافي للمستخدم، يمكنك كتابة رمز لتضمينه. الرمز المميز لتجربة المصدر استنادًا إلى معلومات الموقع هذه. على سبيل المثال، قد يحاول استخدام عناوين IP لتحديد الموقع الجغرافي للمستخدم. عناوين IP ويمكن انتحال هويته، بحيث لا يكون هذا الحل مضمونًا.
ومع ذلك، يمكن لأصل خاص بالجغرافيا ضبط الأذونات
سياسة للتحكّم في الميزات
للاستخدام. على سبيل المثال، us.example.com
وuk.example.com
هما.
أصول خاصة بمناطق جغرافية محددة يمكن التحكم فيها. هذا لا يعني أن
المنطقة التي اختارت إيقاف مرحلة تجربة المصدر.
يضيف أحد المواقع الإلكترونية مقتطفًا صغيرًا من الرمز إلى صفحاته بموجب سياسة الأذونات. يقدم إرشادات للمتصفّح. عندما يتم تحميل الصفحة، يستخدم المتصفح قراءة تعليمات "سياسة الأذونات" والسماح بالميزات أو حظرها (أو واجهات برمجة التطبيقات) على النحو المبيّن في سياسة الأذونات. إذا أراد أحد المواقع الإلكترونية فرض قيود على واجهة برمجة تطبيقات في منطقة معينة، يمكن لمطوّر البرامج وضع سياسة لجميع الصفحات المطلوبة من تلك المنطقة
تجديد الرمز المميّز
تنتهي صلاحية الرموز المميّزة الخاصة بمراحل التجربة والتقييم بعد ستة أسابيع من تاريخ إصدارها (أو في نهاية التجريبية إذا كان ذلك أسرع).
من الضروري تجديد الاشتراك الجديد ونشره والرموز المميزة ضمن تلك النافذة الاستخدام بلا انقطاع لميزات مرحلة التجربة والتقييم.
يستغرق تجديد الرموز المميّزة بضع دقائق فقط، ويمكنك تفعيل عدة رموز نفس التجربة في نفس الصفحة. يمكنك تفعيل رمز مميّز مُجدَّد قبل بانتهاء صلاحية الرمز المميز الحالي، لذلك ليس هناك فاصل في الخدمة للمستخدمين.
الاختبار محليًا
للحصول على إرشادات محدّدة بشأن اختبار المطوّرين المحليين، يُرجى الاطّلاع على:
يُرجى العلم أنّ واجهات برمجة التطبيقات لا تكون مفعَّلة بشكل تلقائي ويجب تفعيلها مع علامات لـ اختبار الفرضية. يجب التأكد من تفعيل إعدادات الضبط نفسها ثم:
- استخدام إصدار وقناة من Chrome في حال توفُّر هذه الميزات
- تفعيل جميع واجهات برمجة تطبيقات الخصوصية في عرض الإعلانات ضمن "
chrome://settings/adPrivacy
"
راجع أدلة المطوِّرين لمعرفة مدى توفُّر واجهات برمجة التطبيقات والميزات علامات إضافية للحصول على تهيئة أكثر دقة.