Analizowanie żądania SegmentRequest

W przypadku selekcjonowania w czasie rzeczywistym Google wysyła do Twojego punktu końcowego selekcjonowania plik JSONSegmentRequest, aby przekazywać sygnały opisujące co najmniej 1 wyświetlenie. Dzięki temu możesz określać odpowiednie segmenty danych dla każdego z nich. W tym przewodniku znajdziesz informacje o opracowywaniu 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 utworzysz punkt końcowy selekcji w czasie rzeczywistym, musisz wybrać, czy chcesz otrzymywać sygnały kontekstowe czy bezpieczne. Wybrane 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żywaj sygnałów kontekstowych

Sygnały kontekstowe zawierają informacje o wydawcy, urządzeniu i użytkowniku, które opisują pochodzenie wyświetlenia. Lista poniżej zawiera opis dostępnych sygnałów:

  • SegmentRequest.site: opisuje witrynę, w której wyświetla się reklama, np. adres URL witryny. W elemencie SegmentRequest można wypełnić tylko jedno z pól SegmentRequest.site i SegmentRequest.app.
  • SegmentRequest.app: Opisuje aplikację, która wyświetla 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ę treści, w których wyświetlono reklamę, np. identyfikator wydawcy.
  • SegmentRequest.user: opisuje wybory użytkownika dotyczące sposobu przetwarzania jego danych osobowych, np. za pomocą ciągu tekstowego dotyczącego przejrzystości i zgody na przetwarzanie danych 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ę selekcji, która określa odpowiednie segmenty danych do zwrócenia w 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 selekcji w czasie rzeczywistym pojawiają się w zaciemnionej formie w SegmentRequest.user.eids.uids.id.

Jeśli punkt końcowy jest skonfigurowany do używania 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 łączna liczba 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 selekcjonowania w czasie rzeczywistym

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

Dalsze kroki