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

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

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

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

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

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

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

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

يقدّم عمود نطاقات سياق "المرصود من خلال" (مجزّأة) القيمة المجزّأة لاسم مضيف تم رصد موضوع له.

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

يمكنك أيضًا الاطّلاع على المواضيع التي استنتجها نموذج المصنِّف في 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 لاستنتاج المواضيع من أسماء النطاقات. يمكنك العثور على التعليمات في وصف colab أو في فيديو الجولة الإرشادية. يُرجى العِلم أنّ هذا التعاون يستخدم الإصدار القديم من التصنيف.

استخدام 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.