Mengurai SegmentRequest

Dalam Kurasi Real-time, Google mengirimkan JSON SegmentRequest ke endpoint kurasi Anda untuk memberikan sinyal yang menjelaskan satu atau beberapa tayangan iklan, sehingga Anda dapat menentukan segmen data yang berlaku untuk setiap tayangan iklan. 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 aman

Saat membuat endpoint Kurasi Real-time, Anda harus memilih apakah akan menerima sinyal kontekstual atau sinyal aman. Sinyal yang Anda pilih akan memengaruhi cara permintaan segmen yang dikirim ke endpoint Anda diisi, jumlah inventaris yang menghasilkan permintaan segmen yang dikirim ke endpoint Anda, dan logika kurasi 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: Mendeskripsikan pilihan pengguna tentang cara data pribadi mereka dapat diproses; misalnya, dengan string izin TCF.
  • SegmentRequest.device: Mendeskripsikan informasi tentang perangkat, seperti lokasi geografis perangkat pada presisi tingkat kota.

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

Menggunakan sinyal aman

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

Jika endpoint Anda dikonfigurasi untuk menggunakan sinyal aman, endpoint Anda hanya akan 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 aman lebih sedikit dibandingkan dengan endpoint sinyal kontekstual.

Logika kurasi endpoint Anda harus menafsirkan sinyal aman, dan menggunakan sinyal aman untuk menentukan segmen data yang berlaku untuk ditampilkan dalam 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 aman

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

Langkah berikutnya