É possível enviar dados contextuais e de público-alvo como indicadores fornecidos pelo editor (PPS) em 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 com base em interesses (Taxonomia de público-alvo IAB 1.1) e dados contextuais (Taxonomia de conteúdo IAB 2.2). 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 dela 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 de acordo com as seguintes especificações públicas do IAB:IAB_AUDIENCE_1_1
para a Taxonomia de público-alvo 1.1IAB_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 o
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" |
Possíveis valores de "values" |
---|---|---|---|
Tipo de feed de áudio | "audio_feed" |
|
N/A |
Classificação do conteúdo | "content_rating" |
|
N/A |
Entrega de conteúdo | "delivery" |
N/A |
|
Qualidade da produção | "prodq" |
|
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"],
},
],
};
Configurar a solicitação de anúncio
Siga estas etapas para enviar PPS com seu
AdsRequest
:
- Crie uma string JSON com os dados de interesse, comportamento ou contexto do usuário.
- Crie uma string ASCII codificada em Base64 usando a string JSON acima.
- Anexe a string codificada ao URL da tag de anúncio com o parâmetro
&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;