REST Resource: advertisers.insertionOrders

Zasób: InsertionOrder

Jedno zamówienie reklamowe.

Zapis JSON 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "displayName": string,
  "insertionOrderType": enum (InsertionOrderType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "performanceGoal": {
    object (PerformanceGoal)
  },
  "budget": {
    object (InsertionOrderBudget)
  },
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "reservationType": enum (ReservationType),
  "billableOutcome": enum (BillableOutcome)
}
Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu zamówienia reklamowego.
advertiserId

string (int64 format)

Tylko dane wyjściowe. Unikalny identyfikator reklamodawcy, do którego należy zamówienie reklamowe.
campaignId

string (int64 format)

Wymagane. Stała. Unikalny identyfikator kampanii, do której należy zamówienie reklamowe.
insertionOrderId

string (int64 format)

Tylko dane wyjściowe. Unikalny identyfikator zamówienia reklamowego. Przypisana przez system.
displayName

string

Wymagane. Wyświetlana nazwa zamówienia reklamowego.

Musi być zakodowany w formacie UTF-8 i mieć maksymalny rozmiar 240 bajtów.
insertionOrderType

enum (InsertionOrderType)

Typ zamówienia reklamowego.

Jeśli podczas tworzenia nie określono tego pola, domyślna wartość to RTB.
entityStatus

enum (EntityStatus)

Wymagane. Określa, czy zamówienie reklamowe może wydawać budżet i ustalać stawki za zasoby reklamowe.

  • W metodzie insertionOrders.create dozwolona jest tylko wartość ENTITY_STATUS_DRAFT. Aby aktywować zamówienie reklamowe, użyj metody insertionOrders.patch i po utworzeniu zmień jego stan na ENTITY_STATUS_ACTIVE.
  • Zamówienia reklamowego nie można zmienić z powrotem na ENTITY_STATUS_DRAFT z innego stanu.
  • Zamówienia reklamowego nie można ustawić jako ENTITY_STATUS_ACTIVE, jeśli jego kampania nadrzędna jest nieaktywna.
updateTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa ostatniej aktualizacji zamówienia reklamowego. Przypisany przez system.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
partnerCosts[]

object (PartnerCost)

Koszty partnera związane z zamówieniem reklamowym.

Jeśli metoda insertionOrders.create jest pusta lub nieobecna, nowo utworzone zamówienie reklamowe odziedziczy koszty partnera z ustawień partnera.
pacing

object (Pacing)

Wymagane. Ustawienie tempa wydawania budżetu w zamówieniu reklamowym.
frequencyCap

object (FrequencyCap)

Wymagane. Ustawienie limitu wyświetleń na użytkownika w zamówieniu reklamowym.
integrationDetails

object (IntegrationDetails)

Dodatkowe szczegóły integracji zamówienia reklamowego.
performanceGoal

object (PerformanceGoal)

Wymagane. Docelowa skuteczność zamówienia reklamowego.
budget

object (InsertionOrderBudget)

Wymagane. Ustawienia alokacji budżetu zamówienia reklamowego.
bidStrategy

object (BiddingStrategy)

Strategia ustalania stawek zamówienia reklamowego. Domyślnie ustawiona jest wartość fixedBid.
reservationType

enum (ReservationType)

Tylko dane wyjściowe. Typ rezerwacji zamówienia reklamowego.
billableOutcome

enum (BillableOutcome)

Stała. Wynik zamówienia reklamowego podlegający rozliczeniu.

Kupowanie na podstawie wyników zostało wycofane. BILLABLE_OUTCOME_PAY_PER_IMPRESSION to jedyna prawidłowa wartość.

InsertionOrderType

Możliwe typy zamówienia reklamowego.

Typ zamówienia reklamowego określa, które ustawienia i opcje są dostępne, np. format reklamy lub opcje kierowania.

Wartości w polu enum
INSERTION_ORDER_TYPE_UNSPECIFIED Typ zamówienia reklamowego nie został określony lub jest nieznany.
RTB Określanie stawek w czasie rzeczywistym.
OVER_THE_TOP Over-The-Top.

InsertionOrderBudget

Ustawienia określające sposób przypisywania budżetu zamówienia reklamowego.

Zapis JSON 
{
  "budgetUnit": enum (BudgetUnit),
  "automationType": enum (InsertionOrderAutomationType),
  "budgetSegments": [
    {
      object (InsertionOrderBudgetSegment)
    }
  ]
}
Pola
budgetUnit

enum (BudgetUnit)

Wymagane. Niezmienna. Jednostka budżetu określa, czy budżet jest oparty na walucie, czy na wyświetleniach.
automationType

enum (InsertionOrderAutomationType)

Typ automatyzacji używanej do zarządzania stawką i budżetem zamówienia reklamowego.

Jeśli podczas tworzenia nie określono tego pola, domyślna wartość to INSERTION_ORDER_AUTOMATION_TYPE_NONE.
budgetSegments[]

object (InsertionOrderBudgetSegment)

Wymagane. Lista segmentów budżetu. Segment budżetu umożliwia określenie konkretnego budżetu na dany okres wyświetlania zamówienia reklamowego.

InsertionOrderAutomationType

Możliwe opcje automatyzacji stawki i budżetu zamówienia reklamowego.

Wartości w polu enum
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED Opcja automatyzacji zamówienia reklamowego nie została określona lub jest nieznana w tej wersji.
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET Automatyczne przydzielanie budżetu. Pozwól systemowi automatycznie przenieść budżet na elementy zamówienia będące ich właścicielem, aby zoptymalizować skuteczność zdefiniowaną przez performanceGoal. Brak automatyzacji ustawień stawek.
INSERTION_ORDER_AUTOMATION_TYPE_NONE Brak automatyzacji stawek ani budżetu na poziomie zamówienia reklamowego. Stawka i budżet muszą być skonfigurowane ręcznie na poziomie elementu zamówienia.
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET Zezwalaj systemowi na automatyczne dostosowywanie stawek i przesuwanie budżetu do elementów zamówienia, które je obejmują, aby optymalizować skuteczność określoną przez performanceGoal.

InsertionOrderBudgetSegment

Ustawienia, które kontrolują budżet pojedynczego segmentu budżetu.

Zapis JSON 
{
  "budgetAmountMicros": string,
  "description": string,
  "dateRange": {
    object (DateRange)
  },
  "campaignBudgetId": string
}
Pola
budgetAmountMicros

string (int64 format)

Wymagane. Kwota budżetu, jaką zamówienie reklamowe wyda na dany dateRange. Kwota jest wyrażona w mikro. Musi być większy niż 0. Na przykład 500000000 oznacza 500 standardowych jednostek waluty.
description

string

Opis segmentu budżetu. Można go wykorzystać do wpisania informacji o zamówieniu dla każdego segmentu budżetu i umieścić te informacje na fakturach.

Musi być zakodowany w formacie UTF-8.
dateRange

object (DateRange)

Wymagane. Ustawienia daty rozpoczęcia i zakończenia segmentu budżetu. Są one ustalane według strefy czasowej reklamodawcy nadrzędnego.

  • Gdy tworzysz nowy segment budżetu, zarówno startDate, jak i endDate muszą przypadać w przyszłości.
  • Istniejący segment budżetu z wartością startDate w przeszłości ma zmienną wartość endDate, ale niezmienną wartość startDate.
  • endDate musi być datą startDate lub późniejszą, zarówno przed rokiem 2037, jak i nowszy.
campaignBudgetId

string (int64 format)

budgetId budżetu kampanii, do którego należy ten segment budżetu zamówienia reklamowego.

BillableOutcome

Możliwe wyniki podlegające rozliczeniu w przypadku zamówienia reklamowego.

Wartości w polu enum
BILLABLE_OUTCOME_UNSPECIFIED Nieokreślony wynik podlegający rozliczeniu.
BILLABLE_OUTCOME_PAY_PER_IMPRESSION Płacisz za wyświetlenia.
BILLABLE_OUTCOME_PAY_PER_CLICK

Płatność za kliknięcie.
BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION

Płatność za aktywne wyświetlenia.

Metody

create

 Tworzy nowe zamówienie reklamowe.

delete

 Usuwa zamówienie reklamowe.

get

 Pobiera zamówienie reklamowe.

list

 Wyświetla listę zamówień reklamowych reklamodawcy.

listAssignedTargetingOptions

 Wyświetla listę opcji kierowania przypisanych do zamówienia reklamowego w różnych typach kierowania.

patch

 Aktualizuje dotychczasowe zamówienie reklamowe.