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

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

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

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

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

    • IAB_AUDIENCE_1_1 สำหรับการจัดหมวดหมู่กลุ่มเป้าหมาย 1.1
    • IAB_CONTENT_2_2 สำหรับการจัดหมวดหมู่เนื้อหา 2.2
  • คีย์ values ที่มีอาร์เรย์ของค่าการจัดหมวดหมู่สตริงที่สอดคล้องกัน

สร้างอาร์เรย์สัญญาณที่มีโครงสร้าง

สำหรับสัญญาณที่มีโครงสร้าง ให้เพิ่มคีย์ 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": พ.
  • "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 กับ StreamRequest

  • สร้างสตริง JSON ที่มีความสนใจ พฤติกรรม หรือข้อมูลตามบริบทของผู้ใช้
  • สร้างสตริง ASCII ที่เข้ารหัส Base64 จากสตริง JSON ด้านบน
  • เพิ่ม JSON ที่เข้ารหัสโดยใช้ StreamRequest.setAdTagParameters
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();
}

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);
}

Map<String, String> adTagParamMap = new java.util.HashMap<String, String>();
adTagParamMap.put("ppsj", encodedSignals);

streamRequest.setAdTagParameters(adTagParamMap)