สัญญาณที่ได้จากผู้เผยแพร่โฆษณา

คุณสามารถส่งข้อมูลกลุ่มเป้าหมายและข้อมูลตามบริบทเป็นสัญญาณที่ได้จากผู้เผยแพร่โฆษณา (PPS) ในคําขอโฆษณา PPS ให้คุณใช้ข้อมูลผู้ใช้เพื่อปรับปรุงการสร้างรายได้แบบเป็นโปรแกรมโดยการสื่อสารลักษณะของกลุ่มเป้าหมายให้ผู้เสนอราคาทราบในประเภทธุรกรรมทั้งหมดโดยใช้การจัดหมวดหมู่มาตรฐานโดยไม่ต้องแชร์ตัวระบุผู้ใช้ ลักษณะของกลุ่มเป้าหมายอาจรวมถึงข้อมูลตามพฤติกรรมและความสนใจ (การจัดหมวดหมู่กลุ่มเป้าหมายของ IAB 1.1) และข้อมูลตามบริบท (การจัดหมวดหมู่เนื้อหาของ IAB 2.2) คุณยังสามารถส่งสัญญาณที่มีโครงสร้างที่ได้จากผู้เผยแพร่โฆษณาซึ่ง Google กำหนด และอนุญาตให้มีการส่งสัญญาณเพิ่มเติมได้ด้วย

สร้าง JSON สัญญาณผู้ใช้

ที่ระดับบนสุด ให้สร้างออบเจ็กต์ JSON ที่มีคู่คีย์-ค่าเดียว คีย์ควรเป็น PublisherProvidedTaxonomySignals และค่าควรเป็นอาร์เรย์ของออบเจ็กต์ ออบเจ็กต์แต่ละรายการในอาร์เรย์ควรมีคู่คีย์-ค่า 2 คู่ ดังนี้

• คีย์ taxonomy ซึ่งยอมรับค่าต่อไปนี้ที่แมปกับข้อกำหนดสาธารณะของ IAB ต่อไปนี้

  • IAB_AUDIENCE_1_1 สำหรับการจัดหมวดหมู่กลุ่มเป้าหมาย 1.1
  • IAB_CONTENT_2_2 สำหรับการจัดหมวดหมู่เนื้อหา 2.2

• คีย์ values ที่มีอาร์เรย์ของค่าการจัดหมวดหมู่สตริงที่สอดคล้องกัน

สร้างอาร์เรย์สัญญาณ Structured Data

สำหรับสัญญาณที่มีโครงสร้าง ให้เพิ่มคีย์ PublisherProvidedStructuredSignals ที่มีค่าอาร์เรย์ของออบเจ็กต์ สร้างออบเจ็กต์ตามรายการคีย์-ค่าสัญญาณต่อไปนี้

สลับมุมมองของตารางสัญญาณที่มีโครงสร้าง

สัญญาณ	<code" dir="ltr" translate="no">"type" Value</code">	ค่า "single_value" ที่เป็นไปได้	ค่า "values" ที่เป็นไปได้
ประเภทฟีดเสียง	"audio_feed"	"af_1": เพลง "af_2": ออกอากาศ "af_3": พอดแคสต์	ไม่มี
การให้คะแนนเนื้อหา	"content_rating"	"cr_1": ประตู "cr_2": PG "cr_3": T "cr_4": MA	ไม่มี
การส่งเนื้อหา	"delivery"	ไม่มี	"cd_1": สตรีมมิง "cd_2": โพรเกรสซีฟ "cd_3": ดาวน์โหลด
คุณภาพการผลิต	"prodq"	"pq_1": ผลิตโดยมืออาชีพ "pq_2": การผลิตโดยผู้บริโภค "pq_3": สร้างโดยผู้ใช้ (UGC)	ไม่มี

ดูตัวอย่างต่อไปนี้ที่ใช้ IAB_AUDIENCE_1_1 และ IAB_CONTENT_2_2 สำหรับสัญญาณการจัดหมวดหมู่และมี Structured Data

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

กำหนดค่าคำขอโฆษณา

ทำตามขั้นตอนต่อไปนี้เพื่อส่ง PPS ไปกับ AdsRequest

• สร้างสตริง JSON ที่มีความสนใจ พฤติกรรม หรือข้อมูลบริบทของผู้ใช้
• สร้างสตริง ASCII ที่เข้ารหัส Base64 จากสตริง JSON ด้านบน
• เพิ่มสตริงที่เข้ารหัสต่อท้าย URL แท็กโฆษณาด้วยพารามิเตอร์ &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;