Aktualizowanie danych o odbiorcach i odświeżanie reklam

Podczas tworzenia listy odbiorców niestandardowych możesz określić niektóre lub wszystkie metadane listy 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 co 24 godziny uruchamiać zadanie w tle, aby pobierać zaktualizowane metadane z dailyUpdateUri. Jeśli grupa niestandardowych odbiorców nie ma jeszcze AdData potrzebnych do udziału w aukcji, platforma będzie to robić co 4 godziny. Platforma może aktualizować te elementy metadanych niestandardowych list odbiorców:

  • Sygnały dotyczące ustalania stawek przez użytkownika
  • Zaufane dane określania stawek
  • AdData lista

Aby zaktualizować te metadane, codzienny proces aktualizacji w tle wysyła zapytania do tabeli dailyUpdateUri zdefiniowanej w listach niestandardowych odbiorców. Może on zwracać odpowiedź w formacie JSON.

  • Odpowiedź w formacie JSON może zawierać dowolne obsługiwane pola metadanych, które wymagają aktualizacji.
  • Każde pole JSON jest sprawdzane niezależnie. Klient ignoruje nieprawidłowo sformułowane pola, co powoduje brak aktualizacji w odpowiednich polach w odpowiedzi.
  • Pusty komunikat HTTP lub pusty obiekt JSON „{}” powoduje brak aktualizacji metadanych.
  • Rozmiar wiadomości z odpowiedzią musi być ograniczony do 10 KB.
  • W przypadku wszystkich identyfikatorów URI musi być używany protokół HTTPS.
  • trusted_bidding_uri musi mieć ten sam identyfikator ETLD+1 co kupujący.

Przykład: odpowiedź JSON dla dziennego powiadomienia tła

{
    "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ć uwzględnione w odpowiedzi, znajdziesz w przykładowej definicji serwera testowego.