Os editores geralmente diversificam as origens de demanda de anúncios para otimizar a receita e invocam várias empresas (por exemplo, servidores de anúncios do editor, plataformas de fornecimento e de demanda) para determinar o melhor anúncio para um determinado espaço na página. Os lances de cabeçalho permitem que os editores capturem lances para um slot de anúncio de várias fontes de demanda. Em uma configuração de leilão sequencial, a biblioteca de lances de cabeçalho pode ser usada para realizar um leilão com dados contextuais, e a API Protected Audience é usada para realizar um leilão com dados entre sites.
Antes de começar, aprenda sobre os lances de header fundamentais na documentação do Prebid.js.
Definições
As tabelas a seguir descrevem alguns termos usados neste documento.
Leilões
Leilão | Definição |
---|---|
Leilão da API Protected Audience | Um leilão de anúncios que envolve lances em um grupo de interesse criado em outro site. |
Leilão de vários vendedores com Protected Audience | Um leilão de Protected Audience de dois níveis que envolve vários leilões de componentes paralelos que enviam o anúncio com a melhor pontuação para o leilão final de nível superior. |
Leilão de nível superior | O leilão de anúncios final em um leilão de vários vendedores da API Protected Audience que fornece a pontuação dos vencedores dos leilões de componentes. |
Leilão de componentes | Um leilão aninhado em um leilão de vários vendedores da Protected Audience em que cada vendedor de componentes executa os leilões de componentes em paralelo. Os anúncios com a maior pontuação de cada leilão de componente são transmitidos para o leilão de nível superior. |
Participantes
Participante | Definição |
---|---|
Advertiser | A parte que quer uma veiculação de anúncio e cria o criativo do anúncio. |
Editor | A parte que fornece o inventário de anúncios para o leilão. |
Negociante | A parte que dá lances em um leilão para comprar o espaço publicitário de um vendedor. Geralmente, uma plataforma de demanda (DSP). |
Servidor de anúncios do editor | Um serviço usado pelos editores para gerenciar e escolher os anúncios que serão renderizados no
site. Um servidor de anúncios do editor pode combinar os próprios resultados de leilão, as respostas de
licitantes do cabeçalho, o inventário vendido diretamente e muito mais para determinar o anúncio que
vai gerar mais receita para um editor. Um servidor de anúncios do editor pode fornecer uma biblioteca do lado do cliente para interagir com o servidor. |
Vendedor de nível superior | A parte que invoca (ou seja, cria) o leilão de vários vendedores da Protected Audience e participa do leilão de nível superior. |
Vendedor de componentes | A parte que realiza um leilão de componentes no leilão de vários vendedores da Protected Audience para vender o espaço de anúncios do editor aos compradores. Geralmente, uma plataforma de fornecimento (SSP). |
Configuração de leilão sequencial
Em uma configuração de leilão sequencial, os leilões contextuais são executados primeiro, e depois o leilão da Protected Audience. Essa configuração permite que os editores maximizem o potencial de ganhos executando um leilão com os dados contextuais disponíveis na página e também um leilão com dados entre sites em um ambiente seguro para proteger a privacidade dos usuários.
Uma biblioteca de lances de cabeçalho pode ser executada primeiro na página para coletar lances para o leilão contextual do servidor de anúncios do editor. Em seguida, o preço do lance vencedor ajustado do leilão contextual pode ser inserido no leilão da Protected Audience como um lance mínimo. Durante a etapa de pontuação, o vendedor de nível superior pode reduzir os preços dos lances de componentes abaixo do lance mínimo atribuindo a eles uma pontuação zero quando a pontuação de atratividade é calculada. Se nenhum lance de leilão do componente da API Protected Audience estiver acima do lance mínimo, o anúncio vencedor do leilão contextual será renderizado para o usuário. Se o leilão da Protected Audience retornar um vencedor, isso significa que ele está acima do lance mínimo, e o anúncio vencedor da Protected Audience será renderizado para o usuário.
Neste exemplo de configuração de leilão sequencial, três leilões principais podem ser executados na página em ordem:
- Leilão contextual pela biblioteca de lances de cabeçalho
- Leilão contextual do servidor de anúncios do editor
- Leilão da API Protected Audience.

Descrição detalhada do diagrama de visão geral:
- Antes do leilão, o usuário é adicionado a um grupo de interesse no site de um anunciante.
- Quando o usuário visita a página do editor mais tarde, o Prebid.js executa um leilão contextual para coletar as respostas de lance dos bidders de cabeçalho. Durante essa etapa, os compradores podem fornecer os indicadores, e os vendedores podem fornecer as configurações de leilão de componentes para serem usadas no leilão de público-alvo protegido seguinte. O Prebid.js oferece um module para propagar esses indicadores e configurações para o leilão da Protected Audience.
- As respostas de lance coletadas pelo Prebid.js são enviadas ao servidor de anúncios do editor para um leilão contextual do lado do servidor.
- O servidor de anúncios do editor pode combinar os próprios resultados do leilão, os resultados do lance de header, o inventário vendido diretamente e muito mais para determinar o anúncio que vai gerar mais receita para um editor. O anúncio vencedor é retornado à biblioteca do lado do cliente do servidor de anúncios do editor.
- O preço do lance ajustado do vencedor do leilão contextual, junto com os
indicadores do comprador (
perBuyerSignals
) e as configurações do leilão de componentes do vendedor coletados pelo Prebid.js, podem ser transmitidos para o leilão da Protected Audience pela biblioteca do lado do cliente do servidor de anúncios do editor. - O leilão de vários vendedores da Protected Audience é executado pelo vendedor de nível
superior. Durante a etapa de pontuação do vendedor de nível superior, ele pode
comparar o preço do lance vencedor de cada componente do leilão com o preço do lance vencedor
ajustado do leilão contextual. Se o preço do lance do componente for menor que o
preço do lance do leilão contextual, o vendedor de nível superior vai retornar a pontuação
de atratividade 0. Se todos os lances tiverem pontuação 0, a chamada
runAdAuction()
vai retornar null, o que significa que o anúncio vencedor do leilão contextual vai ser renderizado. - A biblioteca do lado do cliente do servidor de anúncios do editor renderiza o anúncio
da Protected Audience ou o anúncio contextual vencedor com base no que foi retornado da
chamada
runAdAuction()
. - O anúncio vencedor é renderizado para o usuário.
Leilões contextuais com Prebid.js e servidor de anúncios do editor

Em uma configuração de leilão sequencial, todos os leilões contextuais são executados antes do leilão da Protected Audience. Na configuração explicada neste documento, executamos um leilão contextual de lances de cabeçalho pelo Prebid.js que alimenta um leilão do lado do servidor pelo servidor de anúncios do editor.
O editor primeiro inicia um leilão contextual de lances de header chamando
Prebid.js com uma flag para indicar que um leilão da API Protected Audience será
executado depois. Em seguida, o Prebid.js coleciona as respostas de lance e as envia
ao servidor de anúncios do editor para um leilão contextual do lado do servidor. Durante a
etapa de coleta de resposta ao lance, os compradores e vendedores têm a oportunidade de
fornecer configurações de leilão de componentes e indicadores de compradores (perBuyerSignals
) para serem
usados no leilão de público protegido seguinte, se quiserem participar.
Essa configuração vai ser transmitida para o leilão do público protegido
posterior.
- Inicialização do leilão contextual: o usuário acessa a página do editor.
- A página do editor carrega a biblioteca do lado do cliente do servidor de anúncios do editor e define os espaços de anúncios.
- A página do editor carrega o Prebid e inicia o leilão contextual de lances de cabeçalho.
- Leilão de contexto do Vendedor A (veiculado em paralelo ao leilão de contexto do Vendedor B). O Prebid.js envia uma solicitação de lance para o Vendedor A.
- O vendedor A recupera as respostas de lance e os indicadores de comprador dos compradores.
- O vendedor A executa um leilão contextual.
- O vendedor A constrói a configuração do leilão do componente com
perBuyerSignals
incluído. - O vendedor A responde ao Prebid.js com o lance vencedor e a configuração do leilão do componente.
- Leilão de contexto do Vendedor B (é executado em paralelo ao leilão de contexto do Vendedor A). O Prebid.js envia uma solicitação de lance para o Vendedor B.
- O vendedor B recupera as respostas de lance e
perBuyerSignals
dos compradores. - O Vendedor B executa um leilão contextual.
- O vendedor B constrói a configuração do leilão de componentes com perBuyerSignals incluído.
- O vendedor B responde ao Prebid.js com o lance vencedor e a configuração do leilão do componente.
- Leilão contextual do servidor de anúncios do editor As respostas de lance coletadas pelo Prebid.js são enviadas ao servidor de anúncios do editor para o leilão contextual.
- As configurações de leilão de componentes com indicadores de compradores são compartilhadas com a biblioteca do lado do cliente do servidor de anúncios do editor
- O servidor de anúncios do editor realiza um leilão contextual para determinar o melhor anúncio entre campanhas vendidas diretamente, lances programáticos, lances contextuais do Prebid e outros inventários.
- O servidor de anúncios do editor retorna o lance vencedor ajustado.
Considere a demanda de anúncios contextuais com a demanda de anúncios da Protected Audience

Nesse ponto, os leilões contextuais foram concluídos, e a biblioteca do lado do cliente do servidor de anúncios do editor pode transmitir o preço do lance ajustado do vencedor do leilão contextual, as configurações do leilão de componentes e os indicadores dos compradores que estão participando do leilão do público-alvo protegido para o vendedor de nível superior. O preço do lance do leilão contextual como um piso pode ser transmitido para a configuração do leilão como um indicador para a pontuação no leilão de nível superior.
- O navegador busca o script de pontuação do vendedor com indicadores de pontuação confiáveis de cada anúncio.
- O navegador executa a lógica de pontuação do vendedor de nível superior para cada lance
vencedor de todos os leilões de componentes. No script
scoreAd()
do vendedor de nível superior, a lógica tem acesso ao preço do lance vencedor ajustado do leilão contextual que pode ter sido transmitido comosellerSignals
na configuração do leilão. O script pode comparar o preço do lance contextual vencedor com o preço do lance do componente do público-alvo protegido e retornar uma pontuação de atratividade de 0 se o preço contextual for maior. Caso contrário, o script calcula a pontuação de atratividade, provavelmente com base no preço de lance do componente da API Protected Audience. - O navegador escolhe o anúncio com a maior pontuação de atratividade enviada pela lógica de pontuação do vendedor de nível superior.
- Se o leilão da Protected Audience vencer, o leilão
vai retornar um objeto
FencedFrameConfig
ou um URN opaco para a biblioteca do lado do cliente do servidor de anúncios do editor. - A biblioteca do lado do cliente define o atributo
config
do frame cercado como o objetoFencedFrameConfig
ou define o atributosrc
do iframe como o URN opaco do anúncio vencedor da Protected Audience. - O navegador busca o anúncio vencedor do leilão da API Protected Audience do comprador.
- O navegador renderiza o anúncio para o usuário.
- Se o leilão contextual vencer, o leilão da Protected Audience vai retornar
null
. - O navegador define o atributo
src
do iframe para o anúncio contextual vencedor. - O navegador busca o anúncio vencedor do leilão contextual do comprador.
- O navegador renderiza o anúncio para o usuário.