‫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 من خلال أي قناة عادية يوفّرونها.

الخطوات التالية

تعرَّف على كيفية إدارة المستخدمين والمطوّرين لواجهة Topics API وتخصيصها بما يناسب الإعدادات المفضّلة للمستخدمين واحتياجاتهم.
يمكنك الاطّلاع على مراجعنا لتحديد المشاكل وحلّها والحصول على الدعم الفني وتسجيل الأخطاء وطرح الأسئلة.

انظر أيضًا

يمكنك الاطّلاع على مراجعنا لفهم Topics API على الويب بشكل أفضل.