REST Resource: exchanges.inventorySources

Risorsa: InventorySource

Modello di esecuzione di un'origine dell'inventario DV360.

Rappresentazione JSON 
{
  "name": string,
  "buyerStatus": enum (BuyerStatus),
  "sellerStatus": enum (SellerStatus),
  "transactionType": enum (TransactionType),
  "pricingType": enum (PricingType),
  "rateDetails": {
    object (RateDetails)
  },
  "startTime": string,
  "endTime": string,
  "exchangeVolumeForecast": {
    object (InventorySourceVolumeForecast)
  },
  "audienceMatchRate": number,
  "makegoodRequested": boolean,
  "makegoodRequestedReason": string,
  "percentFrequencyCapExcludedTraffic": string,
  "dv360WseatId": [
    string
  ],
  "lastModifiedTime": string,
  "creativeApprovalConfig": {
    object (CreativeApprovalConfig)
  }
}
Campi
name

string

Solo output. Nome della risorsa relativa per l'ordine. Generato dal server. Esempio: "exchanges/1234/inventorySources/5678".
buyerStatus

enum (BuyerStatus)

Solo output. Stato dell'acquirente.
sellerStatus

enum (SellerStatus)

Stato venditore.
transactionType

enum (TransactionType)

Solo output. Tipo di transazione del prodotto.
pricingType

enum (PricingType)

Solo output. Tipo di prezzo per il prodotto.
rateDetails

object (RateDetails)

Solo output. Dettagli tariffa.
startTime

string (Timestamp format)

Solo output. L'ora in cui questo prodotto diventa attivo. Deve essere precedente a endTime. L'ora di inizio non può essere successiva di più di un anno.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Solo output. Il momento in cui questo prodotto diventa inattivo.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
exchangeVolumeForecast
(deprecated)

object (InventorySourceVolumeForecast)

Previsione del volume giornaliero fornita dalla piattaforma di scambio pubblicitario. Utilizzato per determinare il pacing e consentire la scelta dell'acquirente. Campo obsoleto.
audienceMatchRate

number

Solo output. Tasso di corrispondenza del pubblico previsto per i deal di pubblicità programmatica garantita con targeting per pubblico, utilizzato dall'exchange per determinare quante richieste aggiuntive devono essere inviate. Si tratta di un numero decimale compreso tra 0 e 1, il cui inverso deve essere utilizzato come moltiplicatore per le impressioni. 0 indica che il campo non è impostato e pertanto non ha un targeting per pubblico. Esempio: "0.125". Ciò indica che il 12, 5% delle richieste corrisponde al targeting per pubblico e che la quantità di richieste inviate deve essere 8 volte superiore alle impressioni negoziate.
makegoodRequested

boolean

Solo output. Indica se l'acquirente ha richiesto un elemento pubblicitario di recupero.
makegoodRequestedReason

string

Solo output. Motivo per cui l'acquirente richiede l'elemento pubblicitario di recupero.
percentFrequencyCapExcludedTraffic

string (int64 format)

Percentuale di traffico escluso dalla quota limite per un deal di pubblicità programmatica garantita. Si tratta di un numero intero compreso tra 0 e 100. Il valore 0 (anche il valore predefinito) indica nessuna esclusione e pertanto tutto il traffico è idoneo per il limite di frequenza. 100 indica l'esclusione completa e pertanto non verrà applicato alcun limite di frequenza. I valori compresi tra 0 e 100 comporteranno un'esclusione parziale. Ad esempio, un valore pari a 20 escluderà il 20% del traffico dalla quota limite.
dv360WseatId[]

string (int64 format)

Solo output. I wseats attualmente autorizzati per l'origine dell'inventario.
lastModifiedTime

string (Timestamp format)

Solo output. L'ultima volta che l'origine dell'inventario è stata aggiornata. Tieni presente che alcuni aggiornamenti interni di DV3 modificheranno l'ora dell'ultima modifica.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
creativeApprovalConfig

object (CreativeApprovalConfig)

Facoltativo. La configurazione per l'approvazione delle creatività. L'approvazione può essere richiesta a livello di exchange o di publisher.

BuyerStatus

Stato dell'acquirente.

Enum
BUYER_STATUS_UNSPECIFIED Lo stato dell'acquirente non è specificato. Valore di input non valido.
BUYER_STATUS_ACTIVE Lo stato dell'acquirente è attivo. Elemento pubblicitario assegnato, creatività valida assegnata.
BUYER_STATUS_PENDING Stato dell'acquirente in attesa. Questo stato indica che il deal non è attivo e che l'acquirente deve eseguire determinate azioni.
BUYER_STATUS_PAUSED Stato dell'acquirente messo in pausa dall'acquirente.

SellerStatus

Stato venditore.

Enum
SELLER_STATUS_UNSPECIFIED Stato venditore non specificato. Inatteso, indica che lo stato della negoziazione è sconosciuto. Valore di input non valido.
SELLER_STATUS_ACTIVE Stato venditore attivo. L'origine dell'inventario è attiva sul lato della piattaforma di scambio pubblicitario.
SELLER_STATUS_PAUSED Stato venditore messo in pausa.

InventorySourceVolumeForecast

Previsione del volume di richieste giornaliere per un'origine dell'inventario. Si applicano le seguenti regole di convalida: - deve essere fornita una voce per ogni giorno della settimana - il volume deve essere non negativo - timeZoneId è obbligatorio e deve essere valido

Rappresentazione JSON 
{
  "dailyVolumes": [
    {
      object (DailyVolume)
    }
  ],
  "timeZoneId": string
}
Campi
dailyVolumes[]

object (DailyVolume)

Previsione dei volumi giornalieri.
timeZoneId

string

Fuso orario del database dei fusi orari IANA, ad es. "America/New_York", utilizzato per i volumi giornalieri.

DailyVolume

Volume delle richieste per un'origine dell'inventario per un determinato giorno.

Rappresentazione JSON 
{
  "day": enum (DayOfWeek),
  "volume": string
}
Campi
day

enum (DayOfWeek)

Il giorno della settimana a cui si applica il volume di richieste.
volume

string (int64 format)

Il volume di richieste previsto per il giorno della settimana specificato.

DayOfWeek

Rappresenta un giorno della settimana.

Enum
DAY_OF_WEEK_UNSPECIFIED Il giorno della settimana non è specificato.
MONDAY Lunedì
TUESDAY Martedì
WEDNESDAY Mercoledì
THURSDAY Giovedì
FRIDAY Venerdì
SATURDAY Sabato
SUNDAY Domenica

CreativeApprovalConfig

La configurazione per l'approvazione delle creatività.

Rappresentazione JSON 
{
  "requiresExchangeApproval": boolean,
  "publisherConfigs": [
    {
      object (PublisherConfig)
    }
  ]
}
Campi
requiresExchangeApproval

boolean

Obbligatorio. Indica se la creatività richiede l'approvazione pre-ingest a livello di exchange.
publisherConfigs[]

object (PublisherConfig)

Facoltativo. La configurazione per il publisher.

PublisherConfig

La configurazione per il publisher (publisher_config). Se publisher_config è impostato, la creatività richiede l'approvazione pre-ingest a livello di publisher.

Rappresentazione JSON 
{
  "publisherId": string,
  "publisherDisplayName": string
}
Campi
publisherId

string

Obbligatorio. L'ID publisher.
publisherDisplayName

string

Obbligatorio. Il nome dell'editore.

Metodi

get

 Recupera un'origine dell'inventario.

list

 Elenca le origini dell'inventario.

patch

 Aggiorna un'origine dell'inventario.