- Zasób: InsertionOrder
- InsertionOrderType
- KPI
- KpiType
- InsertionOrderBudget
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
- OptimizationObjective
- Metody
Zasób: InsertionOrder
pojedyncze 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 |
Wymagane. Stała. 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 |
Wymagane. Wyświetlana nazwa zamówienia reklamowego. Musi być zakodowany w standardzie UTF-8 i maksymalnym rozmiarze 240 bajtów. |
insertionOrderType |
Typ zamówienia reklamowego. Jeśli podczas tworzenia nie określono tego pola, domyślna wartość to |
entityStatus |
Wymagane. Określa, czy zamówienie reklamowe może wydawać budżet i ustalać stawki za zasoby reklamowe.
|
updateTime |
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: |
partnerCosts[] |
Koszty partnera związane z zamówieniem reklamowym. Jeśli nie ma podanej wartości lub nie ma podanej wartości w metodzie |
pacing |
Wymagane. Ustawienie szybkości wydawania budżetu w zamówieniu reklamowym. |
frequencyCap |
Wymagane. Ustawienie ograniczenia liczby wyświetleń zamówienia reklamowego. |
integrationDetails |
Dodatkowe szczegóły integracji zamówienia reklamowego. |
kpi |
Wymagane. Kluczowy wskaźnik wydajności (KPI) zamówienia reklamowego Jest to tzw. „cel”. w obszarze Display & Interfejs usługi Video 360. |
budget |
Wymagane. Ustawienia alokacji budżetu zamówienia reklamowego. |
bidStrategy |
Strategia ustalania stawek zamówienia reklamowego. Domyślnie ustawiona jest wartość |
reservationType |
Tylko dane wyjściowe. Typ rezerwacji zamówienia reklamowego. |
optimizationObjective |
Opcjonalnie: Cel optymalizacji zamówienia reklamowego. To pole jest dostępne tylko dla klientów z listy dozwolonych. Jeśli klient nie znajduje się na liście dozwolonych, to pole będzie mieć wartość null, a próba jego ustawienia spowoduje zwrócenie błędu. |
InsertionOrderType
Możliwe typy zamówienia reklamowego.
Typ zamówienia reklamowego określa, które ustawienia i opcje mają zastosowanie, np. format reklam czy opcje kierowania.
Wartości w polu enum | |
---|---|
INSERTION_ORDER_TYPE_UNSPECIFIED |
Typ zamówienia reklamowego nie został określony lub nieznany. |
RTB |
Określanie stawek w czasie rzeczywistym. |
OVER_THE_TOP |
Over-The-Top. |
KPI
Ustawienia sterujące kluczowym wskaźnikiem wydajności (KPI) zamówienia reklamowego.
Zapis JSON |
---|
{ "kpiType": enum ( |
Pola | |
---|---|
kpiType |
Wymagane. Typ KPI. |
kpiAlgorithmId |
Opcjonalnie: Identyfikator algorytmu ustalania stawek niestandardowych powiązany z KPI_CUSTOM_IMPRESSION_VALUE_OVER_COST. Jeśli nie wybierzesz odpowiedniego KPI, to pole zostanie zignorowane. |
Pole sumy kpi_value . Wymagane. Wartość KPI. Odpowiednie pole odpowiada atrybutowi kpi_type . kpi_value może mieć tylko jedną z tych wartości: |
|
kpiAmountMicros |
Kwota docelowa w milionowych częściach waluty reklamodawcy. Ma zastosowanie, gdy
Na przykład 1500000 oznacza 1,5 standardowej jednostki waluty. |
kpiPercentageMicros |
Wartość dziesiętna określająca odsetek celu w mikro. Ma zastosowanie, gdy
Na przykład 70 000 oznacza 7% (0,07 w formacie dziesiętnym). |
kpiString |
Ciąg znaków wskaźnika KPI, który może być pusty. Musi być zakodowany w formacie UTF-8 i nie może być dłuższy niż 100 znaków. Obowiązuje, gdy |
KpiType
Możliwe typy kluczowych wskaźników wydajności (KPI).
Wartości w polu enum | |
---|---|
KPI_TYPE_UNSPECIFIED |
Typ KPI nie został określony lub jest nieznany w tej wersji. |
KPI_TYPE_CPM |
KPI to CPM (koszt tysiąca wyświetleń). |
KPI_TYPE_CPC |
KPI to koszt kliknięcia (CPC). |
KPI_TYPE_CPA |
KPI to CPA (koszt działania). |
KPI_TYPE_CTR |
Wskaźnik KPI to procentowy CTR (współczynnik klikalności). |
KPI_TYPE_VIEWABILITY |
KPI to odsetek widoczności. |
KPI_TYPE_CPIAVC |
KPI to CPIAVC (koszt wyświetlenia z włączonym dźwiękiem i widocznym w momencie zakończenia). |
KPI_TYPE_CPE |
Wskaźnik KPI to CPE (koszt zaangażowania). |
KPI_TYPE_CPV |
Wskaźnik KPI jest określony jako CPV (koszt obejrzenia). |
KPI_TYPE_CLICK_CVR |
KPI to procentowy współczynnik konwersji po kliknięciu (konwersje na kliknięcie). |
KPI_TYPE_IMPRESSION_CVR |
KPI to procentowy współczynnik konwersji wyświetleń (konwersje na wyświetlenie). |
KPI_TYPE_VCPM |
KPI to vCPM (koszt tysiąca widocznych wyświetleń). |
KPI_TYPE_VTR |
KPI to współczynnik obejrzeń w YouTube (liczba obejrzeń w YouTube na wyświetlenie). |
KPI_TYPE_AUDIO_COMPLETION_RATE |
KPI to współczynnik pełnych obejrzeń (odsłuchań audio na wyświetlenie). |
KPI_TYPE_VIDEO_COMPLETION_RATE |
KPI to współczynnik pełnych obejrzeń (pełne obejrzenia filmu na wyświetlenie). |
KPI_TYPE_CPCL |
KPI określa się w CPCL (koszt pełnego odsłuchania dźwięku). |
KPI_TYPE_CPCV |
KPI określa się według CPCV (kosztu pełnego wyświetlenia filmu). |
KPI_TYPE_TOS10 |
KPI określa się jako czas, przez jaki ekran był widoczny na ekranie przez co najmniej 10 sekund (odsetek wymiernych, niemożliwych do pominięcia wyświetleń, które były widoczne na ekranie przez co najmniej 10 sekund). |
KPI_TYPE_MAXIMIZE_PACING |
Wskaźnik KPI jest ustawiony tak, aby maksymalizować wpływ marki przy priorytetowym traktowaniu wykorzystania całego budżetu. |
KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST |
KPI jest ustawiany jako niestandardowa wartość wyświetleń podzielona przez koszt. |
KPI_TYPE_OTHER |
Wskaźnik KPI to inna wartość. |
InsertionOrderBudget
Ustawienia, które określają sposób przydzielania budżetu zamówienia reklamowego.
Zapis JSON |
---|
{ "budgetUnit": enum ( |
Pola | |
---|---|
budgetUnit |
Wymagane. Stała. Jednostka budżetu określa, czy budżet jest oparty na walucie, czy na wyświetleniach. |
automationType |
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 |
budgetSegments[] |
Wymagane. Lista segmentów budżetu. Użyj segmentu budżetu, aby określić konkretny budżet w wybranym okresie 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 kpi . Brak automatyzacji ustawień stawek. |
INSERTION_ORDER_AUTOMATION_TYPE_NONE |
Brak automatyzacji stawek i budżetów 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 automatycznie dostosowywać stawki i przenosić budżet do własnych elementów zamówienia, aby zoptymalizować skuteczność określoną przez zasadę kpi . |
InsertionOrderBudgetSegment
Ustawienia sterujące budżetem pojedynczego segmentu budżetu.
Zapis JSON |
---|
{
"budgetAmountMicros": string,
"description": string,
"dateRange": {
object ( |
Pola | |
---|---|
budgetAmountMicros |
Wymagane. Kwota budżetu, jaką zamówienie reklamowe wyda w danym okresie ( |
description |
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 |
Wymagane. Ustawienia daty rozpoczęcia i zakończenia segmentu budżetu. Są one ustalane według strefy czasowej reklamodawcy nadrzędnego.
|
campaignBudgetId |
|
OptimizationObjective
Możliwe typy celów optymalizacji.
Wartości w polu enum | |
---|---|
OPTIMIZATION_OBJECTIVE_UNSPECIFIED |
Wartość typu nie jest określona lub jest nieznana w tej wersji. |
CONVERSION |
Traktuj priorytetowo wyświetlenia, które zwiększają sprzedaż i liczbę konwersji. |
CLICK |
Nadawanie priorytetu wyświetleniom, które zwiększają ruch w witrynie, aplikacji lub sklepie z aplikacjami. |
BRAND_AWARENESS |
Nadawanie priorytetu wyświetleniom o określonej jakości. |
CUSTOM |
Cel jest definiowany przez przypisany algorytm ustalania stawek niestandardowych. |
NO_OBJECTIVE |
Niezdefiniowany cel. Możesz użyć dowolnego KPI lub dowolnej strategii ustalania stawek. |
Metody |
|
---|---|
|
Tworzy nowe zamówienie reklamowe. |
|
Usuwa zamówienie reklamowe. |
|
Pobiera zamówienie reklamowe. |
|
Wyświetla listę zamówień reklamowych reklamodawcy. |
|
Wyświetla listę opcji kierowania przypisanych do zamówienia reklamowego w różnych typach kierowania. |
|
Aktualizuje dotychczasowe zamówienie reklamowe. |