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

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

این مقاله برای چه کسانی است؟

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

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

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

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

Protected Audience API مزایده‌های روی دستگاه توسط مرورگر را قادر می‌سازد تا تبلیغات مرتبط را از وب‌سایت‌هایی که کاربر قبلاً بازدید کرده است انتخاب کند.

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

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

برای یک نمای کلی بیشتر از Protected Audience API، راهنمای برنامه‌نویس Protected Audience API را بخوانید.

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

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

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

  • نام گروه مورد علاقه: به عنوان مثال، "دوچرخه های سفارشی".
  • مالک گروه مورد علاقه: برای مثال، «https://dsp.example».
  • اطلاعات پیکربندی گروه علاقه به مرورگر برای دسترسی به کد مناقصه، کد آگهی و داده‌های هم‌زمان، در صورتی که مالک گروه برای پیشنهاد در یک مزایده آگهی دعوت شود.

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

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

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

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

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

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

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

درباره گزارش های حراج مخاطب محافظت شده بیاموزید.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

مفاهیم کلیدی

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

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

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

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

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

انواع گروه های علاقه مند

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

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

Chrome به هر مالک حداکثر 1000 گروه علاقه و حداکثر 1000 مالک گروه علاقه را می دهد. این محدودیت‌ها به‌عنوان ریل‌های محافظ در نظر گرفته می‌شوند، که در عملیات معمولی مورد اصابت قرار نمی‌گیرند.

خریدار چیست؟

در Protected Audience API، خریدار طرفی است که صاحب یک گروه ذینفع است و در یک مزایده آگهی پیشنهاد می دهد.

به عنوان مثال:

خریداران سه شغل دارند:

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

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

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

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

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

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

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

به عنوان مثال:

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

با استفاده از Protected Audience API، یک فروشنده فضای تبلیغاتی سه شغل دارد:

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

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

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

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

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

در Protected Audience API، یک حراج تبلیغاتی مجموعه ای از برنامه های کوچک جاوا اسکریپت است که مرورگر برای انتخاب تبلیغ روی دستگاه کاربر اجرا می کند. برای حفظ حریم خصوصی، تمام کدهای حراج آگهی از فروشنده و خریداران در Worklet های جاوا اسکریپت مجزا اجرا می شوند که نمی توانند با دنیای خارج صحبت کنند.

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

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

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

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

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

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

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

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

کد سرویس کلید/مقدار API Protected Audience اکنون در مخزن Privacy Sandbox GitHub در دسترس است. این سرویس برای توسعه دهندگان کروم و اندروید قابل استفاده است.

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

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

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

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

برای تست اولیه، از مدل "Bring Your Own Server" استفاده می شود. در درازمدت، فناوری‌های تبلیغاتی باید از سرویس‌های کلید/ارزش مخاطب محافظت‌شده API منبع باز که در محیط‌های اجرایی مطمئن برای بازیابی داده‌های بلادرنگ اجرا می‌شوند، استفاده کنند.

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

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

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

در حراج مخاطب محافظت شده، تبلیغ‌کننده می‌تواند از داده‌های شخص اول خود برای تعیین عضویت در گروه مورد علاقه استفاده کند و همچنین می‌تواند داده‌ها را به عنوان 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);

بیشتر بدانید

برای یک نمای کلی بیشتر از Protected Audience API، راهنمای برنامه‌نویس Protected Audience API را بخوانید.

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

اگر آماده شروع کار با Protected Audience API هستید، آزمایش را بخوانید و شرکت کنید .

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

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