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 chamar várias empresas (por exemplo, servidores de anúncios do editor e plataformas de fornecimento e 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 para um espaço de anúncio de várias origens 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, confira os conceitos básicos da API Protected Audience na página de destino e nos lances de cabeçalho na documentação do Prebid.js.

Definições

Leilões

Leilão	Definição
Leilão contextual	Um leilão de anúncios que usa os dados disponíveis no contexto do leilão. Um leilão contextual pode ter vários leilões, como lances de cabeçalho e leilões do lado do servidor.
leilão com Protected Audience	Um leilão de anúncios que envolve dar lances em um grupo de interesse criado em outro site.
Leilão de vários vendedores da API Protected Audience	É um leilão de público-alvo protegido de dois níveis que envolve vários leilões de componentes paralelos e, em seguida, envia 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 final de anúncios em um leilão de vários vendedores com Protected Audience que define a pontuação para os 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 realiza os leilões de componentes em paralelo. Os anúncios com a melhor pontuação de cada leilão de componentes passam para o leilão de nível superior.
Configuração de leilão sequencial	Uma configuração de leilão de anúncios que integra leilões contextuais a um leilão com Protected Audience e determina o vencedor entre os dois leilões.

Participantes

Participante	Definição
Advertiser	A parte que busca um posicionamento do anúncio e cria o criativo do anúncio.
Editor	É a parte que fornece inventário de anúncios para o leilão.
Negociante	A parte que dá lances em um leilão para comprar o espaço de anúncio 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 a serem renderizados no site. Um servidor de anúncios do editor pode combinar os próprios resultados de leilão, respostas do bidder de cabeçalho, inventário de venda direta e muito mais para determinar o anúncio que vai gerar mais receita para o 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 publicitário do editor aos compradores. Geralmente é uma plataforma de fornecimento (SSP, na sigla em inglês).

Configuração de leilão sequencial

Em uma configuração de leilão sequencial, os leilões contextuais são realizados primeiro e, em seguida, o leilã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 também realizando um leilão com dados de vários sites em um ambiente seguro para proteger os usuários privacidade.

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. Depois, 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 leilão do componente abaixo do mínimo, atribuindo a ele uma pontuação zero quando a pontuação de atratividade é calculada. Se nenhum lance do leilão do componente Protected Audience estiver acima do 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 Protected Audience será renderizado para o usuário.

Observação: a configuração neste documento descreve uma possível abordagem para integrar a API Protected Audience aos mecanismos de veiculação de anúncios atuais, mas essa não é a única maneira. Neste documento, descrevemos 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 executados na página em ordem: 1) leilão contextual pela biblioteca de lances de cabeçalho, 2) leilão contextual pelo servidor de anúncios do editor e 3) leilão com Protected Audience.

Visão geral do leilão de vários vendedores da Protected Audience com 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 acessar a página do editor em outro momento, o Prebid.js vai fazer 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 configurações de leilão de componentes para serem usadas no leilão da Protected Audience subsequente. O Prebid.js fornece um módulo para propagar esses indicadores e configurações para o leilão da Protected Audience.
3. As respostas de lances 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 do lance ajustado do vencedor do leilão contextual, junto com os indicadores do comprador (perBuyerSignals) e as configurações de leilão do componente do vendedor coletadas 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.
6. O leilão de vários vendedores da 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 de cada lance vencedor do leilão de componentes 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 de leilão contextual, o vendedor de nível superior vai retornar a pontuação de atratividade 0. Se todos os lances tiverem o 0 pontuado, a chamada runAdAuction() retornará null, o que significa que o anúncio contextual vencedor do leilão deve ser renderizado.
7. A biblioteca do lado do cliente do servidor de anúncios do editor renderiza o anúncio contextual ou com Protected Audience vencedor com base no que foi retornado da chamada runAdAuction().
8. O anúncio vencedor é renderizado para o usuário.

Pré-leilão

Sequência de tempo do grupo de interesse na página de um anunciante.

Antes do leilão, quando o usuário visita uma página do anunciante, o comprador e o anunciante podem definir o grupo de interesse do site a que o usuário pertence e adicionar dados contextuais do site do anunciante, além de dados próprios que serão usados como indicadores para o leilão posteriormente.

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

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

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

Em uma configuração de leilão sequencial, todos os leilões contextuais são feitos antes da execução do leilão da Protected Audience. Na configuração explicada neste documento, o Prebid.js faz um leilão contextual de lances de cabeçalho, 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 sinalização para ressaltar que um leilão com Protected Audience vai ser executado depois. Em seguida, o Prebid.js coleta 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 da resposta do lance, os compradores e vendedores têm a oportunidade de fornecer configurações de leilão dos componentes e indicadores (perBuyerSignals) que vão ser usados no leilão da API Protected Audience depois, se quiserem participar. Essa configuração de leilão do componente vai ser transmitida ao leilão subsequente da API Protected Audience.

1. Inicialização do leilão contextual: 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(executado em paralelo com o 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 do componente 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.
9. Leilão contextual do vendedor B (executado em paralelo com o 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 do 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 do componente 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.
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 dos componentes com os os indicadores são compartilhados com a biblioteca do lado do cliente do servidor de anúncios do editor
16. O servidor de anúncios do editor faz 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 com Protected Audience

Sequência no horário do leilão da API Protected Audience na página do editor.

Nessa etapa, os leilões contextuais são concluídos, e a biblioteca do lado do cliente do servidor de anúncios do editor pode transmitir o preço do lance ajustado vencedor do leilão contextual, as configurações de leilão do componente e os indicadores dos 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 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 executados em paralelo, e em cada leilão de componente, o navegador gera lances com base na lógica de lances de cada comprador participante, pontua cada lance usando a lógica de pontuação do vendedor do componente e retorna o anúncio com a maior pontuação para o 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 oferece preços de lances de leilão contextuais e configurações de leilão de componentes com indicadores dos compradores para o vendedor de nível superior. O preço do lance de 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 fica disponível na função scoreAd() do vendedor de nível superior.
3. O vendedor de nível superior inicia o leilão da API Protected Audience chamando runAdAuction().
4. Leilão de componentes do vendedor A (executado em paralelo com o leilão de componentes do vendedor B). O navegador lê os grupos de interesse do usuário de todos os compradores que participam do leilão de componentes do vendedor A.
5. O navegador busca os scripts e indicadores de lances confiáveis dos locais especificados nos grupos de interesse dos compradores que participam do leilão do componente.
6. O navegador gera os lances executando a lógica de geração de lances 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 maior pontuação enviada pela lógica de pontuação do vendedor A.
10. Leilão do componente do vendedor B (executado em paralelo com o leilão do componente do vendedor A). O navegador lê os grupos de interesse do usuário de todos os compradores que participam do leilão de componentes do vendedor B.
11. O navegador busca os scripts e indicadores de lances confiáveis dos locais especificados nos grupos de interesse dos compradores que participam do leilão do componente.
12. O navegador gera os lances executando a lógica de geração de lances 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 maior pontuação 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 em cada anúncio vencedor do leilão do componente. Na função scoreAd() do vendedor de nível superior, o preço do lance ajustado ao leilão contextual pode estar disponível como sellerSignals, e a lógica de pontuação pode comparar esse preço 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() vai poder retornar uma pontuação de desejabilidade de 0. Se não houver anúncios com pontuação de atratividade 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() vai retornar 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 com Protected Audience poderá ser renderizado em um frame isolado ou em um iframe.

1. Pontuação de anúncios de leilão de nível superior: o navegador busca o script de pontuação do vendedor principal, além de 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 vai calcular a pontuação de atratividade, 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 atratividade enviada pela lógica de pontuação do vendedor de nível superior.
4. Se o leilão da Protected Audience vencer, ele vai retornar um objeto FencedFrameConfig ou um URN opaco para a 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 delimitado para o objeto FencedFrameConfig ou o atributo src do iframe como o URN opaco do anúncio vencedor da API Protected Audience.
6. O navegador busca o anúncio vencedor do leilão com 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 retornará null.
9. O navegador define o atributo src do iframe para o anúncio contextual vencedor.
10. O navegador busca o anúncio vencedor do leilão contextual 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.