REST Resource: exchanges.inventorySources

Zasób: InventorySource

Model wykonania ź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. Wygenerowano 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ącej 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 produkt staje się aktywny. Musi być wcześniejszy niż endTime. Czas rozpoczęcia nie może być oddalony w przyszłość o więcej niż 1 rok.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Dopuszczalne 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, w którym produkt przestaje być aktywny.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Dopuszczalne 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 dziennego wolumenu podana przez giełdę. Służy do określania tempa i umożliwienia wyboru kupującemu. To pole zostało wycofane.
audienceMatchRate

number

Tylko dane wyjściowe. Przewidywany współczynnik dopasowania odbiorców w umowach 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ć stosowana jako mnożnik wyświetleń. Wartość 0 oznacza, że pole nie jest ustawione, a dlatego nie ma kierowania na odbiorców. Przykład: „0,125”. Oznacza to, że 12,5% żądań pasuje do kierowania na odbiorców, a wysłana liczba żądań powinna być 8 razy większa od liczby uzgodnionych 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 ograniczenia liczby wyświetleń w umowie gwarantowanej automatyzacji. Musi być liczbą całkowitą z zakresu od 0 do 100. Wartość 0 (również wartość domyślna) oznacza brak wykluczenia, dlatego cały ruch kwalifikuje się do ograniczenia częstotliwości. Wartość 100 oznacza całkowite wykluczenie, dlatego nie zostanie zastosowane ograniczenie częstotliwości. Wartości od 0 do 100 spowodują częściowe wykluczenie. Jeśli np. wartość wynosi 20, z limitu częstotliwości zostanie wykluczone 20% ruchu.
dv360WseatId[]

string (int64 format)

Tylko dane wyjściowe. wseats, 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ą datę ostatniej modyfikacji.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Dopuszczalne 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 zatwierdzenia kreacji. Może być wymagane zatwierdzenie 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: aktywny. Przypisany element zamówienia, przypisana prawidłowa kreacja.
BUYER_STATUS_PENDING Stan kupującego: oczekuje. Ten stan oznacza, że umowa jest nieaktywna i kupujący musi wykonać określone czynności.
BUYER_STATUS_PAUSED Stan kupującego: wstrzymany przez kupującego.

SellerStatus

Stan sprzedawcy.

Wartości w polu enum
SELLER_STATUS_UNSPECIFIED Stan sprzedawcy jest nieokreślony. Nieoczekiwane. Wskazuje na to, ż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: wstrzymany.

InventorySourceVolumeForecast

Prognoza dziennej liczby żądań dla źródła asortymentu. Obowiązują następujące reguły weryfikacji: – wpis musi być podany dla każdego dnia tygodnia – objętość nie może być ujemna – identyfikator timeZoneId jest wymagany i musi być prawidłowy

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

object (DailyVolume)

Prognoza dziennych wolumenów.
timeZoneId

string

Strefa czasowa z bazy danych IANA, np. „America/New_York”, używana do obliczania dziennych wolumenów.

DailyVolume

Prośba o przewidywaną liczbę wyświetleń dla źródła zasobów reklamowych w danym dniu.

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

enum (DayOfWeek)

Dzień tygodnia, w którym dotyczy liczba żą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 zatwierdzenia kreacji.

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

boolean

Wymagane. Wskazuje, czy kreacja wymaga zatwierdzenia na poziomie giełdy przed przetworzeniem.
publisherConfigs[]

object (PublisherConfig)

Opcjonalnie. Konfiguracja dla wydawcy.

PublisherConfig

Konfiguracja wydawcy (publisher_config). Jeśli parametr publisher_config jest ustawiony, kreacja wymaga zatwierdzenia przed przetworzeniem 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.