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
IMAAdsRequest
:
- Crie uma string JSON com os dados de interesse, comportamento ou contexto do usuário.
- Crie uma string ASCII codificada em Base64 com base na string JSON acima.
- Anexe a string codificada ao URL da tag de anúncio com o parâmetro
&ppsj=
.
let userSignals = """
{
"PublisherProvidedTaxonomySignals": [
{
"taxonomy": "IAB_AUDIENCE_1_1",
"values": [
"1",
"284"
]
}
],
}
"""
let base64Signals = Data(userSignals.utf8).base64EncodedString()
var encodedSignals = base64Signals.replacingOccurrences(of: "+", with: "%2B")
encodedSignals = encodedSignals.replacingOccurrences(of: "/", with: "%2F")
encodedSignals = encodedSignals.replacingOccurrences(of: "=", with: "%3D")
let 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 in ad requests to boost programmatic ad revenue.\u003c/p\u003e\n"],["\u003cp\u003ePPS uses standard taxonomies like IAB Audience Taxonomy 1.1 and IAB Content Taxonomy 2.2 to convey user characteristics to bidders without revealing personal information.\u003c/p\u003e\n"],["\u003cp\u003eYou can send structured signals, including details about audio feed type, content rating, delivery method, and production quality, using predefined keys and values.\u003c/p\u003e\n"],["\u003cp\u003eTo use PPS, construct a JSON object containing taxonomy and structured signals, encode it in Base64, and append it to your ad tag URL using the \u003ccode\u003e&ppsj=\u003c/code\u003e parameter.\u003c/p\u003e\n"]]],[],null,["You 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\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\nConstruct 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\nToggle 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\nFollow these steps to send PPS with your\n[`IMAAdsRequest`](/interactive-media-ads/docs/sdks/tvos/client-side/reference/Classes/IMAAdsRequest):\n\n- Create a JSON string with the user's interest, behavior, or contextual data.\n- Create a Base64-encoded ASCII string from the JSON string above.\n- Append the encoded string to your ad tag URL with the `&ppsj=` parameter.\n\n let userSignals = \"\"\"\n {\n \"PublisherProvidedTaxonomySignals\": [\n {\n \"taxonomy\": \"IAB_AUDIENCE_1_1\",\n \"values\": [\n \"1\",\n \"284\"\n ]\n }\n ],\n }\n \"\"\"\n let base64Signals = Data(userSignals.utf8).base64EncodedString()\n var encodedSignals = base64Signals.replacingOccurrences(of: \"+\", with: \"%2B\")\n encodedSignals = encodedSignals.replacingOccurrences(of: \"/\", with: \"%2F\")\n encodedSignals = encodedSignals.replacingOccurrences(of: \"=\", with: \"%3D\")\n\n\n let finalAdTag = sampleAdTag + \"&ppsj=\" + encodedSignals"]]