نمای کلی API مخاطبین محافظت شده

مزایده‌های تبلیغاتی روی دستگاه برای ارائه خدمات بازاریابی مجدد و مخاطبان سفارشی، بدون ردیابی بین سایتی توسط اشخاص ثالث.

این سند برای کیست؟

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

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

API مخاطب محافظت‌شده چیست؟

رابط برنامه‌نویسی کاربردی مخاطبان محافظت‌شده (Protected Audience API) یک فناوری Privacy Sandbox است که برای ارائه خدمات بازاریابی مجدد و موارد استفاده مخاطبان سفارشی طراحی شده است، به طوری که اشخاص ثالث نتوانند رفتار مرور کاربر را در سایت‌های مختلف ردیابی کنند.

رابط برنامه‌نویسی کاربردی (API) مخاطبان محافظت‌شده، امکان مزایده‌های درون‌دستگاهی را توسط مرورگر فراهم می‌کند تا تبلیغات مرتبط را از وب‌سایت‌هایی که کاربر قبلاً بازدید کرده است، انتخاب کند.

API مخاطب محافظت‌شده اولین آزمایشی است که در Chromium در خانواده پیشنهادات TURTLEDOVE پیاده‌سازی می‌شود. تفاوت بین مخاطب محافظت‌شده و TURTLEDOVE در درجه اول مربوط به جداسازی نقش خریدار و فروشنده تبلیغات در دستگاه است. بخش‌های زیر نحوه عملکرد API مخاطب محافظت‌شده را توضیح می‌دهند.

API مخاطب محافظت‌شده در یک دقیقه

برای مرور عمیق‌تر API مخاطب محافظت‌شده، راهنمای توسعه‌دهنده API مخاطب محافظت‌شده را مطالعه کنید.

مروری بر هر مرحله از چرخه عمر API مخاطبان محافظت‌شده
چرخه حیات API مخاطبان محافظت‌شده.

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

برای مثال، وقتی کاربری از سایتی بازدید می‌کند که می‌خواهد محصولاتش را تبلیغ کند، مالک گروه علاقه‌مند (مانند یک پلتفرم سمت تقاضا (DSP) ) می‌تواند از مرورگر کاربر بخواهد که عضویت گروه علاقه‌مند را اضافه کند. اگر درخواست موفقیت‌آمیز باشد، مرورگر موارد زیر را ثبت می‌کند:

  • نام گروه مورد نظر: برای مثال، «موتورسیکلت‌های سفارشی».
  • مالک گروه مورد نظر: برای مثال، 'https://dsp.example'.
  • اطلاعات پیکربندی گروه ذینفع برای اینکه مرورگر بتواند به کد پیشنهاد قیمت، کد تبلیغ و داده‌های بلادرنگ دسترسی داشته باشد، در صورتی که از صاحب گروه برای پیشنهاد قیمت در یک حراج تبلیغ دعوت شود.

بعداً، وقتی کاربر از سایتی با فضای تبلیغاتی موجود بازدید می‌کند، فروشنده فضای تبلیغاتی ( ارائه‌دهنده سمت فروش (SSP) یا خود سایت) می‌تواند از Protected Audience برای اجرای یک حراج تبلیغاتی استفاده کند تا مناسب‌ترین تبلیغات را برای نمایش به کاربر انتخاب کند. فروشنده تابع navigator.runAdAuction() را فراخوانی می‌کند که لیستی از صاحبان گروه‌های ذینفع را که برای پیشنهاد قیمت دعوت شده‌اند، ارائه می‌دهد.

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

کد پیشنهاد قیمت از یک URL که در پیکربندی گروه ذینفع ارائه شده است، بازیابی می‌شود. این کد، داده‌هایی در مورد گروه ذینفع و اطلاعاتی از فروشنده، به همراه داده‌های زمینه‌ای در مورد صفحه و مرورگر، ارائه می‌دهد.

هر گروه ذینفع که پیشنهادی ارائه می‌دهد، به عنوان خریدار شناخته می‌شود.

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

آگهی برنده در یک قاب محصور نمایش داده می‌شود. آدرس اینترنتی آگهی تبلیغاتی در پیشنهاد قیمت مشخص شده است و مبدأ آن باید با یکی از موارد موجود در فهرست ارائه شده توسط پیکربندی گروه ذینفع مطابقت داشته باشد.

فروشنده می‌تواند نتیجه حراج را گزارش دهد ( reportResult() ) و خریداران می‌توانند بردهای خود را گزارش دهند ( reportWin() ).

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

چرا به API مخاطب محافظت‌شده نیاز داریم؟

درک علایق کاربر می‌تواند تبلیغات مرتبط‌تری را نسبت به انتخاب صرف تبلیغات بر اساس محتوای سایت (هدف‌گیری زمینه‌ای) یا با استفاده از اطلاعات ارائه شده توسط کاربر به سایتی که تبلیغ در آن نمایش داده می‌شود (هدف‌گیری داده‌های شخص ثالث) فراهم کند.

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

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

چگونه می‌توانم API مخاطب محافظت‌شده را امتحان کنم؟

  • راهنمای توسعه‌دهنده‌ی API مخاطبان محافظت‌شده، نحوه‌ی استفاده از API و نحوه‌ی آزمایش محلی را شرح می‌دهد.

  • protected-audience-demo.web.app یک راهنمای گام به گام از پیاده‌سازی اولیه‌ی Protected Audience در سایت‌های تبلیغ‌کننده و ناشر ارائه می‌دهد. ویدیوی نمایشی Protected Audience نحوه‌ی کار این کد را توضیح می‌دهد و پیش‌نمایشی از نحوه‌ی استفاده از Chrome DevTools برای اشکال‌زدایی ارائه می‌دهد.

چه پیکربندی مرورگری در دسترس است؟

کاربران می‌توانند با فعال یا غیرفعال کردن تنظیمات سطح بالا در chrome://settings/adPrivacy میزان مشارکت خود در آزمایش‌های Privacy Sandbox در کروم را تنظیم کنند. در طول آزمایش اولیه، کاربران می‌توانند با استفاده از تنظیمات Privacy Sandbox از API Protected Audience انصراف دهند.

کروم قصد دارد به کاربران اجازه دهد فهرست گروه‌های مورد علاقه‌ای که در سایت‌هایی که بازدید کرده‌اند به آنها اضافه شده‌اند را مشاهده و مدیریت کنند. همانند فناوری‌های Privacy Sandbox، تنظیمات کاربر ممکن است با بازخورد کاربران، تنظیم‌کننده‌ها و دیگران تغییر کند.

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

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

آیا می‌توانم از API مخاطب محافظت‌شده انصراف دهم؟

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

مفاهیم کلیدی

به دنبال اطلاعات بیشتری در مورد اصطلاحات مخاطب محافظت‌شده هستید؟ به واژه‌نامه Privacy Sandbox مراجعه کنید.

گروه ذینفع چیست؟

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

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

مالک از مرورگر کاربر می‌خواهد که با فراخوانی تابع جاوا اسکریپت navigator.joinAdInterestGroup() عضویت در گروه مورد علاقه خود را اضافه کند و اطلاعاتی مانند داده‌های مربوط به تبلیغات مرتبط با گروه مورد علاقه و یک URL برای جاوا اسکریپت مورد استفاده در پیشنهاد قیمت را ارائه دهد. داده‌های گروه مورد علاقه (مانند تبلیغات) می‌توانند به‌روزرسانی شوند و یک گروه مورد علاقه می‌تواند تا 30 روز فعال شود.

انواع گروه‌های ذینفع

جدول زیر نمونه‌هایی از انواع مختلف گروه‌های ذینفع و مالکان API مخاطب محافظت‌شده را ارائه می‌دهد.

مالک مثال علاقه مثال موارد استفاده
تبلیغ کننده دوچرخه ساز محصولات افرادی که صفحات محصول را برای یک دسته خاص از دوچرخه مشاهده کرده‌اند. بازاریابی مجدد برای افرادی که قبلاً با برند تعامل داشته‌اند.
ناشر وب‌سایت خبری محتوا افرادی که در مورد دوچرخه‌سواری مطالعه می‌کنند. ناشران می‌توانند از داده‌های شخص اول استفاده کنند تا تبلیغ‌کنندگان بتوانند تبلیغاتی را که برای خوانندگان سایتشان مرتبط است، خریداری کنند. یک گروه ذی‌نفع متعلق به ناشر می‌تواند به ناشران اجازه دهد حتی زمانی که آن افراد در حال مرور سایت‌های دیگر هستند، همین کار را انجام دهند. ناشران ممکن است بتوانند برای نمایش تبلیغات به بخش‌های خاصی از مخاطبان خود هزینه دریافت کنند.
فناوری تبلیغات پردازنده سیگنال دیجیتال (دی اس پی) دسته بندی محصولات افرادی که به تجهیزات دوچرخه‌سواری علاقه نشان دادند. یک شرکت فناوری تبلیغات ممکن است یک گروه علاقه‌مند از افرادی که به نظرشان در بازار برخی از دسته‌های کالا هستند، ایجاد و مدیریت کند. سپس می‌توان از این گروه علاقه‌مند برای تبلیغ محصولات در سایت‌هایی که کالاهایی در آن دسته می‌فروشند (و با شرکت فناوری تبلیغات همکاری می‌کنند) استفاده کرد.

کروم به ازای هر مالک تا ۱۰۰۰ گروه علاقه‌مندی و تا ۱۰۰۰ مالک گروه علاقه‌مندی را مجاز می‌داند. این محدودیت‌ها به عنوان محافظ در نظر گرفته شده‌اند و نباید در عملکرد عادی به آنها برخورد کرد.

خریدار چیست؟

در API مخاطبان محافظت‌شده، خریدار طرفی است که مالک یک گروه ذینفع است و در یک حراج تبلیغاتی پیشنهاد قیمت می‌دهد.

برای مثال:

  • تبلیغ‌کننده : برای خودش عمل می‌کند.
  • پلتفرم سمت تقاضا (DSP): برای تبلیغ‌کنندگان فعالیت می‌کند.
  • صاحب گروه‌های ذی‌نفع : کار کردن برای چندین تبلیغ‌کننده.

خریداران سه وظیفه دارند:

  • انتخاب کنید که آیا در یک حراج شرکت کنید یا خیر.
  • تبلیغات را انتخاب کنید و پیشنهاد قیمت را محاسبه کنید.
  • نتیجه مزایده را گزارش دهید.

این کارها به صورت برنامه‌نویسی‌شده و در کدی که توسط خریدار ارائه می‌شود و در طول حراج تبلیغاتی API مخاطبان محافظت‌شده اجرا می‌شود، انجام می‌شوند.

وقتی یک خریدار از مرورگر کاربر می‌خواهد که یک گروه مورد علاقه را به گروه‌هایی که عضو آن است اضافه کند (با فراخوانی تابع جاوا اسکریپت navigator.joinAdInterestGroup() )، خریدار موارد زیر را در اختیار مرورگر قرار می‌دهد:

  • یک URL برای کد پیشنهاد قیمت، که هنگام اجرای حراج آگهی توسط فروشنده استفاده خواهد شد.
  • به طور بالقوه، آدرس‌های اینترنتی برای آگهی‌های تبلیغاتی برای گروه مورد نظر. (ممکن است آدرس‌های اینترنتی آگهی بعداً با به‌روزرسانی اضافه شوند.)
  • فهرستی از کلیدهای داده‌ای که باید استعلام شوند، و نشانی اینترنتی سرویس کلید/مقدار خریدار، برای فعال کردن کد پیشنهاد قیمت جهت دریافت داده‌های بلادرنگ در طول حراج.

کد خریدار همچنین می‌تواند شامل یک تابع reportWin() برای گزارش نتیجه حراج باشد.

چه کسی حراج تبلیغات را برگزار می‌کند؟

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

برای مثال:

  • ناشر محتوا : برای خودش فعالیت می‌کند تا محتوای تبلیغاتی را در وب‌سایتش میزبانی کند.
  • پلتفرم سمت عرضه (SSP): همکاری با ناشر و ارائه سایر خدمات.
  • اسکریپت شخص ثالث : فعالیت برای یک ناشر، برای فعال کردن مشارکت در مزایده‌های تبلیغاتی.

با استفاده از API مخاطبان محافظت‌شده، یک فروشنده فضای تبلیغاتی سه وظیفه دارد:

  • اجرای قوانین ناشر: بیان اینکه کدام خریداران و کدام پیشنهادها واجد شرایط هستند.
  • منطق اجرای مزایده: جاوا اسکریپت در workletها اجرا می‌شود تا امتیاز مطلوبیت برای هر پیشنهاد محاسبه شود.
  • نتیجه مزایده را گزارش دهید.

این کارها به صورت برنامه‌نویسی شده و در کدی که فروشنده هنگام شروع حراج آگهی با فراخوانی تابع جاوا اسکریپت navigator.runAdAuction() ارائه می‌دهد، انجام می‌شوند.

مزایده تبلیغات API مخاطبان محافظت‌شده چگونه کار می‌کند؟

نمودار زیر هر مرحله از حراج تبلیغات API مخاطبان محافظت‌شده را شرح می‌دهد:

شش مرحله در حراج تبلیغات API مخاطبان محافظت‌شده
مراحل حراج تبلیغات مخاطبان محافظت‌شده.

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

یک فروشنده (ناشر یا یک پلتفرم طرف عرضه ) یک حراج تبلیغاتی «مخاطبان حفاظت‌شده» را در سایتی که فضای تبلیغاتی می‌فروشد (مانند یک سایت خبری) آغاز می‌کند. فروشنده خریداران را برای شرکت در حراج انتخاب می‌کند، مشخص می‌کند که چه فضایی برای فروش است و معیارهای اضافی برای تبلیغ ارائه می‌دهد. هر خریدار مالک یک گروه ذینفع است.

فروشنده کدی را برای امتیازدهی به پیشنهادات در اختیار مرورگر قرار می‌دهد که شامل ارزش هر پیشنهاد، URL مربوط به آگهی و سایر داده‌های دریافتی از هر خریدار است. در طول حراج، کد پیشنهاد از خریداران و کد امتیازدهی به پیشنهاد از فروشنده می‌توانند داده‌ها را از سرویس‌های Key/Value خود دریافت کنند. پس از انتخاب و نمایش یک آگهی (در یک قاب محصور برای حفظ حریم خصوصی)، فروشنده و خریدار برنده می‌توانند نتیجه حراج را گزارش دهند.

  1. کاربر از سایتی بازدید می‌کند که تبلیغات را نمایش می‌دهد.
  2. کد فروشنده یک حراج را آغاز می‌کند. فروشنده مشخص می‌کند که کدام فضای تبلیغاتی برای فروش است و چه کسی می‌تواند پیشنهاد قیمت بدهد، و همچنین روشی برای امتیازدهی به این پیشنهادها ارائه می‌دهد.
  3. کد خریدار دعوت‌شده اجرا می‌شود تا یک پیشنهاد قیمت، URL برای آگهی تبلیغاتی مرتبط و سایر داده‌ها ایجاد کند. اسکریپت پیشنهاد قیمت می‌تواند داده‌های بلادرنگ، مانند بودجه باقی‌مانده کمپین تبلیغاتی، را از سرویس Key/Value خریدار جستجو کند.
  4. کد فروشنده به هر پیشنهاد امتیاز می‌دهد و یک برنده انتخاب می‌کند. این منطق از مقدار پیشنهاد و سایر داده‌ها برای بازگرداندن مطلوبیت یک پیشنهاد و رد تبلیغی که نمی‌تواند برنده تبلیغ زمینه‌ای را شکست دهد، استفاده می‌کند. فروشنده می‌تواند از سرویس کلید/مقدار خود برای داده‌های بلادرنگ استفاده کند. قبل از شروع حراج، فروشنده بهترین تبلیغ زمینه‌ای را برای جایگاه تبلیغ موجود پیدا می‌کند.
  5. آگهی برنده زمانی که پرچم resolveToConfig در پیکربندی حراج تنظیم شده باشد، به عنوان یک شیء پیکربندی قاب حصارکشی شده بازگردانده می‌شود. این پیکربندی برای پیمایش قاب حصارکشی شده به آگهی تبلیغاتی استفاده می‌شود و URL آگهی تبلیغاتی از فروشنده و ناشر پنهان است. اگر پرچم resolveToConfig روی false تنظیم شود یا ارسال نشود، آگهی برنده به عنوان یک URN مات بازگردانده می‌شود که می‌تواند برای رندر کردن آگهی در یک iframe استفاده شود. شیء پیکربندی قاب حصارکشی شده از M114 در دسترس است.
  6. حراج به فروشنده و خریداران برنده گزارش می‌شود.

یک مکانیسم گزارش‌دهی برای خریداران از دست رفته در دست بررسی است.

سرویس کلید/مقدار API مخاطب محافظت‌شده چیست؟

سرویس کلید/مقدار API مخاطب محافظت‌شده (Protected Audience API Key/Value) به تکنسین‌های تبلیغات اجازه می‌دهد تا هنگام ارائه پیشنهاد توسط خریدار، داده‌های بلادرنگ را جستجو کنند و فروشندگان نیز بتوانند با حفظ حریم خصوصی، به تبلیغات امتیاز دهند. می‌توانید در مورد سرویس کلید/مقدار API مخاطب محافظت‌شده و سایر سرویس‌ها در خدمات API مخاطب محافظت‌شده (Protected Audience API services) مطالعه کنید.

سرویس Key/Value در زیرساخت ابری خودِ فناوری تبلیغات مستقر می‌شود و این سرویس در یک محیط اجرایی قابل اعتماد اجرا می‌شود. درخواست به یک سرویس Key/Value نمی‌تواند منجر به ثبت وقایع در سطح رویداد یا عوارض جانبی دیگر شود. سرویس Key/Value همچنین از توابع تعریف‌شده توسط کاربر (UDF) پشتیبانی می‌کند که به فناوری‌های تبلیغات اجازه می‌دهد منطق سفارشی خود را در سرویس Key/Value اجرا کنند.

خریدار یا فروشنده فهرستی از «کلیدها» را برای مشخص کردن داده‌های مورد نیاز خود از سرویس کلید/مقدار API مخاطب محافظت‌شده ارائه می‌دهد. سرویس کلید/مقدار با یک مقدار برای هر کلید پاسخ می‌دهد.

کد سرویس کلید/مقدار API مخاطب محافظت‌شده اکنون در مخزن گیت‌هاب Privacy Sandbox موجود است. این سرویس می‌تواند توسط توسعه‌دهندگان کروم و اندروید مورد استفاده قرار گیرد.

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

چگونه داده‌های بلادرنگ در مزایده‌ها گنجانده می‌شوند؟

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

برای برآورده کردن الزامات حریم خصوصی API مخاطب محافظت‌شده، داده‌های بلادرنگ مورد نیاز در طول یک حراج تبلیغاتی توسط سرویس Key/Value ارائه می‌شود. هنگامی که هر خریدار navigator.joinAdInterestGroup() را فراخوانی می‌کند، خریدار یک URL سرویس Key/Value را مشخص می‌کند و کلیدهایی را که باید در طول حراج از سرویس درخواست شوند، مشخص می‌کند. به همین ترتیب، هنگامی که فروشنده با فراخوانی navigator.runAdAuction() یک حراج تبلیغاتی را اجرا می‌کند، فروشنده یک URL برای سرویس Key/Value خود ارائه می‌دهد. سرویس Key/Value فروشنده با URL رندر خلاقیت درخواست خواهد شد.

برای آزمایش اولیه، از مدل «سرور خودتان را بیاورید» استفاده می‌شود. در درازمدت، تکنسین‌های تبلیغات باید از سرویس‌های کلید/مقدار API محافظت‌شده‌ی متن‌باز که در محیط‌های اجرایی قابل اعتماد اجرا می‌شوند، برای بازیابی داده‌های بلادرنگ استفاده کنند.

برای اطمینان از اینکه اکوسیستم زمان کافی برای آزمایش دارد، انتظار نداریم که تا مدتی پس از منسوخ شدن کوکی‌های شخص ثالث، استفاده از سرویس‌های متن‌باز Key/Value یا محیط‌های اجرایی قابل اعتماد را الزامی کنیم. ما قبل از وقوع این انتقال، اطلاعیه‌های مهمی را برای توسعه‌دهندگان جهت شروع آزمایش و پذیرش ارائه خواهیم داد.

چگونه از داده‌های شخص اول در حراج مخاطبان محافظت‌شده استفاده می‌شود؟

داده‌های شخص اول، داده‌هایی هستند که سایت در اختیار کاربران خود قرار می‌دهد. برای مثال، اگر کاربری رنگ مورد علاقه خود را در سایت تبلیغ‌کننده یا ناشر مشخص کرده باشد، آن رنگ به عنوان داده‌های شخص اول در نظر گرفته می‌شود.

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

برای مثال، اگر تبلیغ‌کننده رنگ مورد علاقه کاربر را بداند، می‌تواند هنگام اضافه شدن کاربر به یک گروه علاقه‌مندی، مقدار آن را در پیکربندی گروه علاقه‌مندی به عنوان userBiddingSignals تنظیم کند:

const interestGroup = {
  owner: 'https://example-buyer.com',
  name: 'running-shoes',
  userBiddingSignals: {
    favoriteColor: 'blue' // First-party data
  },
  // ...other interest group settings
};

navigator.joinAdInterestGroup(interestGroup, 3600);

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

مثال زیر نحوه‌ی ارسال داده‌های شخص اول توسط ناشر به شرکت‌کنندگان مختلف حراج را شرح می‌دهد:

const auctionConfig = {
  seller: 'https://example-seller.com',
  auctionSignals: {
    favoriteColor: 'blue', // Both buyer and seller will receive this signal
  },
  sellerSignals: {
    favoriteIceCreamFlavor: 'chocolate', // Only the seller will receive this signal
  },
  perBuyerSignals: {
    'https://example-buyer.com': {
      favoriteDrink: 'tea', // Only a specific buyer will receive this signal
    },
  },
  // The same pattern applies to the component auction
  componentAuctions: [{
    seller: 'https://example-component-seller.com',
    auctionSignals: { ... },
    sellerSignals: { ... },
    perBuyerSignals { ... }
  }],
  // ...other auction settings
};

navigator.runAdAuction(auctionConfig);

اطلاعات بیشتر

برای مرور عمیق‌تر API مخاطب محافظت‌شده، راهنمای توسعه‌دهنده API مخاطب محافظت‌شده را مطالعه کنید.

توسعه‌دهندگان

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

ما یک راهنمای توسعه‌دهنده API نوشته‌ایم و یک نسخه آزمایشی از API مخاطب محافظت‌شده ساخته‌ایم که یک راهنمای گام به گام از پیاده‌سازی اولیه API مخاطب محافظت‌شده ارائه می‌دهد. ویدیوی آزمایشی API مخاطب محافظت‌شده نحوه کار کد آزمایشی را توضیح می‌دهد و نحوه استفاده از Chrome DevTools را برای اشکال‌زدایی API مخاطب محافظت‌شده نشان می‌دهد.

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