Sinyal yang diberikan penayang

Anda dapat mengirim data audiens dan kontekstual sebagai sinyal yang diberikan penayang (PPS) dalam permintaan iklan. Dengan PPS, Anda dapat menggunakan data pengguna untuk meningkatkan monetisasi terprogram dengan menyampaikan karakteristik audiens kepada bidder di semua jenis transaksi, menggunakan taksonomi standar, tanpa perlu membagikan ID pengguna. Karakteristik audiens dapat mencakup data berbasis perilaku dan minat (Taksonomi Audiens IAB 1.1), serta data kontekstual (Taksonomi Konten IAB 2.2). Anda juga dapat mengirim sinyal terstruktur yang diberikan penayang, yang ditentukan oleh Google, dan memungkinkan sinyal tambahan untuk dikirim.

Membuat JSON sinyal pengguna

Di tingkat teratas, buat objek JSON dengan satu pasangan nilai kunci. Kuncinya harus berupa PublisherProvidedTaxonomySignals, dan nilainya harus berupa array objek. Setiap objek dalam array harus memiliki 2 pasangan nilai kunci:

  • Kunci taxonomy, yang menerima nilai berikut yang dipetakan untuk mengikuti spesifikasi publik IAB:

    • IAB_AUDIENCE_1_1 untuk Taksonomi Audiens 1.1
    • IAB_CONTENT_2_2 untuk Taksonomi Konten 2.2

  • Kunci values dengan array nilai taksonomi string yang sesuai.

Membuat array sinyal terstruktur

Untuk sinyal terstruktur, tambahkan kunci PublisherProvidedStructuredSignals dengan nilai array objek. Buat objek berdasarkan daftar nilai kunci sinyal berikut:

Beralih tampilan tabel sinyal terstruktur

Sinyal <code" dir="ltr" translate="no">"type" Value</code"> Nilai "single_value" yang Mungkin Nilai "values" yang Mungkin
Jenis Feed Audio "audio_feed"
  • "af_1": Musik
  • "af_2": Siaran
  • "af_3": Podcast
 t/a
Rating Konten "content_rating"
  • "cr_1": G
  • "cr_2": BO
  • "cr_3": T
  • "cr_4": MA
 t/a
Pengiriman Konten "delivery" t/a
  • "cd_1": Streaming
  • "cd_2": Progresif
  • "cd_3": Mendownload
Kualitas Produksi "prodq"
  • "pq_1": Diproduksi secara Profesional
  • "pq_2": Prosumer
  • "pq_3": Buatan Pengguna (UGC)
 t/a

Lihat contoh berikut yang menggunakan IAB_AUDIENCE_1_1 dan IAB_CONTENT_2_2 untuk sinyal taksonomi dan menyertakan sinyal terstruktur.

const userSignals = {
  "PublisherProvidedTaxonomySignals": [{
     "taxonomy": "IAB_AUDIENCE_1_1",
     "values": ["6", "284"]
     // '6' = 'Demographic | Age Range | 30-34'
     // '284' = 'Interest | Business and Finance |  Mergers and Acquisitions'
  },
  {
     "taxonomy": "IAB_CONTENT_2_2",
     "values": ["49", "138"]
     // '49' = 'Books and Literature | Poetry'
     // '138' = 'Education | College Education | College Planning'
  }],
  "PublisherProvidedStructuredSignals": [{
      "type": "audio_feed",
      "single_value": "af_1",
    },
    {
      "type": "delivery",
      "values": ["cd_1", "cd_3"],
    },
  ],
};

Mengonfigurasi permintaan iklan

Ikuti langkah-langkah berikut untuk mengirimkan PPS dengan IMAAdsRequest:

  • Buat string JSON dengan minat, perilaku, atau data kontekstual pengguna.
  • Buat string ASCII berenkode Base64 dari string JSON di atas.
  • Tambahkan string yang dienkode ke URL tag iklan Anda dengan parameter &ppsj=.
let userSignals = """
{
   "PublisherProvidedTaxonomySignals": [
    {
      "taxonomy": "IAB_AUDIENCE_1_1",
      "values": [
        "1",
        "284"
      ]
    }
  ],
}
"""
let base64Signals = Data(userSignals.utf8).base64EncodedString()
var encodedSignals = base64Signals.replacingOccurrences(of: "+", with: "%2B")
encodedSignals = encodedSignals.replacingOccurrences(of: "/", with: "%2F")
encodedSignals = encodedSignals.replacingOccurrences(of: "=", with: "%3D")


let finalAdTag = sampleAdTag + "&ppsj=" + encodedSignals