Configuração de leilão sequencial com lances de cabeçalho e leilão de Protected Audience de vários vendedores

Os editores normalmente diversificam as origens de demanda de anúncios para otimizar a receita e invocar várias empresas (por exemplo, servidores de anúncios do editor, plataformas de fornecimento e plataformas de demanda) para determinar o melhor anúncio para um determinado espaço na página. Com os lances de cabeçalho, os editores podem capturar lances de várias origens de demanda para um espaço de anúncio. 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 para realizar um leilão com dados entre sites.

Antes de começar, aprenda sobre os conceitos básicos da API na página Protected Audience e os lances de cabeçalho na documentação do Prebid.js.

Definições

Leilões

Leilão	Definição
Leilão contextual	Leilão de anúncios que usa os dados disponíveis no contexto de onde o leilão é realizado. Pode haver vários leilões em um leilão contextual, como lances de cabeçalho e leilões do lado do servidor.
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 da API Protected Audience	Um leilão de duas camadas da Protected Audience, que primeiro envolve vários leilões de componentes paralelos que enviam o anúncio com a maior pontuação ao 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 Protected Audience que oferece a pontuação dos vencedores dos componentes dos leilões.
Leilão de componentes	É um leilão aninhado em um leilão de vários vendedores da Protected Audience, em que cada vendedor de componente realiza leilões de componentes em paralelo. Os anúncios com a melhor pontuação de cada leilão de componentes são passados para o leilão de nível superior.
Configuração do leilão sequencial	Uma configuração de leilão de anúncios que integra leilões de contexto a um leilão da Protected Audience e determina um vencedor entre os dois leilões.

Participantes

Participante	Definição
Advertiser	A parte que deseja um posicionamento de anúncio e constrói o anúncio.
Editor	É a parte que fornece o inventário de anúncios para o leilão.
Negociante	A parte que faz um lance em um leilão para comprar o espaço publicitário de um vendedor. Em geral, é 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 seus próprios resultados de leilão, respostas do proponente de cabeçalho, inventário de venda direta e muito mais, para determinar o anúncio que 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 API Protected Audience e participa do leilão de nível superior.
Vendedor do componente	É a parte que faz um leilão de componentes no leilão de vários vendedores da Protected Audience para vender o espaço publicitário do editor aos compradores. Em geral, é uma plataforma de fornecimento (SSP, na sigla em inglês).

Configuração do leilão sequencial

Em uma configuração de leilão sequencial, os leilões contextuais são executados primeiro e, depois, o da Protected Audience. Essa configuração permite que os editores maximizem o potencial de ganhos realizando um leilão com os dados contextuais disponíveis na página e realizando um leilão com dados de vários 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 do lance de leilão do componente abaixo do lance mínimo, atribuindo uma pontuação zero quando a pontuação de desejabilidade é 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 vai 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 API Protected Audience vai ser renderizado para o usuário.

Observação:a configuração neste documento descreve uma possível abordagem para integrar a API Protected Audience com os mecanismos de veiculação de anúncios atuais, mas não é a única maneira. Este documento descreve como uma das bibliotecas de lances de cabeçalho, Prebid.js, foi integrada à Protected Audience.

Neste exemplo de configuração de leilão sequencial, três leilões principais podem ser realizados na página em ordem: 1) leilão contextual por biblioteca de lances de cabeçalho, 2) leilão contextual pelo servidor de anúncios do editor e 3) leilão da Protected Audience.

Visão geral do leilão de vários vendedores da Protected Audience com o leilão contextual de lances de cabeçalho.

Descrição detalhada do diagrama de visão geral:

1. Antes do leilão, o usuário é adicionado a um grupo de interesse no site de um anunciante.
2. Quando o usuário acessa a página do editor mais tarde, o Prebid.js realiza 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 definir configurações de leilão de componentes para serem usadas no próximo leilão da Protected Audience. O Prebid.js oferece um módulo que propaga esses sinais e configurações para o leilão da Protected Audience.
3. 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.
4. O servidor de anúncios do editor pode combinar seus próprios resultados de leilão, de lances de cabeçalho, inventário de venda direta e muito mais, para determinar o anúncio que gerará mais receita para um editor. O anúncio vencedor é retornado à biblioteca do lado do cliente do servidor de anúncios do editor.
5. O preço ajustado do lance do vencedor do leilão contextual, os indicadores do comprador (perBuyerSignals) e as configurações de leilão de componentes do vendedor coletados pelo Prebid.js podem ser transmitidos ao leilão da Protected Audience pela biblioteca do lado do cliente do servidor de anúncios do editor.
6. O leilão de vários vendedores da API Protected Audience é realizado 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 do leilão de cada componente 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 desejabilidade de 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 precisa ser renderizado.
7. A biblioteca do lado do cliente do servidor de anúncios do editor renderiza o anúncio de público-alvo protegido ou contextual vencedor com base no que foi retornado da chamada runAdAuction().
8. O anúncio vencedor é renderizado para o usuário.

Antes do leilão

Sequência de tempo do grupo de interesse em uma página de anunciante.

Antes do leilão, quando o usuário acessa a página de um anunciante, o comprador e o anunciante podem definir o grupo de interesse do site a que ele pertence e adicionar dados de contexto do site do anunciante e dados próprios para serem usados como indicadores para o leilão posteriormente.

1. O usuário navega para o site do anunciante.
2. O site do anunciante carrega o script de cada comprador que participa do leilão posteriormente.
3. O script do comprador contém a chamada joinAdInterestGroup() para adicionar o usuário ao grupo de interesse dele.

Leilões contextuais com o Prebid.js e o servidor de anúncios do editor

Sequência contextual de tempo do leilão na página do editor.

Em uma configuração de leilão sequencial, todos os leilões contextuais são realizados antes do leilão da Protected Audience. Na configuração explicada neste documento, realizamos 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.

Primeiro, o editor inicia um leilão contextual de lances de cabeçalho chamando o Prebid.js com uma flag para lembrar que um leilão da API Protected Audience vai ser realizado depois. Em seguida, o Prebid.js coleta as respostas de lance e as envia ao servidor de anúncios do editor para realizar um leilão contextual do lado do servidor. Durante a etapa de coleta da resposta do lance, os compradores e vendedores podem fornecer configurações de leilão de componentes e indicadores dos compradores (perBuyerSignals) para serem usados no próximo leilão da API Protected Audience, se quiserem participar. Essa configuração de leilão de componente vai ser transmitida para o leilão subsequente da API Protected Audience.

1. Inicialização contextual do leilão
   O usuário acessa a página do editor.
2. 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úncio.
3. A página do editor carrega o Prebid e inicia o leilão contextual de lances de cabeçalho.
4. Leilão contextual do vendedor A
   (em paralelo ao leilão contextual do vendedor B)
   O Prebid.js envia uma solicitação de lance para o vendedor A.
5. O vendedor A recupera as respostas de lance e o perBuyerSignals dos compradores.
6. O vendedor A realiza um leilão contextual.
7. O vendedor A cria a configuração de leilão de componentes com perBuyerSignals incluído.
8. O vendedor A responde ao Prebid.js com o lance vencedor e a configuração de leilão do componente dele.
9. Leilão contextual do vendedor B
   (em paralelo ao leilão contextual do vendedor A)
   O Prebid.js envia uma solicitação de lance para o vendedor B.
10. O vendedor B recupera as respostas de lance e o perBuyerSignals dos compradores.
11. O vendedor B realiza um leilão contextual.
12. O vendedor B cria a configuração de leilão de componentes com perBuyerSignals incluído.
13. O vendedor B responde ao Prebid.js com o lance vencedor e a configuração de leilão do componente dele.
14. 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.
15. As configurações de leilão de componentes com os indicadores dos compradores são compartilhadas com a biblioteca do lado do cliente do servidor de anúncios do editor.
16. O servidor de anúncios do editor realiza um leilão contextual para determinar o melhor anúncio entre campanhas de venda direta, lances programáticos, lances contextuais do Prebid e outros inventários.
17. O servidor de anúncios do editor retorna o lance vencedor ajustado.

Leilão de vários vendedores da API Protected Audience

Sequência de tempo do leilão da Protected Audience na página do editor.

Nessa fase, 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 ajustado do lance vencedor do leilão contextual, as configurações do leilão do componente e os indicadores de compradores que participam do leilão da Protected Audience para o vendedor de nível superior. O preço do lance de leilão contextual como um preço mínimo pode ser transmitido para a configuração do leilão como um indicador para pontuação no leilão de nível superior.

Os leilões de componentes são realizados em paralelo e, em cada leilão de componente, o navegador gera lances a partir da lógica de lances de cada comprador que participa do leilão, pontua cada lance usando a lógica de pontuação do vendedor do componente e retorna o anúncio com a maior pontuação ao leilão de nível superior.

1. O site do editor carrega o script do vendedor de nível superior.
2. A biblioteca do lado do cliente do servidor de anúncios do editor fornece o preço do lance contextual do leilão, as configurações do leilão do componente com indicadores dos compradores para o vendedor de nível superior. O preço do lance do anúncio vencedor do leilão contextual pode ser transmitido para a configuração do leilão como indicadores do vendedor. Esse preço do lance é disponibilizado na função scoreAd() do vendedor de nível superior.
3. O vendedor de nível superior inicia o leilão da Protected Audience chamando runAdAuction().
4. Leilão de componentes do vendedor A
   (em paralelo ao leilão de componentes do vendedor B)
   O navegador lê os grupos de interesse do usuário para todos os compradores que participam do leilão de componentes do vendedor A.
5. O navegador busca os scripts de lances e os indicadores de lances confiáveis dos locais especificados nos grupos de interesse dos compradores que participam do leilão de componentes.
6. O navegador gera os lances executando a lógica de geração de lance de cada comprador.
7. O navegador busca o script de pontuação e os indicadores de pontuação confiáveis de cada anúncio do vendedor A.
8. O navegador executa a lógica de pontuação do vendedor A para cada lance.
9. O navegador escolhe o anúncio com a pontuação mais alta enviada pela lógica de pontuação do vendedor A.
10. Leilão de componentes do vendedor B
    (em paralelo ao leilão de componentes do vendedor A)
    O navegador lê os grupos de interesse do usuário para todos os compradores que participam do leilão de componentes do vendedor B.
11. O navegador busca os scripts de lances e os indicadores de lances confiáveis dos locais especificados nos grupos de interesse dos compradores que participam do leilão de componentes.
12. O navegador gera os lances executando a lógica de geração de lance de cada comprador.
13. O navegador busca o script de pontuação e os indicadores de pontuação confiáveis de cada anúncio do vendedor B.
14. O navegador executa a lógica de pontuação do vendedor B para cada lance.
15. O navegador escolhe o anúncio com a pontuação mais alta enviada pela lógica de pontuação do vendedor B.

Pontuação de leilão de nível superior e renderização de anúncios

Sequência de renderização de anúncios na página do editor

.

Depois que os leilões de componentes da seção anterior são executados, o navegador executa a lógica de pontuação do vendedor de nível superior no anúncio vencedor de cada leilão de componente. Na função scoreAd() do vendedor de nível superior, o preço do lance ajustado do leilão contextual pode estar disponível como sellerSignals. Além disso, a lógica de pontuação pode comparar esse preço do lance de leilão contextual com o preço do lance vencedor do leilão do componente Protected Audience.

Se o preço do lance vencedor do leilão contextual for maior que o preço do lance vencedor do leilão do componente, a função scoreAd() poderá retornar uma pontuação de desejabilidade de 0. Se não houver anúncios com uma pontuação de desejabilidade maior que 0, isso significa que o anúncio vencedor do leilão contextual é mais valioso do que qualquer um dos anúncios vencedores do leilão do componente, e a função runAdAuction() retorna null.

Se o leilão da Protected Audience não tiver um vencedor e retornar null, a biblioteca do lado do cliente do servidor de anúncios do editor poderá renderizar o vencedor do leilão contextual em um iframe. Se o leilão da Protected Audience vencer o leilão contextual e retornar um objeto FencedFrameConfig ou um URN opaco, o anúncio vencedor do leilão da API Protected Audience vai poder ser renderizado em um frame isolado ou em um iframe.

1. Pontuação do anúncio de leilão de nível superior
   O navegador busca o script de pontuação do vendedor de nível superior, além dos indicadores de pontuação confiáveis de cada anúncio.
2. 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 como sellerSignals 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 Protected Audience e retornar uma pontuação de desejabilidade de 0 se o preço contextual for maior. Caso contrário, o script calcula a pontuação de desejabilidade, provavelmente com base no preço do lance do componente Protected Audience.
3. O navegador escolhe o anúncio com a maior pontuação de desejabilidade enviada pela lógica de pontuação do vendedor de nível superior.
4. Se o leilão da Protected Audience vencer
   O leilão da Protected Audience vai retornar um objeto FencedFrameConfig ou um URN opaco à biblioteca do lado do cliente do servidor de anúncios do editor.
5. A biblioteca do lado do cliente define o atributo config do frame isolado como o objeto FencedFrameConfig ou define o atributo src do iframe como o URN opaco do anúncio da API Protected Audience vencedor.
6. O navegador busca o anúncio vencedor do leilão da Protected Audience do comprador.
7. O navegador renderiza o anúncio para o usuário.
8. Se o leilão contextual vencer
   O leilão da Protected Audience vai retornar null.
9. O navegador define o atributo src do iframe como o anúncio contextual vencedor.
10. O navegador busca o anúncio contextual vencedor do leilão do comprador.
11. O navegador renderiza o anúncio para o usuário.

Interaja e compartilhe feedback

A seguir

Queremos conversar com você para garantir a criação de uma API que funcione para todos.

Converse sobre a API

Assim como outras APIs do Sandbox de privacidade, essa API é documentada e discutida publicamente.

Teste a API

Você pode fazer testes e participar de conversas sobre a API Protected Audience.