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

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

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

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

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

صاحبان گروه‌های ذی‌نفع در مزایده تبلیغات Protected Audience 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 را برای به‌روزرسانی ویژگی‌های گروه علاقه‌مندی برمی‌گرداند. این URL باید منشأ یکسانی با 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 همچنین جزئیاتی در مورد پشتیبانی از ویژگی ها و محدودیت ها ارائه می دهد.