وقتی یک مخاطب سفارشی ایجاد میکنید، میتوانید برخی یا تمام فرادادههای مخاطب سفارشی را مشخص کنید. این اطلاعات را میتوان مستقیماً هنگام ایجاد یک شیء 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
},
...
]
}
برای مثالی از نوع دادههایی که ممکن است در پاسخ گنجانده شوند، به این تعریف سرور آزمایشی مراجعه کنید.