Kitle verilerini güncelleme ve reklamları yenileme

Özel kitle oluşturduğunuzda özel kitle meta verilerinin bir kısmını veya tamamını belirtebilirsiniz. Bu bilgiler, CustomAudience nesnesi oluşturulurken doğrudan iletilebilir. CustomAudience.Builder ayrıca meta verileri hem sağlayabilen hem de güncelleyebilen bir dailyUpdateUri alanını da destekler. Platform, dailyUpdateUri'dan güncellenmiş meta verileri getirmek için her 24 saatte bir arka plan işi çalıştırır. Özel kitle henüz bir açık artırmaya katılmak için gereken AdData'ye sahip değilse bu işlem her dört saatte bir yapılır. Platform, aşağıdaki özel kitle meta verilerini güncelleyebilir:

  • Kullanıcı teklif verme sinyalleri
  • Güvenilir teklif verileri
  • AdData listesi

Bu meta verileri güncellemek için günlük bir arka plan güncelleme işlemi, özel kitlede tanımlanan dailyUpdateUri öğesine karşı sorgu gönderir. Bu işlem, JSON yanıtı döndürebilir.

  • JSON yanıtı, güncellenmesi gereken desteklenen meta veri alanlarından herhangi birini içerebilir.
  • Her JSON alanı bağımsız olarak doğrulanır. İstemci, hatalı biçimlendirilmiş alanları yoksayar. Bu nedenle, yanıttaki söz konusu alanda güncelleme yapılmaz.
  • Boş bir HTTP yanıtı veya boş bir JSON nesnesi "{}" meta veri güncellemelerine neden olmaz.
  • Yanıt mesajı boyutu 10 KB ile sınırlı olmalıdır.
  • Tüm URI'lerin HTTPS kullanması gerekir.
  • trusted_bidding_uri, alıcıyla aynı ETLD+1'i paylaşmalıdır.

Örnek: Arka planda günlük güncelleme için JSON yanıtı

{
    "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
        },
        ...
    ]
}

Yanıtın içerebileceği veri türüyle ilgili bir örnek için bu sahte sunucu tanımına bakın.