Analizowanie żądania SegmentRequest

W przypadku wyboru w czasie rzeczywistym Google wysyła do Twojego punktu końcowego wyboru plik JSON SegmentRequest z sygnałami opisującymi co najmniej 1 wyświetlenie, co pozwala Ci określić odpowiednie segmenty danych dla każdego z nich. W tym przewodniku znajdziesz informacje o tworzeniu logiki selekcjonowania, która obsługuje SegmentRequest.

Używanie kodowania gzip

Google używa kodowania gzip podczas wysyłania SegmentRequest do Twojego punktu końcowego. Twój punkt końcowy musi być w stanie odbierać i wysyłać odpowiedzi zakodowane w formacie gzip.

Wybór treści z użyciem punktów końcowych sygnałów kontekstowych lub bezpiecznych sygnałów

Gdy tworzysz punkt końcowy selektywnego wyświetlania reklam w czasie rzeczywistym, musisz wybrać, czy chcesz otrzymywać sygnały kontekstowe czy bezpieczne. Wybrane przez Ciebie sygnały wpływają na sposób wypełniania żądań segmentów wysyłanych do punktu końcowego, ilość zasobów reklamowych generujących żądania segmentów wysyłanych do punktu końcowego oraz logikę selekcji używaną w integracji.

Używanie sygnałów kontekstowych

Sygnały kontekstowe obejmują informacje o wydawcy, urządzeniu i użytkowniku, które opisują pochodzenie wyświetlenia. Poniżej znajdziesz listę dostępnych sygnałów:

  • SegmentRequest.site: opisuje witrynę, w której wyświetla się reklama, np. adres URL witryny. W SegmentRequest można wypełnić tylko jedno z pól SegmentRequest.site i SegmentRequest.app.
  • SegmentRequest.app: opisuje aplikację, w której wyświetlono reklamę, np. identyfikator aplikacji na konkretnej platformie. W elemencie SegmentRequest można wypełnić tylko jedno z pól SegmentRequest.site i SegmentRequest.app.
  • SegmentRequest.pub: Opisuje wydawcę multimediów, które wygenerowały wyświetlenie, np. identyfikator wydawcy.
  • SegmentRequest.user: opisuje wybory użytkownika dotyczące sposobu przetwarzania jego danych osobowych, np. za pomocą ciągu tekstowego dotyczącego zgody w ramach zasad TCF.
  • SegmentRequest.device: Zawiera informacje o urządzeniu, np. jego lokalizację geograficzną z dokładnością do poziomu metra.

Za pomocą sygnałów kontekstowych możesz wdrożyć logikę wyboru, która określa odpowiednie segmenty danych do zwrócenia w parametrze SegmentResponse.

Używanie bezpiecznych sygnałów

Bezpieczne sygnały to dane utworzone przez wydawcę, które zdecydował się on udostępnić co najmniej jednemu partnerowi. Zanim zostaną udostępnione Google w żądaniu reklamy, są zaciemniane, a w przypadku selektywnego wyświetlania reklam w czasie rzeczywistym pojawiają się w zaciemnionej formie w SegmentRequest.user.eids.uids.id.

Jeśli punkt końcowy jest skonfigurowany do korzystania z bezpiecznych sygnałów, będzie otrzymywać żądania segmentów tylko w przypadku zasobów reklamowych wydawców, którzy zdecydowali się udostępniać bezpieczne sygnały Twojemu kontu do selekcjonowania. W związku z tym liczba wszystkich wyświetleń, które można wysłać do punktów końcowych bezpiecznych sygnałów, jest mniejsza niż w przypadku punktów końcowych sygnałów kontekstowych.

Logika selekcjonowania punktu końcowego musi interpretować bezpieczny sygnał i używać go do określania odpowiednich segmentów danych, które mają być zwracane w parametrze SegmentResponse.

Przykłady SegmentRequest

Punkt końcowy sygnału kontekstowego do moderowania w czasie rzeczywistym

{
  "site":{
    "page":"https://dfpgpt.appspot.com/smd/"
  },
  "pub":{
    "id":"pub-1234567890987654"
  },
  "device":{
    "geo":{
      "country":"US",
        "metro":"501"
      }
    }
  }
}

Punkt końcowy Bezpiecznych sygnałów do moderowania w czasie rzeczywistym

{
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }]
  }
}

Dalsze kroki