Guia do vendedor e do comprador para gerar relatórios de leilão da API Protected Audience.
Este artigo é uma referência técnica para gerar relatórios sobre vitórias de leilões da API Protected Audience, conforme usado na iteração atual da API experimental.
Leia o guia para desenvolvedores para todo o ciclo de vida da API Protected Audience e consulte a explicação sobre ela para uma discussão aprofundada sobre relatórios de eventos (temporários).
Não é um desenvolvedor? Consulte a visão geral da API Protected Audience.
O que a API Protected Audience informa?
Há dois relatórios da API Protected Audience disponíveis:
- Relatório do vendedor: informa o vencedor do leilão de anúncios.
- Relatório de compradores: disponível apenas para os compradores vencedores para saber que eles venceram um leilão.
O plano de longo prazo é permitir que o navegador informe os resultados do leilão para o
vendedor e os compradores com as APIs Private Aggregate API.
Como um mecanismo temporário de relatórios no nível do evento, o código que implementa
reportResult()
para o vendedor e reportWin()
para o bidder vencedor, pode
chamar a função sendReportTo()
. Ele usa um único argumento: uma string
que representa um URL buscado após a conclusão do leilão, codificando
as informações de evento a serem informadas.
Funções da API
Vendedor: reportResult()
O JavaScript do vendedor fornecido em decisionLogicUrl
(que também fornece
scoreAd()
) pode incluir uma função reportResult()
para informar o resultado
do leilão.
reportResult(auctionConfig, browserSignals) {
...
return signalsForWinner;
}
Os argumentos passados para essa função são:
auctionConfig
O objeto de configuração do leilão transmitido para navigator.runAdAuction()
.
browserSignals
Um objeto construído pelo navegador que fornece informações sobre o leilão. Exemplo:
{
'topWindowHostname': 'publisher.example',
'interestGroupOwner': 'https://dsp.example',
'renderUrl': 'https://cdn.example/url-of-winning-creative.wbn',
'bid': <bidValue>,
'desirability': <winningAdScore>
}
O valor de retorno dessa função é usado como o argumento sellerSignals
para a função reportWin()
do bidder vencedor.
Comprador: reportWin()
O JavaScript do bidder vencedor, que também forneceu generateBid()
, pode
incluir uma função reportWin()
para informar o resultado do leilão.
reportWin(auctionSignals, perBuyerSignals, sellerSignals, browserSignals) {
...
}
Os argumentos passados para essa função são:
auctionSignals
e perBuyerSignals
Os mesmos valores do bidder vencedor são transmitidos ao generateBid()
.
sellerSignals
O valor de retorno de reportResult()
, que dá ao vendedor a
oportunidade de transmitir informações ao comprador.
browserSignals
Um objeto construído pelo navegador que fornece informações sobre o leilão. Exemplo:
{
'topWindowHostname': 'publisher.example',
'seller': 'https://ssp.example',
'interestGroupOwner': 'https://dsp.example',
'interestGroupName': 'custom-bikes',
'renderUrl': 'https://cdn.example/winning-creative.wbn',
'bid': <bidValue>
}
Implementação de relatórios temporários
Há dois métodos disponíveis temporariamente no Chrome para relatórios de leilão:
forDebuggingOnly.reportAdAuctionLoss()
forDebuggingOnly.reportAdAuctionWin()
Cada um desses métodos usa um único argumento: um URL a ser buscado após a conclusão do
leilão. Elas podem ser chamadas várias vezes, em scoreAd()
e generateBid()
, com diferentes argumentos de URL.
O Chrome só envia relatórios de perda/vitória de depuração quando um leilão é concluído. Se um leilão for cancelado (por exemplo, devido a uma nova navegação), nenhum relatório será gerado.
Esses métodos ficam disponíveis por padrão no Chrome quando você ativa todas as APIs de privacidade de anúncios em chrome://settings/adPrivacy
. Se você estiver executando
o Chrome com sinalizações de linha de comando para ativar a API Protected Audience, será necessário ativar explicitamente os métodos, incluindo a sinalização BiddingAndScoringDebugReportingAPI
. Se a sinalização não estiver ativada, os métodos ainda estarão disponíveis, mas não farão nada.
Todas as referências da API Protected Audience
Os guias de referência da API estão disponíveis:
- Guia do desenvolvedor da API Protected Audience.
- Guia do comprador de anúncios sobre grupos de interesse e geração de lances da API Protected Audience.
- Guia do vendedor de anúncios para leilões de anúncios da Protected Audience.
- Guia para gerar relatórios de resultados do leilão
- Práticas recomendadas para latência do leilão de anúncios da Protected Audience
- Resolver problemas da API Protected Audience
A explicação da API Protected Audience também fornece detalhes sobre o suporte e as restrições de recursos.
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.