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 selekcji, 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 odpowiadać za pomocą kodowania gzip.

Wybór treści za pomocą punktów końcowych sygnałów kontekstowych lub sygnałów dotyczących odbiorców

Podczas tworzenia punktu końcowego selektywnego wyświetlania reklam w czasie rzeczywistym musisz wybrać, czy chcesz otrzymywać sygnały kontekstowe czy sygnały dotyczące odbiorców. Wybrane sygnały wpływają na to, jak wypełniane są żądania segmentów wysyłane do punktu końcowego, ile zasobów reklamowych generuje żądania segmentów wysyłane do punktu końcowego oraz jaka logika selekcjonowania jest używana 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 jedną z wartości SegmentRequest.site i SegmentRequest.app.
  • SegmentRequest.app: Opisuje aplikację, która renderuje wyświetlenie, 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.
  • SegmentRequest.device: Zawiera informacje o urządzeniu, np. jego lokalizację geograficzną z dokładnością do poziomu metra.

Możesz używać sygnałów kontekstowych do wdrażania logiki wyboru, która może określać odpowiednie segmenty danych do zwrócenia w parametrze SegmentResponse.

Korzystanie z sygnałów dotyczących odbiorców

Sygnały dotyczące odbiorców obejmują identyfikatory użytkowników lub urządzeń, a także bezpieczne sygnały. 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. 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 sygnałów dotyczących odbiorców, otrzymuje on żą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 sygnałów dotyczących odbiorców, jest mniejsza niż w przypadku punktów końcowych sygnałów kontekstowych.

Logika selekcjonowania punktu końcowego musi interpretować sygnały dotyczące odbiorców i określać odpowiednie segmenty danych, które mają być zwracane w 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 selekcjonowania sygnałów dotyczących odbiorców w czasie rzeczywistym

{
  "device":{
    "ifa":"OMITTED_IFA"
  },
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }],
    "buyeruid": "OMITTED_BUYERUID",
    "id": "OMITTED_ID"
  }
}

Dalsze kroki