REST Resource: exchanges.inventorySources

Ressource: InventorySource

Ausführungsmodell einer DV360-Inventarquelle.

JSON-Darstellung 
{
  "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)
  }
}
Felder
name

string

Nur Ausgabe. Relativer Ressourcenname für die Bestellung. Vom Server generiert. Beispiel: „exchanges/1234/inventorySources/5678“.
buyerStatus

enum (BuyerStatus)

Nur Ausgabe. Käuferstatus
sellerStatus

enum (SellerStatus)

Verkäuferstatus
transactionType

enum (TransactionType)

Nur Ausgabe. Produkttyp der Transaktion.
pricingType

enum (PricingType)

Nur Ausgabe. Preistyp für das Produkt.
rateDetails

object (RateDetails)

Nur Ausgabe. Preisdetails.
startTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt, zu dem dieses Produkt aktiv wird. Muss vor „endTime“ liegen. Die Startzeit darf maximal ein Jahr in der Zukunft liegen.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
endTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt, zu dem dieses Produkt inaktiv wird.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
exchangeVolumeForecast
(deprecated)

object (InventorySourceVolumeForecast)

Tagesbasierte Volumenprognose der Anzeigenplattform. Wird verwendet, um die Auslieferung zu steuern und Käufern die Wahl zu ermöglichen. Die Verwendung dieses Feldes wurde eingestellt.
audienceMatchRate

number

Nur Ausgabe. Prognostizierte Abgleichsrate für programmatisch garantierte Deals mit Zielgruppen-Targeting, die von der Anzeigenplattform verwendet wird, um zu ermitteln, wie viele zusätzliche Anfragen gesendet werden sollen. Dies ist eine Dezimalzahl zwischen 0 und 1, deren Inverse als Multiplikator für die Impressionen verwendet werden sollte. Der Wert 0 gibt an, dass das Feld nicht festgelegt ist und daher kein Zielgruppentargeting vorhanden ist. Beispiel: „0.125“ Das bedeutet, dass 12,5% der Anfragen dem Zielgruppen-Targeting entsprechen und die Anzahl der gesendeten Anfragen das Achtfache der vereinbarten Impressionen betragen sollte.
makegoodRequested

boolean

Nur Ausgabe. Gibt an, ob eine Ausgleichsbuchung vom Käufer angefordert wurde.
makegoodRequestedReason

string

Nur Ausgabe. Grund für die Anfrage für eine Ausgleichsbuchung, der vom Käufer angegeben wurde.
percentFrequencyCapExcludedTraffic

string (int64 format)

Prozentsatz des Traffics, der für einen programmatisch garantierten Deal vom Frequency Capping ausgeschlossen wurde. Das ist eine Ganzzahl zwischen 0 und 100. Der Wert 0 (auch der Standardwert) bedeutet, dass kein Ausschluss erfolgt und daher der gesamte Traffic für die Häufigkeitsbegrenzung infrage kommt. Der Wert 100 bedeutet einen vollständigen Ausschluss und daher wird keine Häufigkeitsbegrenzung angewendet. Werte zwischen 0 und 100 führen zu einem teilweisen Ausschluss. Bei einem Wert von 20 werden beispielsweise 20% des Traffics vom Frequency Capping ausgeschlossen.
dv360WseatId[]

string (int64 format)

Nur Ausgabe. Die Web-Seats, für die derzeit Berechtigungen für die Inventarquelle vorhanden sind.
lastModifiedTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt der letzten Aktualisierung der Inventarquelle. Hinweis: Bei einigen internen DV3-Aktualisierungen wird die Zeit der letzten Änderung aktualisiert.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
creativeApprovalConfig

object (CreativeApprovalConfig)

Optional. Die Konfiguration für die Creative-Freigabe. Die Genehmigung kann auf Börsen- oder Publisher-Ebene erforderlich sein.

BuyerStatus

Käuferstatus

Enums
BUYER_STATUS_UNSPECIFIED Der Käuferstatus ist nicht angegeben. Ungültiger Eingabewert.
BUYER_STATUS_ACTIVE Der Käuferstatus ist aktiv. Der Werbebuchung ist ein gültiges Creative zugewiesen.
BUYER_STATUS_PENDING Der Käuferstatus ist ausstehend. Dieser Status bedeutet, dass der Deal nicht aktiv ist und der Käufer bestimmte Maßnahmen ergreifen muss.
BUYER_STATUS_PAUSED Käuferstatus „Vom Käufer pausiert“.

SellerStatus

Verkäuferstatus

Enums
SELLER_STATUS_UNSPECIFIED Der Verkäuferstatus ist nicht angegeben. Unerwartet. Der Verhandlungsstatus ist unbekannt. Ungültiger Eingabewert.
SELLER_STATUS_ACTIVE Der Verkäuferstatus ist aktiv. Die Inventarquelle ist auf der Anzeigenplattformseite aktiv.
SELLER_STATUS_PAUSED Der Verkäuferstatus wurde pausiert.

InventorySourceVolumeForecast

Prognose für das tägliche Anfragevolumen für eine Inventarquelle. Es gelten die folgenden Validierungsregeln: - Für jeden Wochentag muss ein Eintrag angegeben werden. - Das Volumen muss nicht negativ sein. - Die timeZoneId ist erforderlich und muss gültig sein.

JSON-Darstellung 
{
  "dailyVolumes": [
    {
      object (DailyVolume)
    }
  ],
  "timeZoneId": string
}
Felder
dailyVolumes[]

object (DailyVolume)

Vorhersage für das Tagesvolumen.
timeZoneId

string

Zeitzone aus der IANA-Zeitzonendatenbank, z.B. „America/New_York“, die für die täglichen Mengen verwendet wird.

DailyVolume

Anfragevolumen für eine Inventarquelle für einen bestimmten Tag.

JSON-Darstellung 
{
  "day": enum (DayOfWeek),
  "volume": string
}
Felder
day

enum (DayOfWeek)

Wochentag, auf den sich das Anfragevolumen bezieht.
volume

string (int64 format)

Das prognostizierte Anfragevolumen für den angegebenen Wochentag.

DayOfWeek

Steht für einen Wochentag.

Enums
DAY_OF_WEEK_UNSPECIFIED Der Wochentag ist nicht angegeben.
MONDAY Montag
TUESDAY Dienstag
WEDNESDAY Mittwoch
THURSDAY Donnerstag
FRIDAY Freitag
SATURDAY Samstag
SUNDAY Sonntag

CreativeApprovalConfig

Die Konfiguration für die Creative-Freigabe.

JSON-Darstellung 
{
  "requiresExchangeApproval": boolean,
  "publisherConfigs": [
    {
      object (PublisherConfig)
    }
  ]
}
Felder
requiresExchangeApproval

boolean

Erforderlich. Gibt an, ob für das Creative eine Vorabgenehmigung auf Exchange-Ebene erforderlich ist, bevor es aufgenommen werden kann.
publisherConfigs[]

object (PublisherConfig)

Optional. Die Konfiguration für den Publisher.

PublisherConfig

Die Konfiguration für den Publisher (publisher_config). Wenn „publisher_config“ festgelegt ist, muss das Creative auf Publisher-Ebene vor der Aufnahme genehmigt werden.

JSON-Darstellung 
{
  "publisherId": string,
  "publisherDisplayName": string
}
Felder
publisherId

string

Erforderlich. Die Publisher-ID.
publisherDisplayName

string

Erforderlich. Der Name des Publishers.

Methoden

get

 Ruft eine Inventarquelle ab.

list

 Listet Inventarquellen auf.

patch

 Aktualisiert eine Inventarquelle.