Indicadores fornecidos pelo editor

É possível enviar dados contextuais e de público-alvo como indicadores fornecidos pelo editor (PPS) nas solicitações de anúncio. 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 permitir o envio de outros indicadores.

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 de acordo com 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 o valor de uma matriz de objetos. Crie o objeto com base na seguinte lista de valores-chave de indicador:

Alternar visualização da tabela de indicadores estruturados

Indicador <code" dir="ltr" translate="no">Valor "type"</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": fazer o 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"],
    },
  ],
};

Configurar a solicitação de anúncio

Siga estas etapas para enviar PPS com seu AdsRequest:

  • Crie um objeto JSON com dados contextuais, do interesse ou do comportamento do usuário.
  • Crie uma string ASCII codificada em Base64 com 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&impl=s"

const encodedSignals = encodeURIComponent(window.btoa(JSON.stringify(userSignals)));

const finalAdTag = sampleAdTag + "&ppsj=" + encodedSignals;