Flussi di lavoro delle API

Creare un deal

1. Verifica se un prodotto è già stato creato dai prodotti LIST con il filtro external_deal_id. External_deal_id deve essere univoco per tutti i prodotti.

   GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*/orders/*}/products?filter=externalDealId="{external_deal_id}"
   

2. Crea ordine. Il nome viene generato da DV3 e ti consigliamo di memorizzare questo ID in un punto del tuo sistema per recuperarlo in futuro.

3. Crea prodotto nell'ordine. Il nome del prodotto viene generato da DV3 e ti consigliamo di memorizzare questo ID in un punto del sistema per il recupero futuro.

   In alternativa, puoi sempre utilizzare LIST con external_deal_id. Il campo Nome contiene sia l'ID ordine sia l'ID prodotto, in modo da poter identificare facilmente il genitore.

Annullare un'offerta

1. Aggiorna lo stato dell'ordine su Annullato Supporta l'annullamento solo se l'ordine non è stato accettato. Annullato è uno stato finale. Non è possibile riattivare l'ordine una volta annullato.

Visualizzare i dettagli di un deal

1. Visualizzare i dettagli di un ordine. Lo stato viene aggiornato una volta che l'utente accetta, archivia o annulla l'ordine.
2. Visualizza i dettagli del prodotto.

Visualizzare un elenco di offerte

1. LIST ordini con un filtro di stato per ottenere tutti gli ordini accettati/in attesa di accettazione.
2. Prodotti LIST con filtro external_deal_id.
3. ELENCA tutti i prodotti all'interno di un ordine.

Aggiornare un deal

1. Aggiorna l'ordine per i dati di contatto del publisher.
   1. name, does not allow update(cannot be set in the field_mask). Lo stato può essere impostato su Annullato solo tramite API.
   2. partner_id non consente l'aggiornamento.
2. Aggiornamento del prodotto per un aggiornamento specifico dei termini dell'offerta.
   1. name, externalDealId, transactionType, pricingType, updateTime non possono essere aggiornati.
   2. L'aggiornamento di displayName non richiede l'accettazione da parte dell'utente.
   3. L'aggiornamento di rateDetails, creativeConfig cambierà lo stato dell'ordine principale in In attesa di accettazione. Agli inserzionisti DV3 verrà chiesto di accettare il nuovo termine nella pagina di negoziazione, indipendentemente dal fatto che l'ordine precedente sia stato accettato o meno.

Verificare se l'utente ha accettato l'offerta

1. Get Order (Recupera ordine) se conosci l'ID ordine corrispondente. Controlla il campo Stato.
2. Se l'ID ordine non è stato monitorato: elenca i prodotti con il filtro external_deal_id, determina il nome dell'ordine dal nome del prodotto e poi recupera l'ordine. Controlla il campo Stato.

Verificare se l'utente ha configurato(solo per PG) l'offerta

1. Ottieni l'origine dell'inventario. Il nome è "exchanges/{exchangeId}/inventorysources/{external_deal_id}". Controlla lo stato dell'acquirente.
   1. Offerte per le prenotazioni
      1. BUYER_STATUS_ACTIVE significa che un deal è stato accettato e configurato. Si prevede che il deal sia in questo stato quando DV360 riceve una richiesta di offerta che corrisponde ai termini del deal. Un elemento pubblicitario viene generato automaticamente durante il passaggio di configurazione del deal. Per maggiori dettagli, consulta Configurazione dell'accordo.
      2. BUYER_STATUS_PENDINGsignifica che l'ordine è stato accettato, ma il deal non è ancora stato configurato. In questo stato non verranno effettuate spese.
      3. BUYER_STATUS_PAUSEDsignifica che il deal è stato messo in pausa esplicitamente dagli inserzionisti. In questo stato non verranno effettuate spese.
   2. Offerte senza prenotazione
      1. BUYER_STATUS_ACTIVE indica che un deal è stato accettato. Il deal dovrebbe essere in questo stato quando DV3 riceve una richiesta di offerta che corrisponde ai termini del deal E c'è un elemento pubblicitario attivo che ha come target questo deal E la richiesta di offerta corrisponde ai criteri di targeting dell'elemento pubblicitario. Per maggiori dettagli, consulta elemento pubblicitario.** NON esiste un'API Seller per verificare se un deal è stato scelto come target dagli elementi pubblicitari. **
      2. BUYER_STATUS_PENDINGnon applicabile.
      3. BUYER_STATUS_PAUSEDsignifica che il deal è stato messo in pausa esplicitamente dagli inserzionisti. In questo stato non verranno effettuate spese.

Mettere in pausa/riattivare un deal dopo l'accettazione

1. Aggiorna l'origine dell'inventario Stato venditore.
   1. La sospensione/riattivazione non influisce sulla pubblicazione degli accordi. La sospensione di un accordo da parte del venditore mostra agli inserzionisti solo un messaggio informativo. In questo modo, l'inserzionista può risolvere i problemi relativi a un deal senza spesa.

Rinegoziazione (aggiornamento del deal dopo l'accettazione)

La rinegoziazione si riferisce agli aggiornamenti apportati a un deal dopo che è stato accettato dall'acquirente. Questo può essere molto utile sia per gli scambi che per gli acquirenti per apportare nuove modifiche agli accordi accettati. Ad esempio, l'exchange potrebbe rilevare che l'ora di fine del deal accettato non è corretta e può utilizzare il prodotto Update di DV360 per inviare aggiornamenti agli acquirenti DV360 se il deal non è ancora iniziato.

Quali modifiche sono consentite e quali no.

Consentiamo modifiche a tutti i campi, ad eccezione di alcuni campi di pubblicazione critici come: startTime, endTime, rateDetails, creativeConfig e così via. Abbiamo convalide per questi campi di pubblicazione critici. In generale, gli aggiornamenti a questi campi, ad eccezione di creativeConfig, sono consentiti se l'ora di inizio dell'offerta è almeno un giorno dopo nel futuro. Sono consentiti solo aggiornamenti incrementali per le offerte in corso, la cui ora di inizio è passata, ma la cui ora di fine è futura. Non sono consentite modifiche ai deal completati, la cui ora di fine è nel passato. Ad esempio, non è consentito aggiornare il rateDetails di un deal completato un anno fa. In casi come questo, il prodotto Update DV3 genererà un errore di convalida.