Mengurai SegmentRequest

Dalam Seleksi Real-time, Google mengirimkan JSON SegmentRequest ke endpoint seleksi Anda untuk memberikan sinyal yang menjelaskan satu atau beberapa impresi, sehingga Anda dapat menentukan segmen data yang berlaku untuk setiap impresi. Panduan ini membahas pengembangan logika kurasi yang menangani SegmentRequest.

Menggunakan encoding gzip

Google menggunakan encoding gzip saat mengirim SegmentRequest ke endpoint Anda. Endpoint Anda harus dapat menerima dan merespons dengan encoding gzip.

Seleksi dengan endpoint sinyal kontekstual atau sinyal audiens

Saat membuat endpoint Kurasi Real-time, Anda harus memilih apakah akan menerima sinyal kontekstual atau sinyal audiens. Sinyal yang Anda pilih akan memengaruhi cara pengisian permintaan segmen yang dikirim ke endpoint Anda, jumlah inventaris yang menghasilkan permintaan segmen yang dikirim ke endpoint Anda, dan logika seleksi yang digunakan dalam integrasi Anda.

Menggunakan sinyal kontekstual

Sinyal kontekstual mencakup informasi tentang penayang, perangkat, dan pengguna yang menjelaskan asal tayangan iklan. Daftar berikut menjelaskan sinyal yang tersedia:

  • SegmentRequest.site: Mendeskripsikan situs yang merender tayangan iklan, seperti URL situs. Hanya salah satu dari SegmentRequest.site dan SegmentRequest.app yang dapat diisi dalam SegmentRequest.
  • SegmentRequest.app: Mendeskripsikan aplikasi yang merender tayangan iklan, seperti ID aplikasi khusus platform aplikasi. Hanya salah satu dari SegmentRequest.site dan SegmentRequest.app yang dapat diisi dalam SegmentRequest.
  • SegmentRequest.pub: Mendeskripsikan penayang media yang merender tayangan iklan; misalnya, ID penayang.
  • SegmentRequest.user: Menjelaskan pilihan pengguna tentang cara data pribadi mereka dapat diproses; misalnya, dengan string izin TCF.
  • SegmentRequest.device: Mendeskripsikan informasi tentang perangkat, seperti lokasi geografis perangkat dengan presisi tingkat kota.

Anda dapat menggunakan sinyal kontekstual untuk menerapkan logika seleksi yang dapat menentukan segmen data yang berlaku untuk ditampilkan di SegmentResponse.

Menggunakan sinyal audiens

Sinyal audiens mencakup ID pengguna atau perangkat, serta sinyal aman. Sinyal aman adalah data yang dibuat oleh penayang yang telah mereka pilih untuk dibagikan kepada satu atau beberapa partner. Data tersebut di-obfuscate sebelum dibagikan kepada Google dalam permintaan iklan, dan dalam Kurasi Real-time, data tersebut muncul dalam bentuk yang di-obfuscate di SegmentRequest.user.eids.uids.id.

Jika endpoint Anda dikonfigurasi untuk menggunakan sinyal audiens, endpoint Anda hanya menerima permintaan segmen untuk inventaris penayang yang telah memilih untuk membagikan sinyal aman ke akun kurasi Anda. Akibatnya, jumlah total tayangan yang memenuhi syarat untuk dikirim ke endpoint sinyal audiens lebih sedikit dibandingkan dengan endpoint sinyal kontekstual.

Logika seleksi endpoint Anda harus menafsirkan sinyal audiens dan menentukan segmen data yang berlaku untuk ditampilkan di SegmentResponse.

Contoh SegmentRequest

Endpoint Kurasi Real-time sinyal kontekstual

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

Endpoint Kurasi Real-time sinyal audiens

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

Langkah berikutnya