وقتی یک مخاطب سفارشی ایجاد می‌کنید، می‌توانید برخی یا همه فراداده مخاطبان سفارشی را مشخص کنید. این اطلاعات می تواند به طور مستقیم هنگام ایجاد یک شیء CustomAudience منتقل شود. CustomAudience.Builder همچنین از یک فیلد dailyUpdateUri پشتیبانی می کند که هم می تواند ابرداده را تامین و هم به روز کند. این پلتفرم هر 24 ساعت یک کار پس‌زمینه برای واکشی ابرداده‌های به‌روزرسانی شده از dailyUpdateUri انجام می‌دهد، یا اگر مخاطبان سفارشی هنوز AdData مورد نیاز برای شرکت در حراج را نداشته باشند، هر چهار ساعت یک‌بار کار می‌کند. این پلتفرم می‌تواند تکه‌های متادیتای مخاطب سفارشی زیر را به‌روزرسانی کند:
- سیگنال های پیشنهاد کاربر
- داده های مناقصه قابل اعتماد
- لیست
AdData
برای به‌روزرسانی این ابرداده، یک فرآیند به‌روزرسانی پس‌زمینه روزانه در برابر dailyUpdateUri تعریف شده در مخاطبان سفارشی درخواست می‌کند که ممکن است پاسخ JSON را برگرداند.
- پاسخ JSON ممکن است حاوی هر یک از فیلدهای فوق داده پشتیبانی شده باشد که باید به روز شوند.
- هر فیلد JSON به طور مستقل تأیید می شود. کلاینت فیلدهای نادرست را نادیده می گیرد، که منجر به به روز رسانی آن فیلد خاص در پاسخ نمی شود.
- یک پاسخ HTTP خالی یا یک شیء خالی JSON "
{}" منجر به به‌روزرسانی ابرداده نمی‌شود. - اندازه پیام پاسخ باید به 10 کیلوبایت محدود شود.
- همه URI ها برای استفاده از HTTPS مورد نیاز هستند.
-
trusted_bidding_uriباید همان ETLD+1 را با خریدار به اشتراک بگذارد.
مثال: پاسخ JSON برای به‌روزرسانی روزانه در پس‌زمینه
{
"user_bidding_signals" : { ... }, // Valid JSON object
"trusted_bidding_data" : {
"trusted_bidding_uri" : "example-dsp1-key-value-service.com",
"trusted_bidding_keys" : [ "campaign123", "campaign456", ... ]
},
"ads" : [
{
"render_uri" : "www.example-dsp1.com/.../campaign123.html",
"metadata" : { ... } // Valid JSON object
},
{
"render_uri" : "www.example-dsp1.com/.../campaign456.html",
"metadata" : { ... } // Valid JSON object
},
...
]
}
برای نمونه ای از نوع داده هایی که ممکن است در پاسخ گنجانده شود، این تعریف سرور ساختگی را ببینید.