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. Produkttransaktionstyp.
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. Der Beginn darf nicht mehr als ein Jahr in der Zukunft liegen.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. 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.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
exchangeVolumeForecast
(deprecated)

object (InventorySourceVolumeForecast)

Die Anzeigenplattform hat eine tägliche Prognose für das Volumen bereitgestellt. Wird verwendet, um das Tempo zu bestimmen und Käufern die Wahl zu lassen. Die Verwendung dieses Feldes wurde eingestellt.
audienceMatchRate

number

Nur Ausgabe. Die prognostizierte Abgleichsrate für programmatisch garantierte Deals mit Zielgruppen-Targeting, mit der die Anzeigenplattform ermittelt, wie viele zusätzliche Anfragen gesendet werden sollen. Dies ist eine Dezimalzahl zwischen 0 und 1, deren Kehrwert als Multiplikator für die Impressionen verwendet werden sollte. „0“ gibt an, dass das Feld nicht festgelegt ist und daher kein Zielgruppen-Targeting erfolgt. Beispiel: „0,125“. Das bedeutet, dass 12,5% der Anfragen dem Zielgruppen-Targeting entsprechen.Die Anzahl der gesendeten Anfragen sollte das Achtfache der ausgehandelten Impressionen betragen.
makegoodRequested

boolean

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

string

Nur Ausgabe. Vom Käufer angegebener Grund für die Anfrage einer Ausgleichsbuchung.
percentFrequencyCapExcludedTraffic

string (int64 format)

Prozentsatz des Traffics, der bei einem programmatisch garantierten Deal vom Frequency Capping ausgeschlossen ist. Dies ist eine Ganzzahl zwischen 0 und 100. Der Wert „0“ (auch der Standardwert) gibt an, dass keine Ausschlüsse gelten und daher der gesamte Traffic für die Häufigkeitsobergrenze infrage kommt. „100“ bedeutet einen vollständigen Ausschluss und daher wird keine Häufigkeitsobergrenze 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 Wseats, die derzeit für die Inventarquelle berechtigt sind.
lastModifiedTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt der letzten Aktualisierung der Inventarquelle. Hinweis: Bei einigen internen DV3-Änderungen ändert sich das Datum der letzten Änderung.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. 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 Anzeigenplattform- oder Publisherebene erforderlich sein.

BuyerStatus

Käuferstatus

Enums
BUYER_STATUS_UNSPECIFIED Der Käuferstatus ist nicht angegeben. Ungültiger Eingabewert.
BUYER_STATUS_ACTIVE Käuferstatus: aktiv Werbebuchung zugewiesen, gültiges Creative zugewiesen.
BUYER_STATUS_PENDING Käuferstatus 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 Verkäuferstatus nicht angegeben. Unerwartet. Der Verhandlungsstatus ist unbekannt. Ungültiger Eingabewert.
SELLER_STATUS_ACTIVE Verkäuferstatus ist aktiv. Die Inventarquelle ist auf Anzeigenplattformseite aktiv.
SELLER_STATUS_PAUSED Verkäuferstatus: „Pausiert“.

InventorySourceVolumeForecast

Prognose des täglichen Anfragevolumens für eine Inventarquelle. Es gelten die folgenden Validierungsregeln:

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

object (DailyVolume)

Vorhersage des täglichen Volumens.
timeZoneId

string

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

DailyVolume

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

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

enum (DayOfWeek)

Der 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 Genehmigung vor der Datenaufnahme auf Anzeigenplattformebene erforderlich ist.
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 vor der Datenaufnahme auf Publisherebene 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

 Hier werden Inventarquellen aufgelistet.

patch

 Aktualisiert eine Inventarquelle.