API Marketplace

Panoramica

L'API di Authorized Buyers Marketplace è una raccolta di risorse che gli acquirenti possono utilizzare per gestire in modo programmatico quanto segue:

  • Negoziazioni con i publisher
  • Pacchetti di aste
  • Accesso dei clienti all'interfaccia utente del Marketplace di Authorized Buyers

Questa guida presenta l'API Marketplace e spiega come le risorse dell'API Marketplace vengono associate alle funzionalità del Marketplace nell'interfaccia utente di Authorized Buyers.

Offerenti e acquirenti

L'API Marketplace è coerente con la struttura dell'API Real-Time Bidding. Entrambe le API utilizzano bidders e buyers come risorse a livello di directory principale per le operazioni dell'offerente e dell'acquirente. Puoi utilizzare gli stessi nomi di offerente e acquirente nei percorsi delle risorse per le offerte in tempo reale e le API Marketplace.

Clienti e utenti cliente

Puoi utilizzare l'API Marketplace per creare e gestire clienti e utenti cliente e per concedere in modo programmatico ad agenzie o inserzionisti l'accesso alla tua scheda Marketplace nell'interfaccia utente di Authorized Buyers.

Un elemento Client rappresenta un cliente, un'agenzia o un inserzionista associato al tuo account Authorized Buyers.

Un elemento ClientUser rappresenta una persona specifica che ha accesso all'interfaccia utente in base a un Client. Gli utenti client non possono accedere all'API Marketplace. Gli utenti cliente hanno un accesso limitato alla scheda Marketplace del tuo account. Le autorizzazioni degli utenti del cliente sono determinate dal valore role specificato nell'elemento Client principale.

Altre risorse nell'API Marketplace fanno riferimento ai client con il nome specificato nella risorsa Clients.

Per scoprire di più su clienti e utenti cliente nell'interfaccia utente di Authorized Buyers Marketplace, consulta i seguenti articoli del Centro assistenza:

Media planner

Un media planner è un'agenzia o un'altra persona giuridica che negozia in modo indipendente gli accordi con i publisher e consente a uno o più offerenti di fare offerte per conto dei loro deal finalizzati. Questi deal sono di asta privata o preferred deal e non potrai visualizzarli o interagire con i deal finché non saranno finalizzati. Trascorso questo periodo, verranno visualizzati nella risposta di bidders.finalizedDeals.list.

Per determinare se un determinato deal finalizzato è stato negoziato da un media planner, puoi verificare se il campo mediaPlanner del deal è stato compilato. I media planner impostano un elenco di ID utenza specifici per DSP idonei a eseguire transazioni sul deal, che possono essere visualizzati nel campo eligibleSeatIds. Nelle richieste di offerta con offerte in tempo reale, questi ID utenze possono comparire nelle liste consentite o in liste bloccate impostate dal publisher, le quali determineranno se le offerte saranno o meno filtrate dall'asta. Possono essere visualizzate nei seguenti campi BidRequest:

  • Protocollo OpenRTB
    • BidRequest.wseat
    • BidRequest.bseat
    • BidRequest.imp.pmp.deals.wseat
  • Protocollo Google RTB
    • BidRequest.adslot.allowed_seat_ids
    • BidRequest.adslot.blocked_seat_ids
    • BidRequest.adslot.matching_ad_data.direct_deal.allowed_seat_ids

Pacchetti di aste

Puoi utilizzare l'API Marketplace per sottoscrivere e annullare l'iscrizione di acquirenti e clienti ai pacchetti di aste e per visualizzare i pacchetti di aste a cui hai effettuato l'iscrizione.

Un elemento AuctionPackage è simile a un pacchetto di targeting per l'inventario del Marketplace. Ad esempio, un pacchetto di aste potrebbe avere come target una raccolta di URL e ID di applicazioni mobile pertinenti agli interessi commerciali di un acquirente.

Non puoi creare nuovi pacchetti di aste con l'API Marketplace. Puoi utilizzare l'interfaccia utente del Marketplace di Authorized Buyers per creare pacchetti di aste. L'API Marketplace non include informazioni di targeting specifiche associate ai pacchetti di aste.

Puoi condividere pacchetti di aste con altri acquirenti e clienti e puoi condividere con te pacchetti di aste creati da Google o da altri acquirenti.

Per ulteriori informazioni, consulta la sezione Pacchetti di aste.

Profili dei publisher

Puoi utilizzare l'API Marketplace per visualizzare i profili per i publisher con cui puoi negoziare.

Un elemento PublisherProfile rappresenta un publisher nell'API Marketplace. Altre risorse nell'API Marketplace fanno riferimento ai publisher con il nome specificato in PublisherProfile.

I profili dei publisher contengono informazioni simili a quelle per Publisher nella scheda Rilevamento dell'interfaccia utente del Marketplace di Authorized Buyers.

Per ulteriori informazioni, consulta Come individuare gli editori.

Proposte e deal

Puoi utilizzare l'API Marketplace per negoziare deal con i publisher. Ecco alcuni modi in cui puoi utilizzare l'API Marketplace per gestire i deal:

Le proposte rappresentano l'ultimo stato della negoziazione di uno o più deal tra un acquirente o cliente e un publisher e sono simili alla scheda Negoziazioni dell'interfaccia utente di Authorized Buyers Marketplace.

I deal rappresentano i termini più recenti di un deal in fase di negoziazione nell'ambito di una determinata proposta e sono paragonabili all'elenco di deal dell'interfaccia utente di Authorized Buyers Marketplace etichettati come NEGOZIAZIONE ATTUALE per una determinata proposta.

I deal definiti rappresentano i deal che hanno completato la fase di negoziazione e sono pronti per essere pubblicati. Sono inclusi i deal già pubblicati. I deal finalizzati sono simili alla scheda Deal dell'interfaccia utente di Authorized Buyers.

A seconda del tipo di deal che stai negoziando, il comportamento potrebbe variare tra le risorse dell'API Marketplace. Ad esempio, gli acquirenti non possono avviare negoziazioni per tutti i tipi di deal. Per scoprire di più sull'implementazione dell'API Marketplace per le negoziazioni, consulta le seguenti risorse:

Per scoprire di più sulle negoziazioni nell'interfaccia utente di Authorized Buyers Marketplace, consulta quanto segue: