- Zasób: insertionOrder
- InsertionOrderType
- InsertionOrderBudget
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
- BillableOutcome
- Metody
Zasób: insertionOrder
Jedno zamówienie reklamowe.
Zapis JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "displayName": string, "insertionOrderType": enum ( |
Pola | |
---|---|
name |
Tylko dane wyjściowe. Nazwa zasobu zamówienia reklamowego. |
advertiserId |
Tylko dane wyjściowe. Unikalny identyfikator reklamodawcy, do którego należy zamówienie reklamowe. |
campaignId |
To pole jest wymagane. Niezmienne. Unikalny identyfikator kampanii, do której należy zamówienie reklamowe. |
insertionOrderId |
Tylko dane wyjściowe. Unikalny identyfikator zamówienia reklamowego. Przypisana przez system. |
displayName |
To pole jest wymagane. Wyświetlana nazwa zamówienia reklamowego. Musi być zakodowany w formacie UTF-8 o maksymalnym rozmiarze 240 bajtów. |
insertionOrderType |
Typ zamówienia reklamowego. Jeśli podczas tworzenia tego pola nie określono inaczej, domyślnie przyjmuje się wartość |
entityStatus |
To pole jest wymagane. Określa, czy zamówienie reklamowe może wydać budżet i ustalać stawki na zasoby reklamowe.
|
updateTime |
Tylko dane wyjściowe. Sygnatura czasowa ostatniej aktualizacji zamówienia reklamowego. Przypisana przez system. Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
partnerCosts[] |
Koszty partnera związane z zamówieniem reklamowym. Jeśli w metodzie |
pacing |
To pole jest wymagane. Ustawienie szybkości wydawania budżetu zamówienia reklamowego. |
frequencyCap |
To pole jest wymagane. Ustawienie ograniczenia liczby wyświetleń zamówienia reklamowego. |
integrationDetails |
Dodatkowe szczegóły integracji zamówienia reklamowego. |
performanceGoal |
To pole jest wymagane. Cel skuteczności zamówienia reklamowego. |
budget |
To pole jest wymagane. Ustawienia alokacji budżetu zamówienia reklamowego. |
bidStrategy |
Strategia ustalania stawek zamówienia reklamowego. Domyślnie ustawiona jest zasada |
reservationType |
Tylko dane wyjściowe. Typ rezerwacji zamówienia reklamowego. |
billableOutcome |
Niezmienne. Wynik zamówienia reklamowego podlegającego rozliczeniu. Kupowanie na podstawie wyników zostało wycofane. Jedyną prawidłową wartością jest |
InsertionOrderType
Możliwe typy zamówienia reklamowego.
Typ zamówienia reklamowego określa, które ustawienia i opcje, takie jak format reklam czy opcje kierowania, mają zastosowanie.
Wartości w polu enum | |
---|---|
INSERTION_ORDER_TYPE_UNSPECIFIED |
Nie określono typu zamówienia reklamowego lub jest on nieznany. |
RTB |
Określanie stawek w czasie rzeczywistym |
OVER_THE_TOP |
Over-The-Top. |
InsertionOrderBudget
Ustawienia kontrolujące sposób przydzielania budżetu zamówienia reklamowego.
Zapis JSON |
---|
{ "budgetUnit": enum ( |
Pola | |
---|---|
budgetUnit |
To pole jest wymagane. Niezmienne. Jednostka budżetowa określa, czy budżet jest oparty na walucie, czy na wyświetleniach. |
automationType |
Typ automatyzacji służący do zarządzania stawką i budżetem zamówienia reklamowego. Jeśli podczas tworzenia tego pola nie określono inaczej, domyślnie przyjmuje się wartość |
budgetSegments[] |
To pole jest wymagane. Lista segmentów budżetu. Segment budżetu pozwala określić konkretny budżet w czasie trwania 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 jest określona lub jest w tej wersji nieznana. |
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET |
Automatyczne przydzielanie budżetu. Pozwól systemowi automatycznie przenosić budżet na własność elementów zamówienia, aby optymalizować skuteczność określoną przez performanceGoal . Brak automatyzacji w ustawieniach stawek. |
INSERTION_ORDER_AUTOMATION_TYPE_NONE |
Brak automatyzacji ustalania stawek i budżetu na poziomie zamówienia reklamowego. Stawki i budżet trzeba skonfigurować ręcznie na poziomie elementu zamówienia. |
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET |
Pozwól systemowi na automatyczne dostosowywanie stawek i przenoszenie budżetu na własność elementów zamówienia, co pozwala 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 ( |
Pola | |
---|---|
budgetAmountMicros |
To pole jest wymagane. Kwota budżetu, którą wydarzy zamówienie reklamowe w danym okresie ( |
description |
Opis segmentu budżetu. Pozwala wprowadzić informacje o zamówieniu dla każdego segmentu budżetu i wyświetlać je na fakturach. Musi być zakodowany w formacie UTF-8. |
dateRange |
To pole jest wymagane. Ustawienia daty rozpoczęcia i zakończenia segmentu budżetu. Są one ustalane względem strefy czasowej reklamodawcy nadrzędnego.
|
campaignBudgetId |
|
BillableOutcome
Skutki zamówienia reklamowego podlegające rozliczeniu.
Wartości w polu enum | |
---|---|
BILLABLE_OUTCOME_UNSPECIFIED |
Nieokreślony wynik podlegający rozliczeniu. |
BILLABLE_OUTCOME_PAY_PER_IMPRESSION |
Płatność za wyświetlenia. |
BILLABLE_OUTCOME_PAY_PER_CLICK |
Płatność za kliknięcie. |
BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION |
Płatność za Widok aktywny. |
Metody |
|
---|---|
|
Wyświetla listę opcji kierowania przypisanych do zamówienia reklamowego według różnych typów kierowania. |
|
Tworzy nowe zamówienie reklamowe. |
|
Usuwa zamówienie reklamowe. |
|
Pobiera zamówienie reklamowe. |
|
Wyświetla listę zamówień reklamowych na poziomie reklamodawcy. |
|
Aktualizuje istniejące zamówienie reklamowe. |