REST Resource: advertisers.insertionOrders

{
  "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)
}

string

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

Wymagane. Wyświetlana nazwa zamówienia reklamowego.

Musi być zakodowany w standardzie UTF-8 i maksymalnym rozmiarze 240 bajtów.

enum (InsertionOrderType)

Typ zamówienia reklamowego.

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

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 jego utworzeniu zmień stan na ENTITY_STATUS_ACTIVE.
• Zamówienia reklamowego nie można zmienić z powrotem na ENTITY_STATUS_DRAFT z innego stanu.
• Zamówienie reklamowe nie może mieć ustawienia ENTITY_STATUS_ACTIVE, jeśli jego kampania nadrzędna jest nieaktywna.

string (Timestamp format)

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

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

object (PartnerCost)

Koszty partnera związane z zamówieniem reklamowym.

Jeśli nie ma podanej wartości lub nie ma podanej wartości w metodzie insertionOrders.create, nowo utworzone zamówienie reklamowe odziedziczy koszty partnera z ustawień partnera.

object (Pacing)

Wymagane. Ustawienie szybkości wydawania budżetu w zamówieniu reklamowym.

object (FrequencyCap)

Wymagane. Ustawienie ograniczenia liczby wyświetleń zamówienia reklamowego.

object (IntegrationDetails)

Dodatkowe szczegóły integracji zamówienia reklamowego.

object (PerformanceGoal)

Wymagane. Docelowa skuteczność zamówienia reklamowego.

object (InsertionOrderBudget)

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

object (BiddingStrategy)

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

enum (ReservationType)

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

enum (BillableOutcome)

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

Kupowanie na podstawie wyników zostało wycofane. BILLABLE_OUTCOME_PAY_PER_IMPRESSION jest jedyną prawidłową wartością.

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

enum (BudgetUnit)

Wymagane. Stały. Jednostka budżetu określa, czy budżet jest oparty na walucie, czy na wyświetleniach.

enum (InsertionOrderAutomationType)

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

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

object (InsertionOrderBudgetSegment)

Wymagane. Lista segmentów budżetu. Użyj segmentu budżetu, by określić konkretny budżet w wybranym okresie wyświetlania zamówienia reklamowego.

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

string (int64 format)

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

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.

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 stałe pole startDate.
• endDate musi być datą startDate lub późniejszą, zarówno przed rokiem 2037, jak i nowszy.

string (int64 format)

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