يمكنك إجراء تجارب ومعرفة كيفية استنتاج المواضيع من أسماء المضيفين بخطوات بسيطة من حيث الإعداد.
حالة التنفيذ
- أكملت Topics API مرحلة المناقشة العلنية وهي متاحة حاليًا لنسبة 99 بالمائة من المستخدمين وبنسبة تصل إلى 100 بالمائة.
- لتقديم ملاحظاتك وآرائك حول Topics API، يمكنك إنشاء مشكلة في المواضيع التوضيحية أو المشاركة في المناقشات في مجموعة أعمال تحسين الإعلانات على الويب. يحتوي التفسير على عدد من الأسئلة المفتوحة التي لا تزال تتطلب تعريفًا إضافيًا.
- يوفّر المخطط الزمني لـ "مبادرة حماية الخصوصية" مخططات زمنية لتنفيذ Topics API وغيرها من اقتراحات "مبادرة حماية الخصوصية".
- Topics API: تعرض آخر التحديثات التغييرات والتحسينات التي طرأت على Topics API وعمليات التنفيذ.
يوفّر العرض التوضيحي لـ Topics API نظرة على كيفية استنتاج المواضيع من أسماء المضيفين. يمكنك معاينة المواضيع التي يتم رصدها عند زيارة موقع إلكتروني تجريبي، الأمر الذي يتطلب القليل جدًا من الإعداد.
يقدّم العرض التوضيحي الذي نقدّمه معاينة توضّح معظم ميزات Topics API لكي تطّلع على كيفية استخدام واجهة برمجة التطبيقات.
يمكنك أيضًا تنفيذ ميزة التعاون في المواضيع لتجربة نموذج مصنّف المواضيع.
يعرض الفيديو التالي طريقة عمل العرض التوضيحي.
الاختبار باستخدام chrome://flags أو علامات الميزات
تتوفّر طريقتان لتجربة Topics API كمستخدم واحد، وعليك استخدام الإصدار 101 من Chrome أو الإصدارات الأحدث منه:
تفعيل واجهة برمجة التطبيقات في صفحة Chrome "
chrome://flags/#privacy-sandbox-ads-apis
":شغِّل متصفِّح Chrome من سطر الأوامر باستخدام العلامات التالية:
--enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/browsing_topics_max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting
الإصدار التجريبي من Topics API
يعرض العرض التوضيحي للمواضيع كيفية استخدام العلامات الإضافية لضبط الإعدادات، مثل طول الفترة. في حال الوصول إلى Topics API من خلال تشغيل Chrome باستخدام علامات سطر الأوامر، يجب عدم ضبط chrome://flags
، لأنّ ذلك قد يؤدي إلى إلغاء إعدادات سطر الأوامر.
يوضح مقالة تشغيل Chromium باستخدام العلامات كيفية إعداد العلامات عند تشغيل Chrome والمتصفّحات الأخرى المستندة إلى Chromium من سطر الأوامر، على الرغم من أنّ هذا العرض التوضيحي يخصّ Google Chrome فقط.
عرض توضيحي لعناوين Topics API
إنّ العرض التوضيحي على الرابط topics-fetch-demo.glitch.me يعرض كيفية استخدام عناوين الطلبات والاستجابة fetch()
للوصول إلى المواضيع ووضع علامة عليها بأنّه تم رصدها.
الوصول إلى عنوان طلب "Sec-Browsing-Topics
"
بدلاً من استخدام document.browsingTopics()
من إطار iframe لعرض المواضيع لأحد المستخدمين، يمكن للمُتصِلين عبر واجهة برمجة التطبيقات الوصول إلى المواضيع التي تم رصدها من خلال عنوان طلب Sec-Browsing-Topics
الخاص بطلب fetch() الذي يتضمّن {browsingTopics: true}
في مَعلمة الخيارات الخاصة به، أو من العنوان نفسه لطلب XHR الذي يضبط السمة deprecatedBrowsingTopics
على true
.
مثال:
fetch('https://topics-server.glitch.me', {browsingTopics: true})
.then((response) => {
// Process the response
})
في المتصفّحات المتوافقة مع واجهة برمجة التطبيقات، سيتضمّن طلب fetch()
عنوان Sec-Browsing-Topics
الذي يسرد المواضيع التي تم رصدها لاسم المضيف لعنوان URL للطلب: في هذا المثال، topics-server.glitch.me
.
إذا لم يتم رصد أي مواضيع لاسم المضيف هذا وهذا المستخدم، يتم تضمين العنوان ولكن القيمة فارغة. بمعنى آخر، لا يتضمّن عنوان Sec-Browsing-Topics
في طلب fetch()
سوى المواضيع التي تم رصدها في متصفّح المستخدم الحالي من خلال المتصل الذي يتطابق مصدره مع اسم المضيف لعنوان URL للطلب. الأمر نفسه كما لو كنت تستدعي document.browsingTopics()
من إطار iframe لعرض المواضيع التي تمت ملاحظتها للمستخدم الحالي.
يتم إرسال عنوان الطلب في الطلب ما دام له سياسة الأذونات المناسبة قيد التشغيل، والسياق آمن، وإعدادات المستخدم تسمح بذلك. لا يتم توفير المواضيع في العناوين الخاصة بطلبات التنقل.
يبدو عنوان طلب المواضيع على النحو التالي:
Sec-Browsing-Topics: 186;version="chrome.1:1:2206021246";config_version="chrome.1";model_version="2206021246";taxonomy_version="1", 265;version="chrome.1:1:2206021246";config_version="chrome.1";model_version="2206021246";taxonomy_version="1"
يتضمن هذا المثال موضوعين من تصنيف المواضيع، 186 و265، إلى جانب معلومات إصدار كل موضوع.
يتوفّر تضمين عنوان المواضيع في طلبات XHR مؤقتًا فقط، وستتم إزالة الدعم في المستقبل.
وضع علامة على المواضيع على أنّها تمت ملاحظتها من خلال Observe-Browsing-Topics
إذا تضمّن أحد الطلبات عنوان Sec-Browsing-Topics
وكانت الاستجابة لهذا الطلب تتضمّن عنوان Observe-Browsing-Topics: ?1
، سيحدّد المتصفِّح المواضيع من عنوان الطلب على أنّه تم رصدها. تكون المواضيع التي يتم رصدها مؤهّلة لاحتسابها بواسطة Topics API. وقد تم تصميم هذه الآلية لمطابقة الوظيفة المتوفرة باستخدام واجهة برمجة تطبيقات JavaScript من إطار iframe.
تعرض لقطة الشاشة أدناه المواضيع المسجّلة من زيارة المواقع الإلكترونية في صفحة العرض التوضيحي لواجهة برمجة التطبيقات.
تعرض هذه القائمة المواقع الإلكترونية التي يمكن زيارتها من خلال العرض التوضيحي لتسجيل المواضيع التي تهمّك. كما ترى، فئة الفنون والترفيه/الفكاهة في لقطة الشاشة ليست موضوع أحد هذه المواقع، لذا فإن هذا الموضوع المسجّل هو موضوع تمت إضافته كموضوعات عشوائية محتملة بنسبة 5 في المائة.
- pets-animals-pets-cats.glitch.me
- cats-cats-cats-cats.glitch.me
- cats-pets-animals-pets.glitch.me
- cats-feline-meow-purr-whiskers-pet.glitch.
يمكنك الاطّلاع على المواضيع الحقيقية وتلك العشوائية في علامة التبويب "حالة المواضيع" على صفحة chrome://topics-internals
. تعرض لقطة الشاشة هذه مثالاً من جلسات تصفُّح مختلفة.
الخطوات التالية
إذا كنت من مطوّري تكنولوجيا الإعلان، يمكنك تجربة Topics API والمشاركة فيها. اقرأ دليل المطوِّر للحصول على المزيد من المراجع المفصّلة.
التفاعل مع الملاحظات ومشاركتها
- GitHub: يمكنك الاطّلاع على الشرح الخاص بـ Topics API وطرح الأسئلة ومتابعة النقاشات بشأن المشاكل في مستودع واجهة برمجة التطبيقات.
- W3C: مناقشة حالات الاستخدام في المجال من خلال Optimize Web Advertising Business Group.
- الإشعارات: الانضمام إلى القائمة البريدية أو الاطّلاع عليها.
- دعم مطوّري برامج "مبادرة حماية الخصوصية": يمكنك طرح الأسئلة والمشاركة في النقاشات في مستودع دعم مطوّري برامج "مبادرة حماية الخصوصية".
- Chromium: يمكنك الإبلاغ عن خطأ في Chromium لطرح أسئلة حول طريقة التنفيذ المتاحة حاليًا في Chrome.