คุณสามารถส่งกลุ่มเป้าหมายและข้อมูลบริบทเป็น สัญญาณที่ได้จากผู้เผยแพร่โฆษณา (PPS) ในคำขอโฆษณา PPS ช่วยให้คุณใช้ข้อมูลผู้ใช้เพื่อปรับปรุงการสร้างรายได้แบบเป็นโปรแกรมได้โดยแจ้งลักษณะกลุ่มเป้าหมายให้ผู้เสนอราคาทราบในธุรกรรมทุกประเภท โดยใช้การจัดหมวดหมู่มาตรฐานโดยไม่ต้องแชร์ตัวระบุผู้ใช้ ลักษณะเฉพาะของกลุ่มเป้าหมายอาจรวมถึงข้อมูลตามพฤติกรรมและตามความสนใจ (การจัดหมวดหมู่กลุ่มเป้าหมายของ IAB 1.1) และข้อมูลบริบท (การจัดหมวดหมู่เนื้อหาของ IAB 2.2) นอกจากนี้ คุณยังส่ง Structured Signal ที่ได้จากผู้เผยแพร่โฆษณาซึ่ง Google เป็นผู้กําหนด และอนุญาตให้ส่งสัญญาณเพิ่มเติมได้ด้วย
สร้าง JSON สัญญาณของผู้ใช้
ที่ระดับบนสุด ให้สร้างออบเจ็กต์ JSON ที่มีคู่คีย์-ค่าเดียว คีย์ควรเป็น PublisherProvidedTaxonomySignals
และค่าควรเป็นอาร์เรย์ของออบเจ็กต์ ออบเจ็กต์แต่ละรายการในอาร์เรย์ควรมีคู่คีย์-ค่า 2 คู่ ดังนี้
คีย์
taxonomy
ซึ่งยอมรับค่าต่อไปนี้ที่แมปกับข้อกําหนดสาธารณะของ IABIAB_AUDIENCE_1_1
สำหรับการจัดหมวดหมู่กลุ่มเป้าหมาย 1.1IAB_CONTENT_2_2
สำหรับการจัดหมวดหมู่เนื้อหา 2.2
คีย์
values
ที่มีอาร์เรย์ของค่าการจัดหมวดหมู่สตริงที่สอดคล้องกัน
สร้างอาร์เรย์สัญญาณที่มีโครงสร้าง
สำหรับสัญญาณที่มีโครงสร้าง ให้เพิ่มคีย์ PublisherProvidedStructuredSignals
ที่มีค่าอาร์เรย์ของออบเจ็กต์ สร้างออบเจ็กต์ตามรายการคีย์-ค่าสัญญาณต่อไปนี้
สลับมุมมองของตารางสัญญาณที่มีโครงสร้าง
สัญญาณ | <code" dir="ltr" translate="no">"type" Value</code"> | ค่า "single_value" ที่เป็นไปได้ |
ค่า "values" ที่เป็นไปได้ |
---|---|---|---|
ประเภทฟีดเสียง | "audio_feed" |
|
ไม่มี |
การให้คะแนนเนื้อหา | "content_rating" |
|
ไม่มี |
การส่งเนื้อหา | "delivery" |
ไม่มี |
|
คุณภาพการผลิต | "prodq" |
|
ไม่มี |
ดูตัวอย่างต่อไปนี้ที่ใช้ 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)