عروض توضيحية لواجهة برمجة تطبيقات Topics

يمكنك إجراء تجارب ومعرفة كيفية استنتاج المواضيع من أسماء المضيفين بخطوات بسيطة من حيث الإعداد.

حالة التنفيذ

يوفّر العرض التوضيحي لـ Topics API نظرة على كيفية استنتاج المواضيع من أسماء المضيفين. يمكنك معاينة المواضيع التي يتم رصدها عند زيارة موقع إلكتروني تجريبي، الأمر الذي يتطلب القليل جدًا من الإعداد.

يقدّم العرض التوضيحي الذي نقدّمه معاينة توضّح معظم ميزات Topics API لكي تطّلع على كيفية استخدام واجهة برمجة التطبيقات.

يمكنك أيضًا تنفيذ ميزة التعاون في المواضيع لتجربة نموذج مصنّف المواضيع.

يعرض الفيديو التالي طريقة عمل العرض التوضيحي.

الاختبار باستخدام chrome://flags أو علامات الميزات

تتوفّر طريقتان لتجربة Topics API كمستخدم واحد، وعليك استخدام الإصدار 101 من Chrome أو الإصدارات الأحدث منه:

  • تفعيل واجهة برمجة التطبيقات في صفحة Chrome "chrome://flags/#privacy-sandbox-ads-apis":

    تفعيل Topics API باستخدام صفحة chrome://flags/#privacy-sandbox-ads-apis
    صفحة 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.

تعرض لقطة الشاشة أدناه المواضيع المسجّلة من زيارة المواقع الإلكترونية في صفحة العرض التوضيحي لواجهة برمجة التطبيقات.

صفحة الإصدار التجريبي من Topics API على الموقع glitch.me
العرض التوضيحي لـ glitch.me لتجربة واجهة برمجة التطبيقات.

تعرض هذه القائمة المواقع الإلكترونية التي يمكن زيارتها من خلال العرض التوضيحي لتسجيل المواضيع التي تهمّك. كما ترى، فئة الفنون والترفيه/الفكاهة في لقطة الشاشة ليست موضوع أحد هذه المواقع، لذا فإن هذا الموضوع المسجّل هو موضوع تمت إضافته كموضوعات عشوائية محتملة بنسبة 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 والمشاركة فيها. اقرأ دليل المطوِّر للحصول على المزيد من المراجع المفصّلة.

التفاعل مع الملاحظات ومشاركتها