עדכון נתוני הקהל ורענון המודעות

כשיוצרים קהל בהתאמה אישית, אפשר לציין חלק מהמטא-נתונים של הקהל בהתאמה אישית או את כולם. אפשר להעביר את המידע הזה ישירות כשיוצרים אובייקט CustomAudience. השדה CustomAudience.Builder תומך גם בשדה dailyUpdateUri שיכול לספק ולעדכן את המטא-נתונים. הפלטפורמה מריצה משימה ברקע כל 24 שעות כדי לאחזר מטא-נתונים מעודכנים מה-dailyUpdateUri, או כל ארבע שעות אם לקהל המותאם אישית עדיין אין את AdData הנדרש כדי להשתתף במכרז. הפלטפורמה יכולה לעדכן את המטא-נתונים המותאמים אישית של הקהל הבאים:

  • אותות בידינג של משתמשים
  • נתוני בידינג מהימנים
  • רשימה אחת (AdData)

כדי לעדכן את המטא-נתונים האלה, מתבצע תהליך עדכון יומי ברקע שמבצע שאילתות לגבי dailyUpdateUri שמוגדר בקהל המותאם אישית, ויכול להחזיר תגובה בפורמט JSON.

  • תגובת ה-JSON עשויה להכיל כל אחד משדות המטא-נתונים הנתמכים שצריך לעדכן.
  • כל שדה JSON מאומת בנפרד. הלקוח מתעלם משדות בפורמט שגוי, וכתוצאה מכך לא מתבצעים עדכונים בשדה הספציפי הזה בתגובה.
  • תגובת HTTP ריקה או אובייקט JSON ריק מסוג '{}' לא יגרמו לעדכוני מטא-נתונים.
  • גודל הודעת התגובה חייב להיות מוגבל ל-10KB.
  • חובה להשתמש ב-HTTPS בכל מזהי ה-URI.
  • 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
        },
        ...
    ]
}

הגדרת השרת המדומה הזו כוללת דוגמה לסוג הנתונים שעשויים להיכלל בתגובה.