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 del venditore.

transactionType

enum (TransactionType)

Solo output. Tipo di transazione del prodotto.

pricingType

enum (PricingType)

Solo output. Tipo di prezzo del prodotto.

rateDetails

object (RateDetails)

Solo output. Dettagli della tariffa.

startTime

string (Timestamp format)

Solo output. Data e ora in cui il prodotto diventa attivo. Deve essere precedente a endTime. L'ora di inizio non può essere più lontana di 1 anno nel futuro.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. 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. Data e ora in cui questo prodotto diventa inattivo.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. 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)

La piattaforma di scambio pubblicitario ha fornito una previsione giornaliera del volume. Viene 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 dalla piattaforma di scambio pubblicitario 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 il volume di richieste inviate deve essere pari a otto volte le impressioni negoziate.

makegoodRequested

boolean

Solo output. Indica se è stata richiesta un'azione di recupero all'acquirente.

makegoodRequestedReason

string

Solo output. Motivo della richiesta di un elemento pubblicitario di recupero fornito dall'acquirente.

percentFrequencyCapExcludedTraffic

string (int64 format)

Percentuale di traffico escluso dalla quota limite per un deal di pubblicità programmatica garantita. Deve essere un numero intero compreso tra 0 e 100. Il valore 0 (anche il valore predefinito) indica che non è presente alcuna esclusione e quindi tutto il traffico è idoneo per la quota limite. 100 indica un'esclusione completa e quindi non verrà applicata alcuna quota limite. I valori compresi tra 0 e 100 comportano un'esclusione parziale. Ad esempio, un valore pari a 20 comporterà l'esclusione del 20% del traffico dalla quota limite.

dv360WseatId[]

string (int64 format)

Solo output. I wseat a cui sono attualmente assegnate autorizzazioni per l'origine dell'inventario.

lastModifiedTime

string (Timestamp format)

Solo output. Data dell'ultimo aggiornamento dell'origine dell'inventario. Tieni presente che alcuni aggiornamenti interni di DV3 modificheranno la data e l'ora dell'ultima modifica.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. 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 piattaforma di scambio pubblicitario 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 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 alcune azioni.
BUYER_STATUS_PAUSED Stato dell'acquirente: messa in pausa dall'acquirente.

SellerStatus

Stato del venditore.

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

InventorySourceVolumeForecast

Previsione del volume giornaliero delle richieste per un'origine 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

Il fuso orario del database dei fusi orari IANA, ad esempio "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)

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 prima dell'importazione a livello di piattaforma di scambio pubblicitario.

publisherConfigs[]

object (PublisherConfig)

Facoltativo. La configurazione per il publisher.

PublisherConfig

La configurazione per l'editore (publisher_config). Se publisher_config è impostato, la creatività richiede l'approvazione prima dell'importazione 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.