موضوعات API: ابزارهای تست و تجزیه و تحلیل

درباره ابزارهای موجود در کروم برای مشاهده اطلاعات API موضوعات و نحوه اختصاص موضوعات اطلاعات کسب کنید.

مشاهده اطلاعات API موضوعات

صفحه chrome://topics-internals در کروم دسکتاپ، پس از فعال کردن API موضوعات، در دسترس قرار می‌گیرد. این صفحه موضوعات مربوط به کاربر فعلی، موضوعات استنباط شده برای نام‌های میزبان و اطلاعات فنی در مورد پیاده‌سازی API را نمایش می‌دهد. ما در حال تکرار و بهبود طراحی صفحه بر اساس بازخورد توسعه‌دهندگان هستیم. شما می‌توانید با ارسال بازخورد خود به عنوان یک اشکال کرومیوم، API موضوعات را شکل دهید.

مشاهده موضوعات مشاهده شده برای مرورگر شما

کاربران می‌توانند با مراجعه به chrome://topics-internals اطلاعات مربوط به موضوعات مشاهده شده برای مرورگر خود را در دوره‌های فعلی و قبلی مشاهده کنند.

صفحه chrome://topics-internals با پنل Topics State انتخاب شده است.
پنل وضعیت موضوعات در صفحه chrome://topics-internals شناسه‌های موضوع، تخصیص‌های تصادفی و واقعی موضوع، و نسخه‌های طبقه‌بندی و مدل را نشان می‌دهد.

این تصویر نشان می‌دهد که سایت‌های اخیراً بازدید شده شامل topics-demo-cats.glitch.me و cats-cats-cats-cats.glitch.me هستند. این باعث می‌شود API موضوعات، Pets و Cats را به عنوان دو موضوع برتر برای دوره فعلی انتخاب کند. سه موضوع باقی مانده به صورت تصادفی انتخاب شده‌اند، زیرا سابقه مرور کافی (در سایت‌هایی که موضوعات را مشاهده می‌کنند) برای ارائه پنج موضوع وجود ندارد.

ستون «مشاهده‌شده توسط دامنه‌های زمینه» (هش‌شده) مقدار هش‌شده‌ی نام میزبانی را که موضوع برای آن مشاهده شده است، ارائه می‌دهد.

مشاهده موضوعات استنباط شده برای نام میزبان‌ها

همچنین می‌توانید موضوعات استنباط‌شده توسط مدل طبقه‌بندی‌کننده موضوعات را برای یک یا چند نام میزبان در chrome://topics-internals مشاهده کنید.

صفحه chrome://topics-internals با پنل Classifier انتخاب شده.
پنل طبقه‌بندی صفحه chrome://topics-internals موضوعات انتخاب شده، میزبان‌های بازدید شده و نسخه و مسیر مدل را نشان می‌دهد.

پیاده‌سازی فعلی API موضوعات، موضوعات را فقط از نام میزبان‌ها استنباط می‌کند؛ نه از هیچ بخش دیگری از URL.

برای مشاهده موضوعات استنباط‌شده از طبقه‌بندی‌کننده chrome://topics-internals ، فقط از نام میزبان (بدون پروتکل یا مسیر) استفاده کنید. اگر سعی کنید در فیلد میزبان علامت "/" را وارد کنید chrome://topics-internals خطایی نمایش می‌دهد.

مشاهده اطلاعات API موضوعات

می‌توانید اطلاعاتی در مورد پیاده‌سازی و تنظیمات API موضوعات، مانند نسخه طبقه‌بندی و مدت زمان دوره، در chrome://topics-internals پیدا کنید. این مقادیر، تنظیمات پیش‌فرض برای API یا پارامترهایی را که با موفقیت از خط فرمان تنظیم شده‌اند، نشان می‌دهند. این می‌تواند برای تأیید اینکه پرچم‌های خط فرمان مطابق انتظار کار کرده‌اند، مفید باشد.

، ، ،

در این مثال، time_period_per_epoch روی ۱۵ ثانیه تنظیم شده است (پیش‌فرض هفت روز است).

صفحه chrome://topics-internals با پنل ویژگی‌ها و پارامترها انتخاب شده است.
پنل ویژگی‌ها و پارامترها در chrome://topics-internals ویژگی‌های فعال‌شده، زمان هر دوره، تعداد دوره‌های مورد استفاده برای محاسبه موضوعات، نسخه طبقه‌بندی و سایر تنظیمات را نشان می‌دهد.

پارامترهای نشان داده شده در تصویر مربوط به پرچم‌هایی هستند که می‌توانند هنگام اجرای کروم از خط فرمان تنظیم شوند. برای کسب اطلاعات بیشتر در مورد نحوه کنترل API موضوعات با پرچم‌های کروم، به بخش تنظیمات اختصاصی مراجعه کنید.

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

کولاب

برای یادگیری نحوه بارگذاری مدل TensorFlow Lite که توسط کروم برای استنباط موضوعات از نام میزبان‌ها استفاده می‌شود، Colab را اجرا کنید. دستورالعمل‌ها را در توضیحات colab یا در ویدیوی آموزشی خواهید یافت. توجه داشته باشید که این colab از نسخه قدیمی طبقه‌بندی استفاده می‌کند.

از API موضوعات در وب‌سایت‌ها با prebid.js استفاده کنید

همانطور که در انتشار Prebid 7 اشاره شد، جامعه به طور فعال با استفاده از یک ماژول جدید، ادغام با API موضوعات را توسعه داد. این ماژول در دسامبر 2022 ادغام شد . مستندات ماژول API موضوعات Prebid را مطالعه کنید. برای اطلاعات بیشتر در مورد ادغام، از طریق هر کانال استانداردی که Prebid.js ارائه می‌دهد، با آنها تماس بگیرید.

مراحل بعدی

بیاموزید که چگونه کاربران و توسعه دهندگان می توانند API موضوعات را مدیریت و سفارشی کنند تا مطابق با اولویت ها و نیازهای کاربر باشد.
منابع ما را برای عیب یابی، پشتیبانی فنی، ثبت اشکالات و پرسیدن سوال بررسی کنید.

همچنین ببینید

برای درک بهتر Topics API در وب، منابع ما را بررسی کنید.