طبقه بندی موضوع

نحوه استنباط موضوعات، نحوه تخصیص آنها به مرورگرهای کاربران و نحوه کنترل لیست موضوعات خود را بخوانید.

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

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

موضوع چیست؟

موضوع، در Topics API، موضوعی است که کاربر به آن علاقه مند است که توسط وب سایت هایی که بازدید می کند نشان می دهد.

موضوعات سیگنالی برای کمک به پلتفرم های فناوری تبلیغات در انتخاب تبلیغات مرتبط هستند. برخلاف کوکی‌های شخص ثالث، این اطلاعات بدون افشای اطلاعات بیشتر در مورد خود کاربر یا فعالیت مرور کاربر به اشتراک گذاشته می‌شود.

Topics API به اشخاص ثالث، مانند پلتفرم های فناوری تبلیغات، اجازه می دهد تا موضوعات مورد علاقه کاربر را مشاهده کرده و سپس به آن دسترسی داشته باشند. به عنوان مثال، API ممکن است موضوع "فیبر و هنرهای نساجی" را برای کاربری که از وب‌سایت knitting.example بازدید می‌کند، پیشنهاد کند.

فهرست موضوعاتی که توسط Topics API استفاده می‌شود، عمومی، تنظیم‌شده توسط انسان، قابل خواندن برای انسان است و برای اجتناب از دسته‌بندی‌های حساس طراحی شده است. این لیست فعلی است که به مرور زمان گسترش خواهد یافت. این فهرست به عنوان یک طبقه بندی ساختار یافته است. موضوعات می توانند سطح بالا یا خاص تر باشند. به عنوان مثال، Food & Drink یک دسته وسیع است، با زیر مجموعه ای از Cooking & Recipes . زیرمجموعه‌ها را می‌توان به دسته‌های فرعی دیگر تقسیم کرد.

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

طبقه بندی موضوعات با در نظر گرفتن دو الزام اساسی ساخته شده است:

• از تبلیغات مبتنی بر علاقه حمایت کنید
• کاربران را ایمن نگه دارید و از حریم خصوصی آنها محافظت کنید

این نشان دهنده چندین سوال است. به عنوان مثال:

• بهترین راه برای API برای استنباط موضوعات مورد علاقه برای یک کاربر، بر اساس فعالیت مرور وی، و در عین حال حفظ حریم خصوصی کاربر چیست؟
• چگونه می توان طبقه بندی را برای مفیدتر ساختن آن ساختار داد؟
• طبقه بندی باید شامل چه موارد خاصی باشد؟

Note: Before June 2023, Topics used an older version of the taxonomy. For more relevant ads, we recommend using the latest taxonomy version.

چگونه API موضوعات را برای یک سایت استنتاج می کند

موضوعات از یک مدل طبقه‌بندی کننده مشتق شده‌اند که نام میزبان وب‌سایت‌ها را به صفر یا بیشتر نشان می‌دهد. تجزیه و تحلیل اطلاعات اضافی (مانند URL های کامل یا محتویات صفحه) ممکن است به تبلیغات مرتبط تری اجازه دهد، اما ممکن است حریم خصوصی را نیز کاهش دهد.

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

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

علاوه بر این، تماس گیرنده فقط می تواند موضوعاتی را دریافت کند که کد آنها "دیده" شده است. بنابراین اگر کد تماس‌گیرنده دیگری موضوعی را ثبت کرده باشد، مثلاً /Autos & Vehicles/Motor Vehicles (By Type)/Hatchbacks ، برای مرورگر کاربر و کد شما باعث نشده که آن موضوع برای مرورگر آن کاربر ثبت شود، نمی‌توانید وقتی از کد تعبیه شده خود با API تماس می گیرید، از موضوع مورد علاقه مرورگر آن کاربر مطلع شوید. توجه داشته باشید که از آنجایی که API اکنون شامل اجدادی است که مشاهده شده است، مثال بالا، /Autos & Vehicles/Motor Vehicles (By Type)/Hatchbacks نیز باعث می شود که Autos & Vehicles و Motor Vehicles مشاهده شود.

عبارت کلیدی: Topics API caller نهادی است که موضوعات را با document.browsingTopics() مشاهده و درخواست می کند. به طور معمول، این تماس گیرنده یک شخص ثالث (مانند فناوری تبلیغات) است که از موضوعاتی که با این روش بازگردانده شده است برای کمک به انتخاب تبلیغات مرتبط استفاده می کند. مرورگر تماس گیرنده را از مبدا درخواست تعیین می کند. اگر سایت A موضوعاتی را از کد خود در یک iframe میزبانی شده در سایت B درخواست کند، مرورگر تشخیص می‌دهد که تماس‌گیرنده سایت A است. اگر شخص ثالثی هستید، مطمئن شوید که Topics API را از iframe متعلق به خود تماس می‌گیرید. برای بازیابی یک یا چند موضوع با document.browsingTopics() ، یک فراخوان API باید موضوعاتی را از همان مبدا مشاهده و درخواست کند. تماس گیرنده می تواند از طریق JavaScript API از داخل iframe با استفاده از document.browsingTopics() به موضوعات دسترسی پیدا کند. تماس گیرنده همچنین می تواند از سربرگ Sec-Browsing-Topics یک درخواست fetch() یا یک درخواست iframe به موضوعات دسترسی پیدا کند. درخواست‌های XHR در طول آزمایش‌های اصلی که اکنون کامل شده‌اند (فقط) فعال شدند.

موضوعاتی که برای یک کاربر بازگردانده می شوند، بسته به سایت سطح بالا، برای تماس گیرنده مجدداً محاسبه می شوند. به عنوان مثال، اگر adtech.example موضوعات کاربر را در news-a.example ، سپس در news-b.example و سپس در news-c.example درخواست کند، موضوعاتی که به آنها برگردانده شده است در هر سایت مجدداً محاسبه می شوند. این بدان معناست که یک تماس‌گیرنده احتمالاً موضوعات مختلفی را برای یک کاربر در سایت‌های سطح بالا دریافت می‌کند، زیرا (حداکثر) سه موضوعی که برای یک کاربر برگردانده می‌شود به‌طور تصادفی از پنج موضوع برتر برای سه دوره گذشته (با شانس 5 درصد) انتخاب می‌شوند. گرفتن یک موضوع تصادفی). این امر شناسایی کاربر بر اساس موضوعات خود را برای تماس گیرنده دشوارتر می کند، زیرا احتمالاً این موارد در سایت های سطح بالا متفاوت است (حتی برای یک کاربر، تماس گیرنده و دوره).

مدل طبقه بندی کننده

موضوعات به صورت دستی برای 50000 دامنه برتر تنظیم می شوند و این مدیریت برای آموزش طبقه بندی کننده استفاده می شود. این فهرست را می‌توانید در override_list.pb.gz پیدا کنید، که در chrome://topics-internals/ در مدل فعلی در برگه Classifier موجود است. ارتباط دامنه به موضوع در لیست توسط API به جای خروجی خود مدل استفاده می شود.

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

برای اجرای مستقیم مدل، به راهنمای اجرای یک مدل TensorFlow مراجعه کنید.

برای بررسی فایل override_list.pb.gz ، ابتدا آن را باز کنید:

gunzip -c override_list.pb.gz > override_list.pb

protoc برای بررسی آن به عنوان متن استفاده کنید:

protoc --decode_raw < override_list.pb > output.txt

طبقه بندی کاملی از موضوعات با شناسه در GitHub در دسترس است.

ارائه بازخورد یا ورودی در مورد مدل طبقه بندی کننده

کانال های مختلفی برای ارائه بازخورد در مورد Topics API وجود دارد. برای بازخورد در مورد مدل طبقه‌بندی‌کننده، توصیه می‌کنیم یک مشکل GitHub ارسال کنید یا به یک مشکل موجود پاسخ دهید. به عنوان مثال:

• طبقه بندی چه موضوعاتی باید در دراز مدت مورد استفاده قرار گیرد؟
• اگر سایتی با موضوعات اختصاص داده شده مخالف باشد چه؟

نحوه انتخاب پنج موضوع برتر کاربر

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

1. در پایان هر دوره، مرورگر فهرستی از صفحاتی را جمع آوری می کند که معیارهای زیر را دارند:
   • این صفحه در طول دوره مورد بازدید کاربر قرار گرفت.
   • این صفحه شامل کدهایی است که document.browsingTopics() را فراخوانی می کند.
   • API فعال شد (مثلاً توسط کاربر یا از طریق سرصفحه پاسخ مسدود نشده است).
2. مرورگر در دستگاه کاربر، از مدل طبقه‌بندی‌کننده ارائه شده توسط Topics API استفاده می‌کند تا نام میزبان هر صفحه را به فهرستی از موضوعات نگاشت کند.
3. مرورگر فهرستی از موضوعات را جمع آوری می کند.
4. مرورگر لیستی از پنج موضوع اصلی را ایجاد می کند:
   • هر یک از 22 موضوع ریشه در طبقه بندی بر اساس بازخورد اکوسیستم تبلیغاتی به یک سطل "مطلوب بالا" یا "مطلوب استاندارد" اختصاص داده شده است. مرورگر ابتدا موضوعات را بر اساس تخصیص سطل آنها مرتب می کند. همه موضوعات نسل اول، انتساب سطل موضوع ریشه والد خود را به ارث می برند. موضوعات "کاربرد بالا" در اولویت قرار دارند. موضوعات "کاربرد بالا" در اولویت قرار دارند.
   • سپس مرورگر موضوعات را بر اساس فرکانس در هر سطل مرتب می کند.
   • پنج موضوع برتر از این فهرست مرتب شده به عنوان موضوعات برتر کاربر برای آن دوره انتخاب می شوند.

متد document.browsingTopics() سپس یک موضوع تصادفی را از پنج تای اول برای هر دوره برمی گرداند، با احتمال 5% که هر یک از اینها ممکن است به طور تصادفی از طبقه بندی کامل موضوعات انتخاب شوند. در کروم، کاربران همچنین می‌توانند موضوعات جداگانه را حذف کنند یا تاریخچه مرور خود را پاک کنند تا تعداد موضوعات برگردانده شده توسط API کاهش یابد. کاربران همچنین ممکن است از API انصراف دهند .

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

چگونه API تصمیم می گیرد که تماس گیرندگان کدام موضوعات را ببینند

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

جدول زیر نمونه‌ای (هر چند غیر واقعی) از یک تاریخچه مرور فرضی برای یک کاربر در طول یک دوره را نشان می‌دهد که موضوعات مرتبط با سایت‌هایی را که بازدید کرده‌اند و تماس‌گیرندگان API موجود در هر سایت (موجودی که document.browsingTopics() در کد جاوا اسکریپت موجود در سایت).

سایت	موضوعات	تماس گیرندگان API در سایت
yoga.example	تناسب اندام	adtech1.example adtech2.example
بافندگی.مثال	صنایع دستی	adtech1.example
hiking-holiday.example	تناسب اندام، سفر و حمل و نقل	adtech2.example
diy-clothing.example	صنایع دستی، مد و سبک	[هیچ]

در پایان دوره (در حال حاضر یک هفته) Topics API موضوعات برتر مرورگر را برای هفته ایجاد می کند.

• adtech1.example اکنون واجد شرایط دریافت موضوعات "Fitness" و "Crafts" است، زیرا آنها را در yoga.example و همچنین در knitting.example مشاهده کرده است.
• adtech1.example واجد شرایط دریافت مبحث "سفر و حمل و نقل" برای این کاربر نیست زیرا در هیچ سایتی که کاربر اخیراً از آن بازدید کرده و مرتبط با آن موضوع است وجود ندارد.
• adtech2.example موضوعات "تناسب اندام" و "سفر و حمل و نقل" را دیده است، اما موضوع "صنایع دستی" را ندیده است.

کاربر از diy-clothing.example که دارای موضوع "مد و سبک" است، بازدید کرد، اما هیچ تماسی با Topics API در آن سایت وجود نداشت. در این مرحله، این بدان معناست که موضوع "مد و سبک" توسط API برای هیچ تماس گیرنده ای بازگردانده نمی شود.

در هفته دوم، کاربر از سایت دیگری بازدید می کند:

سایت	موضوعات	تماس گیرندگان API در سایت
خیاطی.مثال	صنایع دستی	adtech2.example

علاوه بر این، کد adtech2.example به diy-clothing.example اضافه می شود:

سایت	موضوعات	تماس گیرندگان API در سایت
diy-clothing.example	صنایع دستی، مد و سبک	adtech2.example

علاوه بر "تناسب اندام" و "سفر و حمل و نقل" از هفته 1، به این معنی است که adtech2.example اکنون می تواند مبحث "صنایع دستی" و "مد و سبک" را دریافت کند - اما تا دوره بعدی، هفته 3. این تضمین می‌کند که اشخاص ثالث نمی‌توانند در مورد گذشته کاربر (در این مورد، علاقه به مد) بیشتر از آنچه با کوکی‌ها می‌توانند بیاموزند.

پس از دو هفته دیگر، اگر کاربر از سایت‌هایی با موضوعاتی که شامل کد adtech2.example است بازدید نکند، ممکن است «تناسب اندام» و «سفر و حمل‌ونقل» از فهرست موضوعات واجد شرایط adtech2.example خارج شوند.

کنترل های کاربر، شفافیت، و انصراف

کاربران باید بتوانند:

• هدف Topics API را درک کنید.
• تشخیص اینکه چه موضوعاتی با فعالیت مرور آنها مرتبط است.
• بدانید چه زمانی API در حال استفاده است.
• کنترل هایی برای فعال یا غیرفعال کردن API داشته باشید.
• کنترل کنید که کدام موضوعات با تماس‌گیرندگان API به اشتراک گذاشته شود.

طبقه بندی قابل خواندن توسط انسان به کاربران اجازه می دهد تا موضوعاتی را که ممکن است توسط مرورگرشان برای آنها پیشنهاد می شود، بیاموزند و کنترل کنند. Chrome اطلاعات و تنظیماتی را برای Topics API در chrome://settings/adPrivacy/interests ارائه می‌کند.

کاربر می‌تواند دسته‌های موضوعی را که نمی‌خواهد با تماس‌گیرندگان API به اشتراک گذاشته شود، تبلیغ کند:

• با مسدود کردن موضوعی که قبلاً توسط مرورگر به آنها اختصاص داده شده است.
• با مسدود کردن فعال دسته وسیعی از موضوعات که به آنها علاقه ای ندارند در chrome://settings/adPrivacy/interests/manage . در این حالت، کاربر لازم نیست قبل از مسدود کردن موضوع، منتظر تعیین آن باشد.

در این مثال، کاربر تصمیم گرفت تا موضوعات "زیبایی و تناسب اندام" و "غذا و نوشیدنی" را مسدود کند. این موضوعات مورد علاقه با ناشران به اشتراک گذاشته نخواهد شد.

موضوعات برای تماس‌گیرندگان API در حالت ناشناس در دسترس نیستند و با پاک شدن سابقه مرور، موضوعات پاک می‌شوند.

لیست موضوعات بازگردانده شده خالی خواهد بود اگر:

• کاربر از گزینه Topics API در تنظیمات مرورگر در chrome://settings/adPrivacy/interests انصراف می دهد.
• کاربر موضوعات خود را (با استفاده از تنظیمات مرورگر در chrome://settings/adPrivacy/interests ) پاک کرده است یا کوکی های خود را پاک کرده است.
• مرورگر در حالت ناشناس است.
• کاربر تمام موضوعات ممکن را مسدود می کند.

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

سایت انصراف داد

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

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

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

اینجا بیشتر بیاموزید:

• مستندات ماژول Prebid's Topics API را بخوانید.
• برای اطلاعات بیشتر، از طریق هر کانال استانداردی که ارائه می‌دهند با Prebid.js تماس بگیرید.

مراحل بعدی

• برای منابع عمیق تر ، راهنمای توسعه دهنده را بخوانید.
• برای جزئیات بیشتر در مورد موارد خاص استفاده از فناوری تبلیغات ، راهنمای ادغام Topics API را بررسی کنید.

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

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

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