داده های مخاطب را تعریف کنید

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

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

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

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

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

توابع API

joinAdInterestGroup()

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

مبدا متن فراخوانی برای joinAdInterestGroup() باید با مبدأ مالک گروه علاقه مطابقت داشته باشد، بنابراین joinAdInterestGroup() باید از یک iframe (مثلاً از یک DSP) فراخوانی شود، مگر اینکه مبدأ مالک گروه علاقه با مبدا مطابقت داشته باشد. سند فعلی (به عنوان مثال، یک وب سایت با گروه های ذینفع خود).

joinAdInterestGroup() به مجوز نیاز دارد:

• سایت در حال بازدید
• مالک گروه ذینفع

این بدان معناست که malicious.example نمی‌تواند joinAdInterestGroup() را برای یک گروه ذینفع متعلق به dsp.example.com فراخوانی کند، بدون اینکه dsp.example.com اجازه دهد.

مجوز از سایت بازدید شده

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

مثال استفاده

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

const interestGroup = {
  owner: 'https://dsp.example',
  name: 'custom-bikes',
  biddingLogicUrl: ...,
  biddingWasmHelperUrl: ...,
  updateUrl: ...,
  trustedBiddingSignalsUrl: ...,
  trustedBiddingSignalsKeys: ['key1', 'key2'],
  userBiddingSignals: {...},
  ads: [bikeAd1, bikeAd2, bikeAd3],
  adComponents: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2],
};

navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);

شیء interestGroup ارسال شده به تابع نباید بیش از 50 کیلوبایت اندازه داشته باشد، در غیر این صورت فراخوانی ناموفق خواهد بود. پارامتر دوم مدت زمان گروه ذینفع را مشخص می کند که حداکثر 30 روز است. تماس های پی در پی مقادیر ذخیره شده قبلی را بازنویسی می کنند.

نکته کلیدی: همه نشانی‌های اینترنتی که به عنوان پارامتر برای روش‌های API مخاطب محافظت شده استفاده می‌شوند باید از منابع امن باشند: همه منابع باید از طریق URL‌های HTTPS ارائه شوند. نحوه استفاده از HTTPS برای توسعه محلی نحوه انجام این کار را هنگام اجرای Protected Audience API به صورت محلی توضیح می دهد. علاوه بر این، biddingLogicUrl ، decisionLogicUrl ، و trustedBiddingSignals به یک هدر پاسخ HTTP X-Allow-FLEDGE: true نیاز دارند.

خواص مورد نیاز

تنها دارایی های مورد نیاز برای گروه های ذینفع owner و name است:

ویژگی	مثال	نقش
owner	https://dsp.example	منشاء مالک گروه ذینفع.
name	custom-bikes	نام گروه ذینفع

خواص اختیاری

خواص باقی مانده اختیاری هستند:

biddingLogicUrl ^{1 ، 2}

مثال: https://dsp.example/bid/custom-bikes/bid.js

نقش: URL برای مناقصه جاوا اسکریپت اجرا شده در Worklet.

biddingWasmHelperUrl ^{1 ، 2}

مثال: https://dsp.example/bid/custom-bikes/bid.wasm

نقش: URL برای کد WebAssembly که از biddingLogicUrl هدایت می شود.

updateUrl ²

مثال: https://dsp.example/bid/custom-bikes/update

نقش: نشانی اینترنتی که JSON را برای به‌روزرسانی ویژگی‌های گروه علاقه برمی‌گرداند. ( به‌روزرسانی داده‌های مخاطب و بازخوانی تبلیغات را ببینید.)

trustedBiddingSignalsUrl ²

مثال: https://dsp.example/trusted/bidding-signals

نقش: URL پایه برای درخواست های کلید-مقدار به سرویس کلید/مقدار مورد اعتماد پیشنهاد دهنده.

trustedBiddingSignalsKeys

مثال: ['key1', 'key2' ...]

نقش: کلیدهای درخواست برای سرویس کلید/مقدار مورد اعتماد کلید-مقدار.

userBiddingSignals

مثال: {...}

نقش: فراداده اضافی که مالک می تواند در حین مناقصه استفاده کند.

ads ¹

مثال: [bikeAd1, bikeAd2, bikeAd3]

نقش: تبلیغاتی که ممکن است برای این گروه علاقه ارائه شود.

adComponents

مثال: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2]

نقش: اجزای تبلیغات متشکل از چندین قطعه .

¹ ویژگی های biddingLogicUrl و ads اختیاری هستند، اما برای شرکت در مزایده لازم است. ممکن است موارد استفاده ای برای ایجاد یک گروه علاقه بدون این ویژگی ها وجود داشته باشد: برای مثال، یک مالک گروه علاقه ممکن است بخواهد مرورگری را به یک گروه علاقه مند برای کمپینی که هنوز اجرا نمی شود، یا برای استفاده های دیگر در آینده اضافه کند، یا آنها ممکن است به طور موقت بودجه تبلیغات تمام شده باشد.

² در اجرای فعلی Protected Audience API، biddingLogicUrl ، biddingWasmHelperUrl ، updateUrl و trustedBiddingSignalsUrl باید منشأ یکسانی با مالک داشته باشند. ممکن است این یک محدودیت طولانی مدت نباشد و URL های ads و adComponents چنین محدودیتی ندارند.

تبلیغات را برای یک گروه علاقه مند مشخص کنید

ads و اشیاء adComponents شامل یک URL برای یک آگهی خلاقانه و به صورت اختیاری، ابرداده دلخواه است که می تواند در زمان مناقصه استفاده شود.

مثلا:

{
  renderUrl: 'https://cdn.example/.../bikeAd1.html',
  metadata: bikeAd1metadata // optional
}

leaveAdInterestGroup()

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

navigator.leaveAdInterestGroup({
  owner: 'https://dsp.example',
  name: 'custom-bikes'
});

اگر کاربر به سایتی برگردد که از مرورگر خواسته است یک گروه علاقه اضافه کند، مالک گروه علاقه‌مندی می‌تواند تابع navigator.leaveAdInterestGroup() فراخوانی کند تا از مرورگر درخواست کند گروه مورد علاقه را حذف کند.

کد برای یک تبلیغ همچنین می تواند این تابع را برای گروه مورد علاقه خود فراخوانی کند.

سوالات متداول

حداکثر تعداد گروه‌های علاقه در هر مالک گروه برای یک کاربر منفرد چقدر است؟

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

چگونه می‌توانم تبلیغات گروه علاقه‌ای را که آستانه‌های 𝑘-anon را برآورده می‌کنند، به حداکثر برسانم؟

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

از منظر تاکتیکی، ممکن است موارد زیر را در نظر بگیرید:

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

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

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

راهنماهای مرجع API در دسترس هستند:

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

توضیح دهنده Protected Audience API همچنین جزئیاتی در مورد پشتیبانی از ویژگی ها و محدودیت ها ارائه می دهد.