利用 PPS 改进广告系列
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
您可以在广告请求中以发布商提供的信号 (PPS) 的形式发送受众群体和情境数据。借助 PPS,您可以通过使用标准类目将您的受众群体特征传达给所有交易类型的出价方,从而利用用户数据提高程序化变现能力,而无需分享用户标识符。受众群体特征可能包括行为数据和兴趣数据(IAB 受众群体类目 1.1),以及情境数据(IAB 内容类目 2.2)。您还可以发送由 Google 定义的发布商提供的结构化信号,并允许发送其他信号。
构建用户信号 JSON
在顶级,创建一个包含单个键值对的 JSON 对象。键应为 PublisherProvidedTaxonomySignals
,其值应为对象数组。数组中的每个对象都应包含 2 个键值对:
构建结构化信号数组
对于结构化信号,请添加 PublisherProvidedStructuredSignals
键并包含对象数组的值。根据以下信号键值对列表构建对象:
切换结构化信号表的视图
信号 |
<code" dir="ltr" translate="no">"type" Value</code"> |
可能的 "single_value" 值 |
可能的 "values" 值 |
音频 Feed 类型 |
"audio_feed" |
"af_1" :音乐
"af_2" :广播
"af_3" :播客
|
不适用 |
内容分级 |
"content_rating" |
"cr_1" :G
"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
来获取分类信号,并包含结构化信号。
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"],
},
],
};
如需使用 StreamRequest
发送 PPS,请按以下步骤操作:
userSignalsJson = {
"PublisherProvidedTaxonomySignals": [{
"taxonomy": "IAB_AUDIENCE_1_1",
"values": ["1", "284"]
}]
}
userSignalsString = FormatJson(userSignalsJson)
byteArray = CreateObject("roByteArray")
byteArray.FromAsciiString(userSignalsString)
encodedSignals = byteArray.ToBase64String().EncodeUri()
' This shows adding a single parameter. More can be added with:
' streamRequest.adTagParameters = "ppsj=" + encodedSignals + "&..."
streamRequest.adTagParameters = "ppsj=" + encodedSignals
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-21。
[null,null,["最后更新时间 (UTC):2025-08-21。"],[[["\u003cp\u003ePublisher provided signals (PPS) let you share audience and contextual data to improve programmatic ad revenue, using standard IAB taxonomies like Audience Taxonomy 1.1 and Content Taxonomy 2.2.\u003c/p\u003e\n"],["\u003cp\u003ePPS uses JSON to structure signals, encompassing taxonomy signals (e.g., user demographics, interests, content categories) and structured signals (e.g., audio feed type, content rating).\u003c/p\u003e\n"],["\u003cp\u003eYou need to Base64-encode the JSON object containing the signals before including it as the \u003ccode\u003eppsj\u003c/code\u003e parameter in your ad request.\u003c/p\u003e\n"],["\u003cp\u003eThis approach enables sharing valuable data with bidders to enhance ad targeting without exposing user identifiers, thereby increasing monetization potential.\u003c/p\u003e\n"]]],["Publishers can enhance programmatic monetization by sending audience and contextual data (Publisher Provided Signals - PPS) in ad requests. This data, structured using IAB taxonomies (Audience 1.1, Content 2.2), can include user behavior and interests. Structured signals, like audio feed type and content delivery, can also be added. Data is formatted into a JSON object containing `PublisherProvidedTaxonomySignals` and `PublisherProvidedStructuredSignals` as needed, converted to Base64, and added to the `StreamRequest.adTagParameters` as the parameter \"ppsj=\".\n"],null,["# Improve ad campaigns with PPS\n\nYou can send audience and contextual data as\n[publisher provided signals](//support.google.com/admanager/answer/12451124)\n(PPS) in ad requests. With PPS, you can use your user data to improve\nprogrammatic monetization by communicating your audience characteristics to\nbidders in all\n[transaction types](//support.google.com/admanager/answer/2805834), using\nstandard taxonomies, without the need to share user identifiers. Your audience\ncharacteristics can include behavioral and interest-based data (\n[IAB Audience Taxonomy 1.1](//iabtechlab.com/standards/audience-taxonomy/)), and\ncontextual data (\n[IAB Content Taxonomy 2.2](https://iabtechlab.com/standards/content-taxonomy/)).\nYou can also send publisher provided structured signals, which are defined by\nGoogle, and allow for additional signals to be sent.\n\nConstruct the user signals JSON\n-------------------------------\n\nAt the top level, create a JSON object with a single key-value pair. The key\nshould be `PublisherProvidedTaxonomySignals`, and its value should be an array\nof objects. Each object in the array should have 2 key-value pairs:\n\n- The `taxonomy` key, which accepts the following values that are mapped to\n following IAB public specifications:\n\n - `IAB_AUDIENCE_1_1` for Audience Taxonomy 1.1\n - `IAB_CONTENT_2_2` for Content Taxonomy 2.2\n- The `values` key with a corresponding array of string taxonomy values.\n\n### Construct the structured signals array\n\nFor structured signals, add the `PublisherProvidedStructuredSignals` key with a\nvalue of an array of objects. Construct the object based on the following list\nof signal key-values: \n\n#### Toggle view of structured signals table\n\n| Signal | \"type\" Value | Possible `\"single_value\"` Values | Possible `\"values\"` Values |\n|--------------------|--------------------|-------------------------------------------------------------------------------------------|--------------------------------------------------------------------|\n| Audio Feed Type | `\"audio_feed\"` | - `\"af_1\"`: Music - `\"af_2\"`: Broadcast - `\"af_3\"`: Podcast | n/a |\n| Content Rating | `\"content_rating\"` | - `\"cr_1\"`: G - `\"cr_2\"`: PG - `\"cr_3\"`: T - `\"cr_4\"`: MA | n/a |\n| Content Delivery | `\"delivery\"` | n/a | - `\"cd_1\"`: Streaming - `\"cd_2\"`: Progressive - `\"cd_3\"`: Download |\n| Production Quality | `\"prodq\"` | - `\"pq_1\"`: Professionally Produced - `\"pq_2\"`: Prosumer - `\"pq_3\"`: User Generated (UGC) | n/a |\n\nSee the following example that uses the `IAB_AUDIENCE_1_1` and `IAB_CONTENT_2_2`\nfor taxonomy signals and includes structured signals. \n\n const userSignals = {\n \"PublisherProvidedTaxonomySignals\": [{\n \"taxonomy\": \"IAB_AUDIENCE_1_1\",\n \"values\": [\"6\", \"284\"]\n // '6' = 'Demographic | Age Range | 30-34'\n // '284' = 'Interest | Business and Finance | Mergers and Acquisitions'\n },\n {\n \"taxonomy\": \"IAB_CONTENT_2_2\",\n \"values\": [\"49\", \"138\"]\n // '49' = 'Books and Literature | Poetry'\n // '138' = 'Education | College Education | College Planning'\n }],\n \"PublisherProvidedStructuredSignals\": [{\n \"type\": \"audio_feed\",\n \"single_value\": \"af_1\",\n },\n {\n \"type\": \"delivery\",\n \"values\": [\"cd_1\", \"cd_3\"],\n },\n ],\n };\n\nConfigure your stream request\n-----------------------------\n\nFollow these steps to send PPS with your\n[`StreamRequest`](/interactive-media-ads/docs/sdks/roku/dai/apis#ima.StreamRequest):\n\n- Create a JSON object with the user's interest, behavior, or contextual data.\n- Create a Base64-encoded ASCII string from the JSON object above.\n- Add your encoded string using [`StreamRequest.adTagParameters`](/interactive-media-ads/docs/sdks/roku/dai/apis#ima.StreamRequest.adTagParameters).\n\n userSignalsJson = {\n \"PublisherProvidedTaxonomySignals\": [{\n \"taxonomy\": \"IAB_AUDIENCE_1_1\",\n \"values\": [\"1\", \"284\"]\n }]\n }\n\n userSignalsString = FormatJson(userSignalsJson)\n byteArray = CreateObject(\"roByteArray\")\n byteArray.FromAsciiString(userSignalsString)\n encodedSignals = byteArray.ToBase64String().EncodeUri()\n\n ' This shows adding a single parameter. More can be added with:\n ' streamRequest.adTagParameters = \"ppsj=\" + encodedSignals + \"&...\"\n streamRequest.adTagParameters = \"ppsj=\" + encodedSignals"]]