Flussi di lavoro delle API

Creare un deal

1. Verifica se un prodotto è già stato creato utilizzando i 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 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 prodotto principale.

Annullare un'offerta

1. Aggiorna lo stato dell'ordine a 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. LIST prodotti con filtro external_deal_id.
3. ELENCA tutti i prodotti all'interno di un ordine.

Aggiorna 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 l'accordo 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. Si prevede che il deal sia in questo stato quando DV3 riceve una richiesta di offerta che corrisponde ai termini del deal E esiste 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, vedi elemento pubblicitario.** NON esiste un'API Seller per eseguire query 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 di stringa a titolo informativo. In questo modo, l'inserzionista può risolvere i problemi relativi a un accordo 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 agli scambi che agli 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.

Per le modifiche consentite e non consentite nelle diverse fasi del deal, consulta questa pagina.