Executar um leilão baseado em navegador com vários vendedores

Os editores geralmente diversificam as origens de demanda de anúncios para otimizar a receita e invocam várias empresas (por exemplo, plataformas de fornecimento e de demanda) para determinar o melhor anúncio para um determinado espaço na página. A Protected Audience pode ser usada para realizar um leilão com dados de vários sites com vários vendedores que executam o próprio leilão.

Antes de começar, saiba como realizar um leilão de público-alvo protegido com um único vendedor.

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, em seguida, enviam o anúncio com a maior 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 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).
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).

Configurar um leilão de vários vendedores

A configuração de um leilão de vários vendedores segue em grande parte as mesmas etapas de um leilão de um único vendedor, com uma diferença importante. Para acionar os leilões de componentes, o vendedor de nível superior precisa incluir a lista de auctionConfigs de cada vendedor no campo componentAuctions do auctionConfig. Esses auctionConfigs têm o mesmo formato de um leilão de um único vendedor, mas não incluem 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 está vazio, interestGroupBuyers precisa estar vazio.

Leilão de vários vendedores com Protected Audience

Os leilões de componentes são executados em paralelo. Em cada leilão de componentes, o navegador gera lances com base na lógica de lances de cada comprador que participa desse leilão, pontua cada lance usando a lógica de pontuação do vendedor do componente e retorna o anúncio com a pontuação mais alta para o leilão de nível superior. Cada leilão de vendedores de componentes pode retornar no máximo um candidato de anúncio para o leilão de nível superior. O fluxo do 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 dos compradores para o 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 (realizado 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 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 de componentes do Vendedor B (realizado 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 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.

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

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

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 componentes.

1. O navegador busca o script de pontuação do vendedor de nível superior com 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 atratividade, provavelmente com base no preço de lance da API 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. O leilão da Protected Audience retorna um objeto FencedFrameConfig ou um URN opaco para a biblioteca do lado do cliente do vendedor de nível superior.
5. A biblioteca do lado do cliente define o atributo config do frame cercado como o objeto FencedFrameConfig ou define o atributo src do iframe como o URN opaco do anúncio vencedor da Protected Audience.
6. O navegador busca o anúncio vencedor do leilão da API Protected Audience do comprador.
7. O navegador renderiza o anúncio para o usuário.