REST Resource: exchanges.inventorySources

Zasób: InventorySource

Model realizacji źródła zasobów reklamowych DV360.

Zapis 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)
  }
}
Pola
name

string

Tylko dane wyjściowe. Względna nazwa zasobu zamówienia. Wygenerowane przez serwer. Przykład: „exchanges/1234/inventorySources/5678”.
buyerStatus

enum (BuyerStatus)

Tylko dane wyjściowe. stan kupującego,
sellerStatus

enum (SellerStatus)

Stan sprzedawcy.
transactionType

enum (TransactionType)

Tylko dane wyjściowe. Typ transakcji dotyczący produktu.
pricingType

enum (PricingType)

Tylko dane wyjściowe. Typ ceny produktu.
rateDetails

object (RateDetails)

Tylko dane wyjściowe. Szczegóły stawki.
startTime

string (Timestamp format)

Tylko dane wyjściowe. Czas, w którym ten produkt staje się aktywny. Musi być wcześniejsza niż endTime. Czas rozpoczęcia nie może przypadać później niż za rok.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Tylko dane wyjściowe. Czas, kiedy ten produkt stanie się nieaktywny.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
exchangeVolumeForecast
(deprecated)

object (InventorySourceVolumeForecast)

Prognoza dziennej liczby wyświetleń podana przez giełdę. Służy do określania tempa i umożliwia kupującemu wybór. To pole zostało wycofane.
audienceMatchRate

number

Tylko dane wyjściowe. Prognozowany współczynnik dopasowania odbiorców w przypadku umów automatyzacji gwarantowanej z kierowaniem na odbiorców, używany przez giełdę do określania, ile dodatkowych żądań należy wysłać. Jest to liczba dziesiętna z zakresu od 0 do 1, której odwrotność powinna być używana jako mnożnik wyświetleń. 0 oznacza, że pole jest nieustawione, a tym samym nie ma kierowania na odbiorców. Przykład: „0,125”. Oznacza to, że 12,5% żądań jest zgodnych z kierowaniem na odbiorców, a liczba wysłanych żądań powinna być 8 razy większa niż wynegocjowana liczba wyświetleń.
makegoodRequested

boolean

Tylko dane wyjściowe. Wskazuje, czy kupujący poprosił o rekompensatę.
makegoodRequestedReason

string

Tylko dane wyjściowe. Powód prośby o rekompensatę podany przez kupującego.
percentFrequencyCapExcludedTraffic

string (int64 format)

Odsetek ruchu wykluczonego z limitu wyświetleń na użytkownika w przypadku umowy automatyzacji gwarantowanej. Jest to liczba całkowita z zakresu od 0 do 100. Wartość 0 (również wartość domyślna) oznacza brak wykluczenia, a tym samym cały ruch kwalifikuje się do limitu wyświetleń. Wartość 100 oznacza całkowite wykluczenie, a tym samym nie będzie stosowany limit wyświetleń. Wartości z zakresu od 0 do 100 spowodują częściowe wykluczenie. Na przykład wartość 20 spowoduje wykluczenie z limitu wyświetleń 20% ruchu.
dv360WseatId[]

string (int64 format)

Tylko dane wyjściowe. Miejsca reklamowe, które mają obecnie uprawnienia do źródła zasobów reklamowych.
lastModifiedTime

string (Timestamp format)

Tylko dane wyjściowe. Ostatnia aktualizacja źródła zasobów reklamowych. Pamiętaj, że niektóre wewnętrzne aktualizacje DV3 zmienią czas ostatniej modyfikacji.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
creativeApprovalConfig

object (CreativeApprovalConfig)

Opcjonalnie. Konfiguracja zatwierdzania kreacji. Wymaganie zatwierdzenia może być ustawione na poziomie giełdy lub wydawcy.

BuyerStatus

stan kupującego,

Wartości w polu enum
BUYER_STATUS_UNSPECIFIED Stan kupującego nie jest określony. Nieprawidłowa wartość wejściowa.
BUYER_STATUS_ACTIVE Stan kupującego to aktywny. Element zamówienia przypisany, przypisana prawidłowa kreacja.
BUYER_STATUS_PENDING Stan kupującego oczekuje na weryfikację. Ten stan oznacza, że umowa nie jest aktywna i kupujący musi podjąć określone działania.
BUYER_STATUS_PAUSED Stan kupującego to „Wstrzymane przez kupującego”.

SellerStatus

Stan sprzedawcy.

Wartości w polu enum
SELLER_STATUS_UNSPECIFIED Stan sprzedawcy jest nieokreślony. Nieoczekiwany, wskazuje, że stan negocjacji jest nieznany. Nieprawidłowa wartość wejściowa.
SELLER_STATUS_ACTIVE Stan sprzedawcy: aktywny. Źródło zasobów reklamowych jest aktywne po stronie giełdy.
SELLER_STATUS_PAUSED Stan sprzedawcy został wstrzymany.

InventorySourceVolumeForecast

Prognoza dziennej liczby żądań w przypadku źródła asortymentu. Obowiązują te reguły weryfikacji: – należy podać wpis dla każdego dnia tygodnia; – wartość musi być nieujemna; – identyfikator timeZoneId jest wymagany i musi być prawidłowy.

Zapis JSON 
{
  "dailyVolumes": [
    {
      object (DailyVolume)
    }
  ],
  "timeZoneId": string
}
Pola
dailyVolumes[]

object (DailyVolume)

Prognoza dziennej liczby.
timeZoneId

string

Strefa czasowa z bazy danych stref czasowych organizacji IANA, np. „America/New_York”, która jest używana w przypadku dziennych wolumenów.

DailyVolume

Liczba żądań w przypadku źródła zasobów reklamowych w danym dniu.

Zapis JSON 
{
  "day": enum (DayOfWeek),
  "volume": string
}
Pola
day

enum (DayOfWeek)

Dzień tygodnia, którego dotyczy wolumen żądań.
volume

string (int64 format)

Prognozowana liczba żądań w danym dniu tygodnia.

DzieńTygodnia

Reprezentuje dzień tygodnia.

Wartości w polu enum
DAY_OF_WEEK_UNSPECIFIED Dzień tygodnia jest nieokreślony.
MONDAY Poniedziałek
TUESDAY Tuesday (wtorek)
WEDNESDAY Wednesday (środa)
THURSDAY Thursday (czwartek)
FRIDAY Friday (piątek)
SATURDAY Saturday (sobota)
SUNDAY Niedziela

CreativeApprovalConfig

Konfiguracja zatwierdzania kreacji.

Zapis JSON 
{
  "requiresExchangeApproval": boolean,
  "publisherConfigs": [
    {
      object (PublisherConfig)
    }
  ]
}
Pola
requiresExchangeApproval

boolean

Wymagane. Wskazuje, czy kreacja wymaga wstępnego zatwierdzenia na poziomie giełdy.
publisherConfigs[]

object (PublisherConfig)

Opcjonalnie. Konfiguracja wydawcy.

PublisherConfig

Konfiguracja wydawcy (publisher_config). Jeśli ustawiono parametr publisher_config, kreacja wymaga wstępnego zatwierdzenia na poziomie wydawcy.

Zapis JSON 
{
  "publisherId": string,
  "publisherDisplayName": string
}
Pola
publisherId

string

Wymagane. Identyfikator wydawcy.
publisherDisplayName

string

Wymagane. Nazwa wydawcy.

Metody

get

 Pobiera źródło zasobów reklamowych.

list

 Wyświetla listę źródeł zasobów reklamowych.

patch

 Aktualizuje źródło zasobów reklamowych.