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 Anda dapat mencakup data berbasis perilaku dan minat ( Taksonomi Audiens IAB 1.1), dan data kontekstual ( Taksonomi Konten IAB 2.2). Anda juga dapat mengirim sinyal terstruktur yang diberikan penayang, yang ditentukan oleh Google, dan memungkinkan sinyal tambahan dikirim.

Membuat JSON sinyal pengguna

Di tingkat teratas, buat objek JSON dengan satu key-value pair. 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:

Aktifkan/nonaktifkan tampilan tabel sinyal terstruktur

Sinyal <code" dir="ltr" translate="no">"type" Value</code"> Nilai "single_value" yang Mungkin Muncul 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": PG
  • "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 mengirim PPS dengan AdsRequest Anda:

  • 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=.
JSONObject userSignalsObject = new JSONObject();
JSONArray userSignalsArray = new JSONArray();
JSONObject audienceTaxonomyObject = new JSONObject();
JSONArray valuesArray = new JSONArray();
valuesArray.put("1");
valuesArray.put("284");
try {
  audienceTaxonomyObject.put("taxonomy", "IAB_AUDIENCE_1_1");
  audienceTaxonomyObject.put("values", valuesArray);
} catch (JSONException e) {
  e.printStackTrace();
}

userSignalsArray.put(audienceTaxonomyObject);

try {
  userSignalsObject.put("PublisherProvidedTaxonomySignals", userSignalsArray);
} catch (JSONException e) {
  e.printStackTrace();
}

String userSignals = userSignalsObject.toString();

byte[] userSignalsByte=new byte[0];
try {
  userSignalsByte = userSignals.getBytes(StandardCharsets.UTF_8);
  String encodedBas64Signals = android.util.Base64.encodeToString(
    userSignalsByte,
    android.util.Base64.URL_SAFE);
  encodedSignals = URLEncoder.encode(encodedBas64Signals, "UTF-8");
} catch (java.io.UnsupportedEncodingException error) {
  Log.w("Sample app", error);
}

String finalAdTag = sampleAdTag + "&ppsj=" + encodedSignals;