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

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

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

گردش کار ادغام مخاطب محافظت شده شامل 4 مرحله کلیدی است که توسط انواع مختلف شرکای فناوری تبلیغات هدایت می شود:

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

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

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

واژه شناسی

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

پیش نیازها، مشارکت شریک ادغام، و راه اندازی

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

راهنمای عرضه برای ویژگی‌های مخاطب محافظت شده.

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

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

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

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

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

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

مشارکت شریک ادغامی

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

URL منطق مناقصه

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

سیگنال های پیشنهاد کاربر

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

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

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

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

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

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

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

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

لیست AdData

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• فروشنده می تواند اطلاعات را به روش های مختلفی وارد فرآیند کند:

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

خریداران: مناقصه برای یک جایگاه آگهی

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

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

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

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

طراحی منطق مناقصه

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

ارائه داده های مناقصه

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

فروشندگان: یک آگهی ارائه دهید

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

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

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

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

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

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

Privacy Sandbox همچنین یک API گزارش Attribution برای مدیریت سطح رویداد و گزارش‌های انبوه ارائه می‌کند. برای جزئیات بیشتر راهنمای ادغام را بخوانید.

{% کلمه به کلمه %} {% آخر کلمه %}