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

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

اطلاعات API موضوعات را مشاهده کنید

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

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

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

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

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

ستون Observed-by context domains (هش شده) مقدار هش شده نام میزبانی را که موضوعی برای آن مشاهده شده است، ارائه می دهد.

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

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

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

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

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

اطلاعات API موضوعات را مشاهده کنید

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

در مثال، 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

کولب

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

از Topics API در وب سایت هایی با prebid.js استفاده کنید

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

مراحل بعدی

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

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

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