Melhorar as campanhas publicitárias com PPS
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
É possível enviar dados contextuais e de público-alvo como
indicadores fornecidos pelo editor
(PPS) nas solicitações de anúncios. Com o PPS, você pode usar os dados do usuário para melhorar a monetização programática ao comunicar as características do público-alvo aos licitantes em todos os tipos de transação usando taxonomias padrão, sem precisar compartilhar identificadores de usuário. As características do seu público-alvo podem incluir dados comportamentais e baseados em interesses (Taxonomia de público-alvo 1.1 do IAB) e dados contextuais (Taxonomia de conteúdo 2.2 do IAB).
Também é possível enviar indicadores estruturados fornecidos pelo editor, que são definidos pelo Google e permitem o envio de indicadores adicionais.
Criar o JSON de indicadores do usuário
No nível superior, crie um objeto JSON com um único par de chave-valor. A chave
precisa ser PublisherProvidedTaxonomySignals
, e o valor precisa ser uma matriz
de objetos. Cada objeto na matriz precisa ter dois pares de chave-valor:
A chave taxonomy
, que aceita os seguintes valores mapeados para
as seguintes especificações públicas do IAB:
IAB_AUDIENCE_1_1
para a Taxonomia de público-alvo 1.1
IAB_CONTENT_2_2
para a Taxonomia de conteúdo 2.2
A chave values
com uma matriz correspondente de valores de taxonomia de string.
Criar a matriz de indicadores estruturados
Para indicadores estruturados, adicione a chave PublisherProvidedStructuredSignals
com um
valor de uma matriz de objetos. Crie o objeto com base na seguinte lista
de valores-chave de indicador:
Alternar a visualização da tabela de indicadores estruturados
Indicador |
<code" dir="ltr" translate="no">"type" Valor</code"> |
Valores possíveis de "single_value" |
Valores possíveis de "values" |
Tipo de feed de áudio |
"audio_feed" |
"af_1" : música
"af_2" : transmissão
"af_3" : Podcast
|
N/A |
Classificação do conteúdo |
"content_rating" |
"cr_1" : G
"cr_2" : PG
"cr_3" : T
"cr_4" : MA
|
N/A |
Entrega de conteúdo |
"delivery" |
N/A |
"cd_1" : streaming
"cd_2" : progressivo
"cd_3" : download
|
Qualidade da produção |
"prodq" |
"pq_1" : Produzido profissionalmente
"pq_2" : prosumidor
"pq_3" : conteúdo gerado pelo usuário (UGC)
|
N/A |
Confira o exemplo a seguir que usa IAB_AUDIENCE_1_1
e IAB_CONTENT_2_2
para indicadores de taxonomia e inclui indicadores estruturados.
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"],
},
],
};
Siga estas etapas para enviar PPS com seu
AdsRequest
:
- Crie um objeto JSON com os dados de interesse, comportamento ou contexto do usuário.
- Crie uma string ASCII codificada em Base64 usando o objeto JSON acima.
- Anexe a string codificada ao URL da tag de anúncio com o parâmetro
&ppsj=
.
const userSignals = {
"PublisherProvidedTaxonomySignals": [{
"taxonomy": "IAB_AUDIENCE_1_1",
"values": ["1", "284"]
}]
};
const sampleAdTag = "https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/single_ad_samples&sz=640x480&cust_params=sample_ct%3Dlinear&ciu_szs=300x250%2C728x90&gdfp_req=1&output=vast&unviewed_position_start=1&env=vp"
const encodedSignals = encodeURIComponent(window.btoa(JSON.stringify(userSignals)));
const finalAdTag = sampleAdTag + "&ppsj=" + encodedSignals;
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-31 UTC.
[null,null,["Última atualização 2025-08-31 UTC."],[[["\u003cp\u003ePublisher provided signals (PPS) let you share audience and contextual data with bidders to improve programmatic ad monetization using IAB taxonomies.\u003c/p\u003e\n"],["\u003cp\u003ePPS uses standard IAB taxonomies like Audience Taxonomy 1.1 and Content Taxonomy 2.2 to represent user characteristics without sharing identifiers.\u003c/p\u003e\n"],["\u003cp\u003eYou construct a JSON object with \u003ccode\u003ePublisherProvidedTaxonomySignals\u003c/code\u003e and \u003ccode\u003ePublisherProvidedStructuredSignals\u003c/code\u003e keys to send user signals.\u003c/p\u003e\n"],["\u003cp\u003eThese signals are then Base64 encoded and added to your ad tag URL using the \u003ccode\u003e&ppsj=\u003c/code\u003e parameter to include them in ad requests.\u003c/p\u003e\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 ad request\n-------------------------\n\nFollow these steps to send PPS with your\n[`AdsRequest`](/interactive-media-ads/docs/sdks/html5/client-side/reference/js/google.ima.AdsRequest):\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- Append the encoded string to your ad tag URL with the `&ppsj=` parameter.\n\n const userSignals = {\n \"PublisherProvidedTaxonomySignals\": [{\n \"taxonomy\": \"IAB_AUDIENCE_1_1\",\n \"values\": [\"1\", \"284\"]\n }]\n };\n\n const sampleAdTag = \"https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/single_ad_samples&sz=640x480&cust_params=sample_ct%3Dlinear&ciu_szs=300x250%2C728x90&gdfp_req=1&output=vast&unviewed_position_start=1&env=vp\"\n\n const encodedSignals = encodeURIComponent(window.btoa(JSON.stringify(userSignals)));\n\n const finalAdTag = sampleAdTag + \"&ppsj=\" + encodedSignals;"]]