您可以在廣告請求中,以發布商提供的信號 (PPS) 的形式傳送目標對象和比對內容資料。透過 PPS,您可以使用使用者資料,透過標準分類方式,向所有交易類型的出價方傳達目標對象特徵,藉此改善程式輔助營利,而無須分享使用者 ID。您的目標對象特性包括行為和興趣相關資料 (IAB 目標對象分類 1.1) 和比對內容資料 (IAB 內容分類 2.2)。 您也可以傳送發布商提供的結構化信號 (由 Google 定義),以便傳送其他信號。
建構使用者信號 JSON
在頂層建立 JSON 物件,其中包含單一鍵/值組合。鍵應為 PublisherProvidedTaxonomySignals
,其值應為物件的陣列。陣列中的每個物件都應包含 2 個鍵/值組合:
taxonomy
鍵,可接受下列對應至下列 IAB 公開規格的值:IAB_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
做為分類信號,並納入結構化信號。
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"],
},
],
};
設定廣告要求
請按照下列步驟,透過 AdsRequest
傳送 PPS:
- 建立包含使用者興趣、行為或情境資料的 JSON 字串。
- 使用上述 JSON 字串建立 Base64 編碼 ASCII 字串。
- 使用
&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;