‫Topics API: أدوات الاختبار والتحليل

تعرَّف على الأدوات المتاحة في Chrome لعرض معلومات Topics API وفهم كيفية تخصيص المواضيع وتصحيح أخطاء التنفيذ.

عرض معلومات Topics API

تتوفّر صفحة chrome://topics-internals في Chrome على أجهزة الكمبيوتر المكتبي بعد تفعيل Topics API. ويعرض ذلك مواضيع للمستخدم الحالي، والمواضيع التي يتم استنتاجها من أسماء المضيفين، ومعلومات فنية حول تنفيذ واجهة برمجة التطبيقات. نعمل على تكرار تصميم الصفحة وتحسينه استنادًا إلى ملاحظات مطوّري البرامج. يمكنك تشكيل Topics API عن طريق إرسال ملاحظاتك باعتبارها خلل Chromium.

عرض المواضيع التي تم رصدها لمتصفّحك

يمكن للمستخدمين الاطّلاع على معلومات حول المواضيع التي تمت رصدها في المتصفّح خلال الفترة الحالية والسابقة من خلال الاطّلاع على "chrome://topics-internals".

صفحة chrome://topics-internals التي تم فيها اختيار لوحة حالة المواضيع.
تعرض لوحة Topics State على صفحة chrome://topics-internals أرقام تعريف المواضيع وعمليات تخصيص المواضيع العشوائية والحقيقية وإصدارات التصنيف والنموذج.

توضّح لقطة الشاشة هذه أنّ المواقع الإلكترونية التي تمت زيارتها مؤخرًا تتضمّن topics-demo-cats.glitch.me وcats-cats-cats-cats.glitch.me. ويؤدي ذلك إلى اختيار Pets وCats كأهم موضوعَين في الفترة الحالية في Topics API. تم اختيار المواضيع الثلاثة المتبقية عشوائيًا، لأنّ سجلّ التصفّح (على المواقع الإلكترونية التي ترصد المواضيع) غير كافٍ لتقديم خمسة مواضيع.

يوفّر عمود نطاقات السياق التي يتم مراقبتها (مجزّأة) القيمة المجزّأة لاسم المضيف الذي تمت ملاحظة موضوع له.

عرض المواضيع التي تم استنتاجها من أسماء المضيفين

يمكنك أيضًا الاطّلاع على المواضيع التي استنتجها نموذج المصنِّف في Topics لاسم مضيف واحد أو أكثر في chrome://topics-internals.

صفحة chrome://topics-internals مع اختيار لوحة "المصنّف"
تعرض لوحة "المصنِّف" في صفحة chrome://topics-internals المواضيع التي تم اختيارها والمضيفون الذين تمت زيارتهم وإصدار النموذج ومساره.

ويستنتج التنفيذ الحالي لواجهة Topics API المواضيع من أسماء المضيفين فقط. وليس من أي جزء آخر من عنوان URL

استخدِم أسماء المضيفين فقط (بدون بروتوكول أو مسار) لعرض المواضيع المستنتَجة من مصنِّف chrome://topics-internals. chrome://topics-internals سيعرض خطأ إذا حاولت تضمين "/" في حقل "المضيف".

عرض معلومات Topics API

يمكنك العثور على معلومات عن تنفيذ Topics API وإعداداته، مثل إصدار التصنيف ومدة الحقبة، في chrome://topics-internals. تعكس هذه القيم الإعدادات التلقائية لواجهة برمجة التطبيقات أو المَعلمات التي تم ضبطها بنجاح من سطر الأوامر. وقد يفيد ذلك في التأكّد من أنّ علامات سطر الأوامر تعمل على النحو المتوقّع.

في المثال، تم ضبط time_period_per_epoch على 15 ثانية (الإعداد التلقائي هو سبعة أيام).

صفحة chrome://topics-internals مع اختيار لوحة "الميزات والمَعلمات"
تعرض لوحة "الميزات والمَعلمات" في chrome://topics-internals الميزات المفعَّلة والوقت في كل فترة وعدد الفترات المطلوب استخدامها لحساب المواضيع وإصدار التصنيف وإعدادات أخرى.

تتوافق المَعلمات المعروضة في لقطة الشاشة مع العلامات التي يمكن ضبطها عند تشغيل Chrome من سطر الأوامر. اطّلِع على مزيد من المعلومات حول كيفية التحكّم في Topics API باستخدام علامات Chrome في قسم الإعداد المخصّص.

--enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting

Colab

يمكنك تشغيل Colab للتعرُّف على طريقة تحميل نموذج TensorFlow Lite الذي يستخدمه Chrome لاستنتاج المواضيع من أسماء المضيفين. ستعثر على التعليمات في وصف العمل المشترَك أو في الفيديو التفصيلي. يُرجى العلم أنّ هذا العمل المشترَك يستخدم إصدار التصنيف القديم.

استخدام Topics API على المواقع الإلكترونية التي تستخدم prebid.js

كما هو موضّح في إصدار Prebid 7، طوّر المنتدى عملية دمج مع Topics API باستخدام وحدة جديدة. تم دمج هذه الوحدة في كانون الأول (ديسمبر) 2022. اطّلِع على مستندات وحدة Topics API في Prebid. لمزيد من المعلومات عن عملية الدمج، يُرجى التواصل مع فريق Prebid.js من خلال أي قناة عادية متاحة.

Next steps

Learn how users and developers can manage and customize the Topics API to suit user's preferences and needs.
Check out our resources for troubleshooting, technical support, filing bugs and asking questions.

See also

Check out our resources to better understand the Topics API on the Web.