Guía para compradores y vendedores para generar informes de subastas de la API de Protected Audience
En este artículo, se proporciona una referencia técnica para generar informes sobre las subastas ganadoras de la API de Protected Audience, tal como se usa en la iteración actual de la API experimental de Protected Audience.
Lee la guía para desarrolladores sobre el ciclo de vida completo de la API de Protected Audience y consulta la explicación de la API de Protected Audience para obtener un análisis detallado de los informes a nivel del evento (temporales).
¿No eres desarrollador? Consulta la descripción general de la API de Protected Audience.
¿Qué informa la API de Protected Audience?
Existen dos informes disponibles de la API de Protected Audience:
- Informe del vendedor: Informa al vendedor sobre el ganador de la subasta de anuncios.
- Informe del comprador: Está disponible solo para los compradores ganadores, para que sepan que ganaron una subasta.
El plan a largo plazo es permitir que el navegador informe los resultados de la subasta para el vendedor y los compradores con las APIs de Private Aggregation.
Como mecanismo temporal de informes a nivel del evento, el código que implementa reportResult() para el vendedor y reportWin() para el ofertante ganador puede llamar a la función sendReportTo(). Este método toma un solo argumento: una cadena que representa una URL que se recupera después de que finaliza la subasta y que codifica la información a nivel del evento que se debe informar.
Funciones de la API
Vendedor: reportResult()
El JavaScript del vendedor proporcionado en decisionLogicUrl (que también proporciona scoreAd()) puede incluir una función reportResult() para informar el resultado de la subasta.
reportResult(auctionConfig, browserSignals) {
...
return signalsForWinner;
}
Los argumentos que se pasan a esta función son los siguientes:
auctionConfig
Es el objeto de configuración de la subasta que se pasó a navigator.runAdAuction().
browserSignals
Es un objeto creado por el navegador que proporciona información sobre la subasta. Por ejemplo:
{
'topWindowHostname': 'publisher.example',
'interestGroupOwner': 'https://dsp.example',
'renderUrl': 'https://cdn.example/url-of-winning-creative.wbn',
'bid': <bidValue>,
'desirability': <winningAdScore>
}
El valor que devuelve esta función se usa como el argumento sellerSignals para la función reportWin() del ofertante ganador.
Comprador: reportWin()
El JavaScript del ofertante ganador (que también proporcionó generateBid()) puede incluir una función reportWin() para informar el resultado de la subasta.
reportWin(auctionSignals, perBuyerSignals, sellerSignals, browserSignals) {
...
}
Los argumentos que se pasan a esta función son los siguientes:
auctionSignals y perBuyerSignals
Son los mismos valores que se pasan a generateBid() para el mejor postor.
sellerSignals
Es el valor de devolución de reportResult(), que le brinda al vendedor la oportunidad de pasar información al comprador.
browserSignals
Es un objeto creado por el navegador que proporciona información sobre la subasta. Por ejemplo:
{
'topWindowHostname': 'publisher.example',
'seller': 'https://ssp.example',
'interestGroupOwner': 'https://dsp.example',
'interestGroupName': 'custom-bikes',
'renderUrl': 'https://cdn.example/winning-creative.wbn',
'bid': <bidValue>
}
Implementación de informes temporales
En Chrome, hay dos métodos disponibles temporalmente para generar informes de subastas:
forDebuggingOnly.reportAdAuctionLoss()forDebuggingOnly.reportAdAuctionWin()
Cada uno de estos métodos toma un solo argumento: una URL para recuperar después de que se complete la subasta. Se pueden llamar varias veces, tanto en scoreAd() como en generateBid(), con diferentes argumentos de URL.
Chrome solo envía informes de depuración de pérdidas o ganancias cuando una subasta se ejecuta hasta completarse. Si se cancela una subasta (por ejemplo, debido a una navegación nueva), no se generarán informes.
Estos métodos están disponibles de forma predeterminada en Chrome cuando habilitas todas las APIs de Ad Privacy en chrome://settings/adPrivacy. Si ejecutas Chrome con marcas de línea de comandos para habilitar la API de Protected Audience, deberás habilitar los métodos de forma explícita incluyendo la marca BiddingAndScoringDebugReportingAPI. Si la marca no está habilitada, los métodos seguirán disponibles, pero no harán nada.
Todas las referencias de la API de Protected Audience
Las guías de referencia de la API están disponibles:
- Guía para desarrolladores sobre la API de Protected Audience
- Guía para compradores de anuncios sobre los grupos de interés y la generación de ofertas de Protected Audience.
- Guía para vendedores de anuncios sobre las subastas de anuncios de Protected Audience.
- Guía para informar los resultados de las subastas
- Prácticas recomendadas para la latencia de subasta de anuncios de Protected Audience
- Cómo solucionar problemas de Protected Audience
La explicación de la API de Protected Audience también proporciona detalles sobre la compatibilidad y las restricciones de funciones.
¿Qué sigue?
Queremos conversar contigo a fin de asegurarnos de compilar una API que funcione para todos.
Debate sobre la API
Al igual que otras APIs de Privacy Sandbox, esta API se documenta y se analiza públicamente.
Experimenta con la API
Puedes experimentar y participar en las conversaciones sobre la API de Protected Audience.