مخاطب محافظت شده: راهنمای ادغام

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

برای آماده‌سازی جهت استقرار در مقیاس تولید انبوه Protected Audience، شرکا ممکن است با شبیه‌سازی نقاط ادغام با سایر طرفین، آزمایش را آغاز کنند. برای کمک به شما در برنامه‌ریزی ادغام، این راهنما دیدگاه جامعی از نحوه ادغام Protected Audience با برنامه‌های اندروید شما ارائه می‌دهد. این ممکن است شامل ویژگی‌هایی باشد که هنوز در مرحله فعلی Privacy Sandbox در پیش‌نمایش توسعه‌دهندگان اندروید پیاده‌سازی نشده‌اند. در این موارد، راهنمای جدول زمانی ارائه شده است.

گردش کار یکپارچه‌سازی مخاطب محافظت‌شده شامل ۴ مرحله کلیدی است که توسط انواع مختلف شرکای فناوری تبلیغات هدایت می‌شود:

1. خریدار مخاطبان سفارشی ایجاد می‌کند.
2. فرآیند انتخاب تبلیغ، تبلیغ برنده را انتخاب می‌کند.
   1. اپلیکیشن فروشنده، انتخاب تبلیغ را آغاز می‌کند.
   2. سرویس‌های تبلیغاتی، کد فیلترینگ و پیشنهاد قیمت سمت خرید را اجرا می‌کنند.
   3. سرویس‌های تبلیغاتی، کد تصمیم‌گیری سمت فروش را اجرا می‌کنند.
3. آگهی برنده در اپلیکیشن فروشنده نمایش داده می‌شود.
4. گزارش‌های مربوط به نمایش آگهی هم برای خریدار و هم برای فروشنده در دسترس قرار می‌گیرد.

نمودار زیر این مراحل را نشان می‌دهد:

اصطلاحات

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

پیش‌نیازها، مشارکت شریک یکپارچه‌سازی و راه‌اندازی

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

آشنایی با مخاطبان محافظت‌شده

اولین قدم این است که با APIها و سرویس‌های Protected Audience آشنا شوید.

1. با خواندن طرح پیشنهادی شروع کنید تا با API مخاطب محافظت‌شده و قابلیت‌های آن آشنا شوید.
2. برای یادگیری نحوه‌ی گنجاندن کد و فراخوانی‌های API مورد نیاز برای موارد استفاده‌ی خود و سرویس‌های مورد نیاز برای ادغام با Protected Audience، راهنمای توسعه‌دهنده را مطالعه کنید.
3. بازخورد خود را در مورد طراحی و پیاده‌سازی APIها، خدمات و مستندات مخاطبان محافظت‌شده ارسال کنید .
4. برای دریافت به‌روزرسانی‌ها و اطلاع از آخرین ویژگی‌های Privacy Sandbox ثبت‌نام کنید .

راه‌اندازی و آزمایش برنامه‌های نمونه

وقتی با اصول اولیه مخاطب محافظت‌شده همانطور که قبلاً توضیح داده شد آشنا شدید، باید برنامه‌های نمونه را تنظیم و آزمایش کنید.

1. وقتی آماده شروع ادغام خود شدید، محیط توسعه خود را با آخرین پیش‌نمایش توسعه‌دهنده Privacy Sandbox راه‌اندازی کنید.
2. نقاط پایانی سرور مورد نیاز را تنظیم کنید. از نمونه‌های آزمایشی (mocks) با راهکار تست API مورد نظر خود برای راه‌اندازی خودکار این فرآیند استفاده کنید.
3. کد را در برنامه نمونه ما اجرا کنید تا با مدیریت مخاطبان سفارشی، گردش کار انتخاب تبلیغ و گزارش نمایش آشنا شوید.

مشارکت شرکای یکپارچه‌سازی

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

راه‌اندازی بتا (موجود در سه‌ماهه چهارم)

سازمان خود را در Privacy Sandbox در اندروید ثبت کنید . ثبت نام برای اطمینان از اینکه توسعه‌دهندگان فناوری تبلیغات در چارچوب سیاست‌های Privacy Sandbox عمل می‌کنند، الزامی است و به توسعه‌دهندگان فناوری تبلیغات اجازه می‌دهد تا هویت خود را در چندین SDK و دامنه تعریف کنند.

ملاحظات معماری

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

مخاطبان و تبلیغات بازاریابی مجدد در دستگاه ذخیره می‌شوند

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

فرآیندهای مناقصه و مزایده روی دستگاه انجام می‌شود

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

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

استراتژی داده

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

راه حل خود را بسازید

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

خریداران: ایجاد مخاطب

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

اگر SDK مخصوص به خودتان را در برنامه‌ی تبلیغ‌کنندگان دارید، می‌توانید این کد را مستقیماً با استفاده از joinCustomAudience() پیاده‌سازی کنید.

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

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

نمونه اولیه کمپین بازاریابی مجدد: طراحی مخاطب سفارشی

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

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

راه‌اندازی و نمونه اولیه

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

ملاحظات طراحی

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

آدرس اینترنتی منطق پیشنهاد قیمت

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

سیگنال‌های پیشنهاد قیمت کاربر

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

• سایر مخاطبانی که کاربر به آنها اضافه شده است.
• بینش‌های شخص ثالث که تبلیغ‌کننده در مورد کاربر دارد.

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

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

داده‌های مناقصه قابل اعتماد

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

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

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

لیست AdData

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

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

• لیست AdData را می‌توان به دو روش به‌روزرسانی کرد:
  • وقتی برنامه یک فعالیت قابل مشاهده در پیش‌زمینه دارد، می‌تواند با پیوستن یک کاربر به مخاطبان سفارشی، فهرست را آغاز کند.
  • در طول به‌روزرسانی روزانه، واکشی در پس‌زمینه آغاز می‌شود. دستگاه درخواستی را به daily_update_url که در فراخوانی joinCustomAudience گنجانده شده است ارسال می‌کند و انتظار پاسخی شامل لیست به‌روز شده AdData دارد.
• اطلاعات تکمیلی در مورد تبلیغات را می‌توان در زمان حراج درخواست کرد. قبل از حراج، دستگاه درخواستی را به سرویس کلید-مقدار خریداران ارسال می‌کند که در فیلد trustedBiddingData از joinCustomAudience ارائه شده است. سرویس کلید-مقدار، سرویس جدیدی است که بخشی از پیاده‌سازی Protected Audience توسط خریداران است. جزئیات بیشتر در مورد این سرویس بعداً در این سند توضیح داده خواهد شد.
• گنجاندن یک شناسه خلاق برای تبلیغ شما می‌تواند به شما کمک کند تا اقدامات خاصی را روی تبلیغات خاص انجام دهید. به عنوان مثال، تبلیغ‌کنندگان ممکن است تبلیغات خاصی را متوقف کنند و شما می‌خواهید آن شناسه‌های خلاق را از سرویس کلید-مقدار بلادرنگ استخراج کرده و سپس با تبلیغات موجود در لیست AdData مطابقت دهید.

AdData باید شامل یک render_url باشد. URL رندر تبلیغ ریمارکتینگ برنده برای رندر تبلیغ استفاده می‌شود. برخی از ملاحظات عبارتند از:

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

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

زمان فعال‌سازی و زمان انقضا

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

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

خریداران و فروشندگان: انتخاب آگهی

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

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

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

فروشندگان: استراتژی میانجیگری را تعریف کنید

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

فروشندگان: حراج را پیکربندی کنید

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

راه‌اندازی و نمونه اولیه

• یک فروشنده می‌تواند با تنظیم یک شیء AdSelectionConfig و استفاده از AdSelection API، یک حراج را پیکربندی و آغاز کند. حراج را با فراخوانی selectAds() آغاز کنید.
• برای جزئیات پیاده‌سازی و استفاده از API به راهنمای توسعه‌دهنده مراجعه کنید.

ملاحظات طراحی

این بخش شامل ملاحظات طراحی برای پر کردن و استفاده از فیلدهای کلیدی در پیکربندی انتخاب تبلیغ است.

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

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

• از آنجایی که بسیاری از خریداران می‌توانستند مخاطبان سفارشی را در دستگاه ایجاد کنند، فروشندگان باید از فیلد «مخاطبان سفارشی خریداران» برای مشخص کردن خریداران خاص برای گنجاندن در این فرآیند استفاده کنند. روش‌های زیادی برای ساخت این لیست وجود دارد. برخی از نمونه‌ها عبارتند از:

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

• فروشنده می‌تواند اطلاعات را از چند طریق به فرآیند منتقل کند:

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

خریداران: پیشنهاد قیمت برای یک جایگاه تبلیغاتی

راه‌اندازی و نمونه اولیه

• یک خریدار می‌تواند منطق پیشنهاد قیمت خود را به تابع جاوا اسکریپت generateBid() که از مجموعه پارامتر biddingLogicUrl هنگام ساخت یک CustomAudience ارائه می‌شود، اضافه کند. می‌توانید با استفاده از مشخصات ارائه شده ، یک سرویس آزمایشی راه‌اندازی کنید یا این نقطه پایانی را روی یک سرور واقعی پیاده‌سازی کنید.
• برای جزئیات پیاده‌سازی و استفاده از API به راهنمای توسعه‌دهنده مراجعه کنید.

ملاحظات طراحی

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

طراحی منطق پیشنهاد قیمت

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

داده‌های مناقصه تأمین

سیگنال‌های پیشنهاد قیمت آنی با سرویس‌های کلید-مقدار

به عنوان یک خریدار، می‌توانید سیگنال‌های لحظه‌ای را در طول یک حراج از یک سرویس کلید-مقدار که متعلق به شماست، دریافت کنید. می‌توانید پیاده‌سازی اولیه این سرویس را در مخزن عمومی Privacy Sandbox پیدا کنید، یا می‌توانید سرویس خودتان را ایجاد کنید. URL این سرویس به عنوان trustedBiddingUrl در یک مخاطب سفارشی مشخص شده است و پلتفرم تلاش می‌کند داده‌ها را دریافت کرده و با trusted_bidding_signals parameter آن را در دسترس تابع generateBid شما قرار دهد. شما باید ساختار کلید خودتان را ایجاد کنید.

سیگنال‌های زمینه‌ای و کاربری

تابع generateBid شما هنگام اجرای حراج روی دستگاه، به سیگنال‌های کاربر اضافی دسترسی دارد. این سیگنال‌ها با فیلدهای contextual_signals و per_buyer_signals ارسال می‌شوند. این فیلدها همگی اشیاء JSON هستند که قالب آنها باید توسط خریداران و فروشندگان تعریف شود.

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

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

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

فروشندگان: امتیاز دهید و تبلیغ برنده را انتخاب کنید

راه‌اندازی و نمونه اولیه

• یک فروشنده می‌تواند منطق امتیازدهی خود را به تابع جاوا اسکریپت scoreAd() که از مجموعه پارامتر scoringLogicUrl هنگام ساخت AdSelectionConfig ارائه می‌شود، اضافه کند. می‌توانید با استفاده از مشخصات ارائه شده ، یک سرویس آزمایشی راه‌اندازی کنید یا این نقطه پایانی را روی یک سرور واقعی پیاده‌سازی کنید.
• برای جزئیات پیاده‌سازی و استفاده از API به راهنمای توسعه‌دهنده مراجعه کنید.

منطق امتیازدهی طراحی

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

ارائه داده‌های امتیازدهی

سیگنال‌های امتیازدهی بلادرنگ با سرویس‌های کلید-مقدار

به عنوان یک فروشنده، می‌توانید سیگنال‌های بلادرنگ را در طول یک حراج از یک سرویس key-value که متعلق به شماست، دریافت کنید. می‌توانید پیاده‌سازی اولیه این سرویس را در مخزن عمومی Privacy Sandbox پیدا کنید. URL این سرویس به عنوان trustedScoringUri در پیکربندی حراج مشخص شده است و پلتفرم تلاش می‌کند تا داده‌ها را دریافت کرده و با استفاده از پارامتر trusted_scoring_signals آن را در دسترس تابع scoreAd شما قرار دهد. شما باید ساختار کلید خود را ایجاد کنید.

سیگنال‌های زمینه‌ای و کاربری

تابع scoreAd شما هنگام اجرای حراج روی دستگاه، به سیگنال‌های کاربر اضافی دسترسی دارد. این سیگنال‌ها با استفاده از فیلد contextual_signal به تابع امتیازدهی شما منتقل می‌شوند. این فیلد حاوی اشیاء JSON است که قالب آنها توسط خریداران و فروشندگان تعریف می‌شود.

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

فروشندگان: ارائه یک تبلیغ

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

گزارش نتایج نمایش

راه‌اندازی و نمونه اولیه

• خریداران و فروشندگان می‌توانند منطق گزارش‌دهی را به تابع جاوااسکریپت reportWin() که به ترتیب از پارامتر biddingLogicUrl یا scoringLogicUrl ارائه می‌شود، اضافه کنند. می‌توانید با استفاده از مشخصات ارائه شده ، یک سرویس آزمایشی راه‌اندازی کنید یا این نقطه پایانی را روی یک سرور واقعی پیاده‌سازی کنید.
• برای جزئیات پیاده‌سازی و استفاده از API به راهنمای توسعه‌دهنده مراجعه کنید.

ملاحظات طراحی

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

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