اطلاعات مخاطبان را به روز کنید و تبلیغات را به روز کنید

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

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

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

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

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

توابع API

مثال استفاده

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

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);

updateUrl URL را ارائه می دهد که JSON را برای به روز رسانی ویژگی های گروه علاقه برمی گرداند. این باید منشا یکسانی با owner داشته باشد.

به روز رسانی ویژگی ها

updateUrl وب سروری را مشخص می‌کند که ویژگی‌های گروه علاقه تعریف JSON را برمی‌گرداند که مطابق با شی گروه علاقه ارسال شده به joinAdInterestGroup() .

این به مالک گروه اجازه می دهد تا به طور دوره ای ویژگی های گروه مورد علاقه را به روز کند. در پیاده سازی فعلی ، ویژگی های زیر را می توان تغییر داد:

  • biddingLogicUrl
  • biddingWasmHelperUrl
  • trustedBiddingSignalsUrl
  • trustedBiddingSignalsKeys
  • ads
  • priority

هر فیلدی که در JSON مشخص نشده است رونویسی نمی‌شود—فقط فیلدهای مشخص‌شده در JSON به‌روزرسانی می‌شوند—در حالی که فراخوانی navigator.joinAdInterestGroup() هر گروه علاقه موجود را رونویسی می‌کند.

به روز رسانی بهترین تلاش است و ممکن است در شرایط زیر شکست بخورد:

  • مهلت درخواست شبکه (در حال حاضر 30 ثانیه).
  • خرابی شبکه دیگر
  • تجزیه JSON شکست خورد.

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

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

به روز رسانی های دستی

به‌روزرسانی‌های گروه‌های علاقه متعلق به مبدأ قاب فعلی را می‌توان به صورت دستی با استفاده از navigator.updateAdInterestGroups() فعال کرد.

محدود کردن نرخ از انجام به‌روزرسانی‌ها مکرر جلوگیری می‌کند: تماس‌های مکرر با navigator.updateAdInterestGroups() تا زمانی که دوره محدودیت نرخ (در حال حاضر یک روز) سپری نشود، کاری انجام نمی‌دهند.

اگر navigator.joinAdInterestGroup() مجدداً برای owner و name گروه ذینفع فراخوانی شود، محدودیت نرخ بازنشانی می‌شود.

بروزرسانی های خودکار

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

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

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

以下是 API 参考指南:

Protected Audience API 说明信息还详细介绍了功能支持和限制条件。