Aktualizowanie danych o odbiorcach i odświeżanie reklam

Podczas tworzenia grupy odbiorców niestandardowych możesz określić niektóre lub wszystkie metadane grupy odbiorców niestandardowych. Te informacje można przekazać bezpośrednio podczas tworzenia obiektu CustomAudience. CustomAudience.Builder obsługuje też pole dailyUpdateUri, które może dostarczać i aktualizować metadane. Platforma będzie uruchamiać zadanie w tle co 24 godziny, aby pobierać zaktualizowane metadane z dailyUpdateUri, lub co 4 godziny, jeśli odbiorcy niestandardowi nie mają jeszcze AdData potrzebnych do udziału w aukcji. Platforma może aktualizować te elementy metadanych odbiorców niestandardowych:

  • Sygnały dotyczące określania stawek przez użytkowników
  • Dane dotyczące określania stawek, którym ufasz
  • AdData lista

Aby zaktualizować te metadane, codzienny proces aktualizacji w tle wysyła zapytania do dailyUpdateUri zdefiniowanego na liście odbiorców niestandardowych, co może spowodować zwrócenie odpowiedzi w formacie JSON.

  • Odpowiedź JSON może zawierać dowolne obsługiwane pola metadanych, które wymagają aktualizacji.
  • Każde pole JSON jest weryfikowane niezależnie. Klient ignoruje nieprawidłowo sformułowane pola, co powoduje, że w odpowiedzi nie ma aktualizacji tego konkretnego pola.
  • Pusta odpowiedź HTTP lub pusty obiekt JSON „{}” nie powodują aktualizacji metadanych.
  • Rozmiar wiadomości z odpowiedzią musi być ograniczony do 10 KB.
  • Wszystkie identyfikatory URI muszą używać protokołu HTTPS.
  • trusted_bidding_uri musi mieć taką samą domenę ETLD+1 jak kupujący.

Przykład: odpowiedź JSON dotycząca codziennej aktualizacji w tle

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

Przykład danych, które mogą być zawarte w odpowiedzi, znajdziesz w tej definicji serwera testowego.