نحوه استنباط موضوعات، نحوه تخصیص آنها به مرورگرهای کاربران و نحوه کنترل لیست موضوعات خود را بخوانید.
وضعیت پیاده سازی
- 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 برای استنباط موضوعات مورد علاقه برای یک کاربر، بر اساس فعالیت مرور وی، و در عین حال حفظ حریم خصوصی کاربر چیست؟
- چگونه می توان طبقه بندی را برای مفیدتر ساختن آن ساختار داد؟
- طبقه بندی باید شامل چه موارد خاصی باشد؟
چگونه 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
مشاهده شود.
موضوعاتی که برای یک کاربر بازگردانده می شوند، بسته به سایت سطح بالا، برای تماس گیرنده مجدداً محاسبه می شوند. به عنوان مثال، اگر adtech.example
موضوعات کاربر را در news-a.example
، سپس در news-b.example
و سپس در news-c.example
درخواست کند، موضوعاتی که به آنها برگردانده شده است در هر سایت مجدداً محاسبه می شوند. این بدان معناست که یک تماسگیرنده احتمالاً موضوعات مختلفی را برای یک کاربر در سایتهای سطح بالا دریافت میکند، زیرا (حداکثر) سه موضوعی که برای یک کاربر برگردانده میشود بهطور تصادفی از پنج موضوع برتر برای سه دوره گذشته (با شانس 5 درصد) انتخاب میشوند. گرفتن یک موضوع تصادفی). این امر شناسایی کاربر بر اساس موضوعات خود را برای تماس گیرنده دشوارتر می کند، زیرا احتمالاً این موارد در سایت های سطح بالا متفاوت است (حتی برای یک کاربر، تماس گیرنده و دوره).
مدل طبقه بندی کننده
موضوعات به صورت دستی برای 50000 دامنه برتر تنظیم می شوند و این مدیریت برای آموزش طبقه بندی کننده استفاده می شود. این فهرست را میتوانید در override_list.pb.gz
پیدا کنید، که در chrome://topics-internals/
در مدل فعلی در برگه Classifier موجود است. ارتباط دامنه به موضوع در لیست توسط API به جای خروجی خود مدل استفاده می شود.
برای اجرای مستقیم مدل، به راهنمای اجرای یک مدل 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 یک موضوع را برای هر دوره، حداکثر تا سه موضوع برمی گرداند. اگر سه مورد برگردانده شود، این شامل موضوعات مربوط به دوره فعلی و دو دوره قبلی است.
- در پایان هر دوره، مرورگر فهرستی از صفحاتی را جمع آوری می کند که معیارهای زیر را دارند:
- این صفحه در طول دوره مورد بازدید کاربر قرار گرفت.
- این صفحه شامل کدهایی است که
document.browsingTopics()
را فراخوانی می کند. - API فعال شد (مثلاً توسط کاربر یا از طریق سرصفحه پاسخ مسدود نشده است).
- مرورگر در دستگاه کاربر، از مدل طبقهبندیکننده ارائه شده توسط Topics API استفاده میکند تا نام میزبان هر صفحه را به فهرستی از موضوعات نگاشت کند.
- مرورگر فهرستی از موضوعات را جمع آوری می کند.
- مرورگر لیستی از پنج موضوع اصلی را ایجاد می کند:
- هر یک از 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 را کنترل کنند .
- منابع توضیح دهنده فنی و پشتیبانی را بررسی کنید. سوال بپرسید، مشارکت کنید و بازخورد خود را به اشتراک بگذارید.