PPS ile reklam kampanyalarını iyileştirin

Platform seçin: HTML5 Android iOS tvOS

Reklam isteklerinde kitle ve içerik verilerini yayıncı tarafından sağlanan sinyaller (PPS) olarak gönderebilirsiniz. PPS ile kullanıcı verilerinizi kullanarak kitle özelliklerinizi tüm işlem türlerinde standart sınıflandırmalar aracılığıyla teklif verenlere iletebilir ve kullanıcı tanımlayıcılarını paylaşmanıza gerek kalmadan programatik para kazanma performansını artırabilirsiniz. Kitle özellikleriniz, davranış ve ilgi alanına dayalı verileri (IAB Kitle Sınıflandırması 1.1) ve içerik verisini (IAB İçerik Sınıflandırması 2.2) içerebilir. Ayrıca, Google tarafından tanımlanan ve ek sinyallerin gönderilmesine olanak tanıyan, yayıncı tarafından sağlanan yapılandırılmış sinyaller de gönderebilirsiniz.

Kullanıcı sinyalleri JSON'unu oluşturma

En üst düzeyde, tek bir anahtar/değer çifti içeren bir JSON nesnesi oluşturun. Anahtar PublisherProvidedTaxonomySignals, değeri ise bir nesne dizisi olmalıdır. Dizideki her nesnede 2 anahtar/değer çifti bulunmalıdır:

  • Aşağıdaki IAB herkese açık spesifikasyonlarıyla eşlenen şu değerleri kabul eden taxonomy anahtarı:

    • Kitle Sınıflandırması 1.1 için IAB_AUDIENCE_1_1
    • İçerik Sınıflandırması 2.2 için IAB_CONTENT_2_2

  • Karşılık gelen dize taksonomi değerleri dizisine sahip values anahtarı.

Yapılandırılmış sinyal dizisini oluşturma

Yapılandırılmış sinyaller için PublisherProvidedStructuredSignals anahtarını bir nesne dizisi değeriyle ekleyin. Nesneyi aşağıdaki sinyal anahtar/değer çiftleri listesine göre oluşturun:

Yapılandırılmış sinyaller tablosunun görünümünü aç/kapat

Sinyal <code" dir="ltr" translate="no">"type" Value</code"> Olası "single_value" Değerleri Olası "values" Değerleri
Ses Feed'i Türü "audio_feed"
  • "af_1": Müzik
  • "af_2": Anons
  • "af_3": Podcast
 Yok
İçerik Derecelendirme "content_rating"
  • "cr_1": G
  • "cr_2": PG
  • "cr_3": T
  • "cr_4": MA
 Yok
İçerik Yayınlama "delivery" Yok
  • "cd_1": Canlı yayın
  • "cd_2": Progressive
  • "cd_3": İndir
Yapım Kalitesi "prodq"
  • "pq_1": Profesyonel Olarak Üretilmiş
  • "pq_2": Profesyonel tüketici
  • "pq_3": Kullanıcı tarafından oluşturulan (UGC)
 Yok

Sınıflandırma sinyalleri için IAB_AUDIENCE_1_1 ve IAB_CONTENT_2_2 kullanan ve yapılandırılmış sinyaller içeren aşağıdaki örneğe bakın.

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"],
    },
  ],
};

Reklam isteğinizi yapılandırma

AdsRequest ile PPS göndermek için aşağıdaki adımları uygulayın:

  • Kullanıcının ilgi alanı, davranış veya içerik verilerini içeren bir JSON dizesi oluşturun.
  • Yukarıdaki JSON dizesinden Base64 kodlu bir ASCII dizesi oluşturun.
  • Kodlanmış dizeyi &ppsj= parametresiyle reklam etiketi URL'nize ekleyin.
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;