Eseguire un'asta basata su browser con un singolo venditore

Questo documento fornisce una panoramica generale sulla gestione di un'asta con Dati Protected Audience per un singolo venditore, come utilizzati nell'iterazione attuale di l'API Protected Audience. Un'asta con un singolo venditore può essere nell'ambito di un'asta più complessa che coinvolge più venditori. In questo in questo caso l'asta per venditori singoli è detta "asta per componenti", ovvero può presentare i candidati di annunci all'"asta di primo livello" con più venditori partecipanti.

Leggi la guida per gli sviluppatori per conoscere l'intero ciclo di vita dell'API Protected Audience. e consulta la spiegazione dell'API Protected Audience per un approfondimento discussione su come i venditori eseguono aste on-device.

Sei fasi di un'asta dell'annuncio dell'API Protected Audience

Sei fasi di un'asta dell'annuncio dell'API Protected Audience
Questo diagramma illustra ogni fase di un'asta dell'annuncio dell'API Protected Audience.
  1. Un utente visita un sito che visualizza annunci.
  2. Il codice del venditore esegue navigator.runAdAuction(). In questo modo viene specificato spazio pubblicitario è in vendita e chi può fare offerte. I venditori devono includere anche uno script che assegna un punteggio a ciascuna offerta, scoreAd().
  3. Il codice dell'acquirente invitato viene eseguito per generare un'offerta, un URL per un annuncio pertinente creatività e altri dati. Lo script di offerta può eseguire query per ottenere dati in tempo reale, ad esempio il budget rimanente della campagna pubblicitaria, Servizio chiave/valore.
  4. Il codice del venditore assegna un punteggio a ciascuna offerta e seleziona un vincitore. Questa logica utilizza il valore dell'offerta e altri dati restituiscono l'attrattiva di un'offerta. Annunci che non possono battere vengono rifiutate. Il venditore può utilizzare i propri Servizio chiave/valore per dati in tempo reale.
  5. L'annuncio vincente viene restituito come un valore opaco, che viene visualizzato in frame recintata. Sia il venditore che il publisher non sarà in grado di visualizzare questo valore.
  6. L'asta viene segnalata al venditore e agli acquirenti vincitori.

Un'asta può avvenire quando un utente accede a una pagina in cui viene visualizzato un annuncio. Le aste possono essere eseguite in anticipo, in modo che la creatività dell'annuncio sia pronta quando l'annuncio l'area di notifica.

I venditori avviano l'asta dell'annuncio e assegnano un punteggio agli annunci candidati utilizzando la logica personalizzata fornita come funzione scoreAd() e sono responsabili della generazione di report sui risultati all'asta tra se stessi e l'acquirente vincente. I venditori possono inoltre applicare regole per i publisher e filtrare in base alla qualità degli annunci utilizzando scoreAd() personalizzata.

Un venditore può indicare:

  • Publisher di contenuti che agiscono da soli per ospitare i contenuti degli annunci sul proprio sito web.
  • Supply-Side Platform (SSP), collaborare con il publisher degli annunci e fornire altri servizi
  • Script di terze parti che operano per conto dei publisher per consentire la partecipazione alle aste degli annunci.

Prerequisiti per eseguire un'asta

Un venditore ha bisogno di due funzioni JavaScript definite per eseguire un'asta:

  • scoreAd(), che assegna un punteggio a un candidato di annuncio
  • reportResult(), che gestisce la segnalazione dei risultati dell'asta al venditore stesso

Questi script devono essere pubblicati da un unico endpoint di proprietà del venditore.

scoreAd()

Un venditore deve definire una funzione scoreAd() fornita da un endpoint di loro proprietà. L'endpoint è specificato nella configurazione dell'asta come decisionLogicUrl. La funzione scoreAd() ha la seguente firma:

scoreAd(
  adMetadata,
  bid,
  auctionConfig,
  trustedScoringSignals,
  browserSignals,
  directFromSellerSignals)

I parametri scoreAd() sono:

  • adMetaData, che sono metadati arbitrari sulla creatività dell'annuncio, forniti dall'acquirente. Si tratta di un oggetto serializzabile JSON che venditori e gli acquirenti dovranno definire e concordare la struttura.
  • bid, che è un valore numerico che rappresenta l'offerta.
  • auctionConfig, ovvero la configurazione dell'asta utilizzata per eseguire l'asta.
  • trustedScoringSignals, indicatori letti al momento dell'asta dal server chiave/valore del venditore. La piattaforma utilizzerà renderUrl del annuncio candidato come chiave per questa ricerca.
  • browserSignals, un oggetto creato dal browser, che include informazioni note al browser e che lo script dell'asta del venditore potrebbe che vuoi verificare.
  • directFromSellerSignals è un oggetto che può contenere i seguenti campi: ** sellerSignals: Come auctionConfig.sellerSignals, ma superato utilizzando il Meccanismo directFromSellerSignals. ** auctionSignals: come auctionConfig.auctionSignals, ma superato utilizzando il meccanismo directFromSellerSignals.

Di seguito è riportato un esempio di browserSignals. Nota che il renderUrl del annuncio candidato è disponibile tramite questi indicatori:

{ 'topWindowHostname': 'www.example-publisher.com',
  'interestGroupOwner': 'https://www.example-buyer.com',
  'renderURL': 'https://cdn.com/render_url_of_bid',
  'renderSize': {width: 100, height: 200}, /* if specified in the bid */
  'adComponents': ['https://cdn.com/ad_component_of_bid',
                   'https://cdn.com/next_ad_component_of_bid',
                   ...],
  'biddingDurationMsec': 12,
  'bidCurrency': 'USD', /* bidCurrency returned by generateBid, or '???' if none */
  'dataVersion': 1, /* Data-Version value from the trusted scoring signals server's response */
}

reportResult()

Un venditore deve definire una funzione reportResult() fornita da una dell'endpoint di loro proprietà. L'endpoint è specificato nella configurazione dell'asta come decisionLogicUrl. La funzione reportResult() ha quanto segue firma:

reportResult(auctionConfig, browserSignals) {
  ...
  return signalsForWinner;
}

I parametri reportResult() sono:

  • auctionConfig, ovvero la configurazione dell'asta utilizzata per eseguire l'asta.
  • browserSignals, un oggetto creato dal browser, che include informazioni note al browser e che lo script dell'asta del venditore potrebbe che vuoi verificare. Si tratta dello stesso oggetto passato alla funzione scoreAds().

reportResult() restituisce signalsForWinner, che è un oggetto JSON arbitrario passato alla funzione di reporting dell'acquirente vincente. È necessario includere qualsiasi informazione pertinente che il venditore può fornire sull'asta che l'acquirente per i report.

Eseguire un'asta dell'API Protected Audience

Un venditore deve seguire quattro passaggi principali per condurre un'asta. Tieni presente che questi passaggi presuppongono che il venditore abbia configurato un endpoint per restituire il codice JavaScript richiesto menzionate in precedenza in questa guida.

  1. Configura l'asta. Questo passaggio include la creazione di un oggetto auctionConfig. Ciò consente al venditore di specificare gli acquirenti che devono partecipare al dell'asta, nonché di fornire tutti gli indicatori che potrebbero essere pertinenti durante l'offerta o punteggio degli annunci.
  2. Esegui l'asta chiamando navigator.runAdAuction(), superando il configurazione creata nel passaggio precedente. Ciò avvia la catena di acquirenti generano offerte e poi assegnano un punteggio. Il risultato finale di questo passaggio è un candidato di annuncio che possono essere sottoposti a rendering per visualizzare un annuncio.
  3. Esegui il rendering dell'annuncio vincente in un frame o iframe recintato.
  4. Segnala il risultato dell'asta. C'è una funzione, navigator.sendReportTo(), verrà avviata la generazione di report. Il venditore ricevere un report sui risultati dell'asta. Solo l'acquirente che ha vinto l'asta riceveranno una segnalazione. Utilizza i reportResult() del venditore descritti in precedenza di questa guida per inviare la segnalazione al proprio server.