Fazer um leilão no navegador com 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, plataformas de fornecimento e de demanda) para determinar o melhor anúncio para um determinado slot na página. A API Protected Audience pode ser usada para realizar um leilão com dados entre sites, com vários vendedores, cada um realizando um leilão próprio.

Antes de começar, aprenda a realizar um leilão da Protected Audience com um único vendedor.

Definições

Confira nas tabelas a seguir 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 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.

Participantes

Participant	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).
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).

Configurar um leilão de vários vendedores

A configuração de um leilão de vários vendedores segue as mesmas etapas da configuração de um único leilão de vendedor com uma diferença principal. Para acionar os leilões de componentes, o vendedor de nível superior precisará incluir a lista de auctionConfigs para cada vendedor no campo componentAuctions do auctionConfig. Esses auctionConfigs têm o mesmo formato que se estivessem sendo executados como um único leilão de vendedor, embora possam não incluir componentAuctions. Só pode haver um leilão de nível superior em qualquer leilão da API Protected Audience. Além disso, quando componentAuctions não estiver vazio, interestGroupBuyers precisará estar vazio.

Leilão de vários vendedores da Protected Audience

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

Os leilões de componentes são realizados em paralelo e, em cada leilão de componente, o navegador gera lances usando a 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. O leilão de cada vendedor de componente pode retornar no máximo um candidato a anúncio para o leilão de nível superior. O fluxo de leilão pode ser descrito como:

1. O site do editor carrega o script do vendedor de nível superior.
2. A biblioteca do lado do cliente do vendedor de nível superior fornece configurações de leilão de componentes com indicadores de compradores para o vendedor 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 nos 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 nos 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 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 pontuação mais alta enviada pela lógica de pontuação do vendedor B.

Após a conclusão dos leilões de componentes, o navegador tem uma lista de anúncios que podem ser enviados à lógica de pontuação do vendedor de nível superior.

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.

1. O navegador busca o script de pontuação do vendedor de nível superior com os 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. 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. O leilão da Protected Audience retorna um objeto FencedFrameConfig ou um URN opaco para a biblioteca de nível superior do cliente do vendedor.
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 URL opaco do anúncio da 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.