Saiba como um comprador de anúncios (DSP e anunciante) que veicula uma campanha publicitária pode controlar a taxa de veiculação de anúncios com base na frequência com que o usuário viu ou interagiu com um anúncio. Controlar a veiculação de anúncios por frequência melhora a experiência do público-alvo, evitando a fadiga publicitária, e aumenta a receita, alcançando mais usuários com o mesmo orçamento. Este guia mostra várias abordagens para trabalhar com a frequência de anúncios.
Sair de um grupo de interesse
Você pode chamar navigator.leaveAdInterestGroup()
para pedir que o navegador de um usuário saia de um grupo de interesse quando um anúncio for clicado. Dentro do frame do anúncio vencedor e dos subframes, é possível chamar leaveAdInterestGroup()
desde que a origem do frame seja a mesma do grupo de interesse. Uma abordagem possível é adicionar um subframe invisível dentro do frame do anúncio, que é responsável por sair do grupo de interesse.
Sair do grupo de interesse de anúncios impede lances futuros e funciona como um limite de frequência.
Usar o indicador prevWinsMs
durante a geração de lances
Para controlar a frequência, use o campo prevWinsMs
em browserSignals
dentro de generateBid()
.
O campo prevWinMs
contém os anúncios vencedores do grupo de interesse e o tempo desde as vitórias anteriores em milissegundos. O objeto ad
aqui contém apenas os campos renderURL
e metadata
.
Use esse indicador para determinar se o anúncio deve ser veiculado. Retornar um valor de lance 0 garante que o anúncio não vai vencer o leilão.
Armazenar dados de cliques em um cookie primário
Também é possível usar um cookie primário para armazenar informações de cliques. Quando o anúncio é renderizado, substitua um grupo de interesse existente pelos dados de clique como indicadores de lances do usuário (userBiddingSignals
).
O diagrama a seguir descreve a sequência:
- O usuário visita a página do anunciante
- O comprador (anunciante/DSP) inicializa uma matriz de dados de clique no cookie primário.
- O comprador (anunciante/DSP) adiciona o usuário a um grupo de interesse e define a matriz
clicks
inicial no campouserBiddingSignals
. - Mais tarde, o usuário visita a página do editor.
- O vendedor (publisher/DSP) executa um leilão com Protected Audience, e o anúncio vencedor é renderizado para o usuário.
- O usuário clica no anúncio vencedor.
- O usuário é direcionado para a página do anunciante.
- O URL de clique contém o nome do grupo de interesse como um parâmetro de consulta.
- O comprador (anunciante/DSP) lê o cookie primário atual.
- O comprador (anunciante/DSP) adiciona o novo carimbo de data/hora do clique aos dados de clique atuais.
- O comprador (anunciante/DSP) atualiza o grupo de interesse com os novos dados de clique.
- O comprador (anunciante/DSP) atualiza o cookie primário com os novos dados de clique.
O carimbo de data/hora no campo click
de userBiddingSignals
fica disponível na função generateBid()
quando o usuário visita a página do publisher novamente, e o comprador pode usar esses dados para controlar a veiculação de anúncios.
What's next?
We want to engage in conversations with you to ensure we build an API that works for everyone.
Discuss the API
Like other Privacy Sandbox APIs, this API is documented and discussed publicly.
Experiment with the API
You can experiment and participate in conversation about the Protected Audience API.