دموهای API موضوعات

آزمایش کنید و بیاموزید که چگونه موضوعات از نام میزبان با حداقل تنظیمات استنتاج می شوند.

وضعیت پیاده سازی

  • Topics API مرحله بحث عمومی را تکمیل کرده است و در حال حاضر برای 99 درصد از کاربران در دسترس است و تا 100 درصد مقیاس بندی شده است.
  • برای ارائه بازخورد خود در مورد موضوعات API، یک مشکل در توضیح موضوعات ایجاد کنید یا در بحث‌های گروه تجاری بهبود وب تبلیغات شرکت کنید. توضیح دهنده تعدادی سؤال باز دارد که هنوز نیاز به تعریف بیشتری دارد.
  • جدول زمانی Privacy Sandbox جدول زمانی پیاده سازی را برای Topics API و سایر پیشنهادات Privacy Sandbox ارائه می دهد.
  • Topics API: آخرین به‌روزرسانی‌ها جزئیات تغییرات و پیشرفت‌های Topics API و پیاده‌سازی‌ها را نشان می‌دهند.

نسخه ی نمایشی Topics API نگاهی به نحوه استنتاج موضوعات از نام میزبان ارائه می دهد. هنگام بازدید از یک سایت آزمایشی، که به تنظیمات بسیار کمی نیاز دارد، می‌توانید پیش‌نمایش موضوعاتی را مشاهده کنید.

نسخه ی نمایشی ما پیش نمایشی است که اکثر ویژگی های Topics API را نشان می دهد تا شما با نحوه پیاده سازی API آشنا شوید.

همچنین می توانید با اجرای Topics colab مدل طبقه بندی کننده Topics را امتحان کنید.

ویدئوی زیر نحوه عملکرد دمو را نشان می دهد.

با chrome://flags یا پرچم های ویژگی تست کنید

دو راه برای امتحان Topics API به عنوان یک کاربر وجود دارد. باید Chrome 101 یا بالاتر را اجرا کنید:

  • API را در صفحه chrome://flags/#privacy-sandbox-ads-apis فعال کنید:

    با استفاده از صفحه chrome://flags/#privacy-sandbox-ads-apis، Topics API را فعال کنید
    صفحه chrome://flags/#privacy-sandbox-ads-apis که در آن می توانید API را فعال یا غیرفعال کنید.

  • Chrome را از خط فرمان با پرچم های زیر اجرا کنید:

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

نسخه ی نمایشی Topics API

نسخه ی نمایشی Topics نحوه استفاده از پرچم های اضافی برای تنظیم تنظیمات، مانند طول دوره را نشان می دهد. اگر با اجرای Chrome با پرچم‌های خط فرمان به Topics API دسترسی پیدا می‌کنید، chrome://flags تنظیم نکنید، زیرا می‌توانند تنظیمات خط فرمان را لغو کنند.

اجرای Chromium با پرچم‌ها نحوه تنظیم پرچم‌ها هنگام اجرای Chrome و سایر مرورگرهای مبتنی بر Chromium را از خط فرمان توضیح می‌دهد، اگرچه این نسخه نمایشی مختص Google Chrome است.

نسخه ی نمایشی هدر Topics API

نسخه نمایشی در topics-fetch-demo.glitch.me نحوه استفاده از fetch() درخواست و سرصفحه پاسخ برای دسترسی به موضوعات و علامت گذاری آنها به عنوان مشاهده شده را نشان می دهد.

به سربرگ درخواست Sec-Browsing-Topics دسترسی پیدا کنید

به جای استفاده از document.browsingTopics() از iframe برای مشاهده موضوعات برای یک کاربر، فراخوان‌کنندگان API می‌توانند از سربرگ درخواست Sec-Browsing-Topics از یک درخواست fetch که شامل {browsingTopics: true} در پارامتر گزینه‌های آن است، به موضوعات مشاهده شده دسترسی داشته باشند. —یا از همان هدر یک درخواست XHR که صفت deprecatedBrowsingTopics را روی true تنظیم می کند.

مثلا:

fetch('https://topics-server.glitch.me', {browsingTopics: true})
    .then((response) => {
        // Process the response
 })

در مرورگرهایی که از API پشتیبانی می‌کنند، درخواست fetch() شامل سرصفحه Sec-Browsing-Topics می‌شود که موضوعات مشاهده‌شده برای نام میزبان URL درخواست را فهرست می‌کند: در این مثال، topics-server.glitch.me .

اگر هیچ موضوعی برای این نام میزبان و این کاربر مشاهده نشده باشد، هدر گنجانده شده است اما مقدار آن خالی است. به عبارت دیگر، هدر Sec-Browsing-Topics در یک درخواست fetch() فقط شامل موضوعاتی می شود که برای مرورگر کاربر فعلی توسط تماس گیرنده ای که منشاء آن با نام میزبان URL درخواست مطابقت دارد، مشاهده شده است. این همان چیزی است که اگر از یک iframe برای مشاهده موضوعات مشاهده شده برای کاربر فعلی document.browsingTopics() را فراخوانی کنید.

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

سربرگ درخواست Topics به شکل زیر است:

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 API از iframe طراحی شده است.

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

صفحه نمایشی موضوعات API در glitch.me
نسخه ی نمایشی glitch.me برای آزمایش API.

این لیست سایت هایی را نشان می دهد که می توانید از نسخه ی نمایشی برای ثبت موضوعات مورد علاقه از آنها بازدید کنید. همانطور که می بینید، دسته Arts & Entertainment/Humor در اسکرین شات موضوع یکی از این وب سایت ها نیست، بنابراین این موضوع ضبط شده یکی از موضوعاتی است که به عنوان موضوعات تصادفی احتمالی 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 آزمایش کنید و شرکت کنید . برای منابع عمیق تر ، راهنمای توسعه دهنده را بخوانید.

مشارکت کنید و بازخورد را به اشتراک بگذارید