- 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 na wstawianie reklam. |
campaignId |
Wymagany. Niezmienna. Unikalny identyfikator kampanii, do której należy zamówienie reklamowe. |
insertionOrderId |
Tylko dane wyjściowe. Unikalny identyfikator zamówienia reklamowego. Przypisany przez system. |
displayName |
Wymagany. Wyświetlana nazwa zamówienia reklamowego. Musi być zakodowany w formacie UTF-8 i mieć maksymalny rozmiar 240 bajtów. |
insertionOrderType |
Opcjonalnie: Typ zamówienia reklamowego. Jeśli to pole nie jest określone podczas tworzenia, domyślnie przyjmuje się wartość |
entityStatus |
Wymagany. Określa, czy zamówienie reklamowe może wykorzystać budżet i ustalać stawki za zasoby reklamowe.
|
updateTime |
Tylko dane wyjściowe. Sygnatura czasowa ostatniej aktualizacji zamówienia na wstawione treści. Przypisany przez system. 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. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: |
partnerCosts[] |
Opcjonalnie: Koszty partnera powiązane z zamówieniem reklamowym. Jeśli w metodzie |
pacing |
Wymagany. Ustawienie tempa wydawania budżetu w zamówieniu reklamowym. Opcja |
frequencyCap |
Wymagany. Ustawienie limitu wyświetleń na użytkownika w zamówieniu reklamowym. |
integrationDetails |
Opcjonalnie: Dodatkowe szczegóły integracji zamówienia reklamowego. |
kpi |
Wymagany. Kluczowy wskaźnik wydajności (KPI) zamówienia reklamowego. W interfejsie Display & Video 360 jest ona określana jako „Cel”. |
budget |
Wymagany. Ustawienia alokacji budżetu zamówienia reklamowego. |
bidStrategy |
Opcjonalnie: 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. |
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. |
KPI
Ustawienia, które kontrolują kluczowy wskaźnik wydajności (KPI) zamówienia reklamowego.
Zapis JSON |
---|
{ "kpiType": enum ( |
Pola | |
---|---|
kpiType |
Wymagany. Typ KPI. |
kpiAlgorithmId |
Opcjonalnie: Identyfikator algorytmu ustalania stawek niestandardowych powiązany z KPI_CUSTOM_IMPRESSION_VALUE_OVER_COST. To pole jest ignorowane, jeśli nie wybierzesz odpowiedniego wskaźnika KPI. |
Pole unii kpi_value . Wymagany. Wartość KPI. Odpowiednie pole odpowiada kpi_type . kpi_value może być tylko jednym z tych elementów: |
|
kpiAmountMicros |
Wartość celu w milionowych częściach waluty reklamodawcy. Dotyczy, gdy
Przykład: 1500000 to 1,5 standardowej jednostki waluty. |
kpiPercentageMicros |
Ułamek dziesiętny odsetka celu w mikro. Dotyczy, gdy
Przykład: 70000 oznacza 7% (cyfra dziesiętna 0,07). |
kpiString |
Ciąg znaków wskaźnika KPI, który może być pusty. Musi być zakodowany w formacie UTF-8 i mieć maksymalnie 100 znaków. Dotyczy to sytuacji, gdy |
KpiType
Możliwe typy kluczowych wskaźników wydajności (KPI).
Wartości w polu enum | |
---|---|
KPI_TYPE_UNSPECIFIED |
W tej wersji nie podano typu KPI lub jest on nieznany. |
KPI_TYPE_CPM |
Wskaźnik KPI to CPM (koszt tysiąca wyświetleń). |
KPI_TYPE_CPC |
Wskaźnik KPI to CPC (koszt kliknięcia). |
KPI_TYPE_CPA |
Wskaźnik KPI to CPA (koszt działania). |
KPI_TYPE_CTR |
Wskaźnik KPI to współczynnik klikalności (CTR). |
KPI_TYPE_VIEWABILITY |
KPI to Współczynnik widoczności. |
KPI_TYPE_CPIAVC |
Wskaźnik KPI to CPIAVC (koszt wyświetlenia z włączonym dźwiękiem, widocznego w momencie zakończenia). |
KPI_TYPE_CPE |
Wskaźnikiem KPI jest CPE (koszt zaangażowania). |
KPI_TYPE_CPV |
Wskaźnik KPI jest ustawiany w sekcji CPV (koszt obejrzenia). |
KPI_TYPE_CLICK_CVR |
Wskaźnik KPI to współczynnik konwersji po kliknięciu (konwersje na kliknięcie) wyrażony w procentach. |
KPI_TYPE_IMPRESSION_CVR |
Wskaźnik KPI to współczynnik konwersji po wyświetleniu (konwersje na wyświetlenie) wyrażony w procentach. |
KPI_TYPE_VCPM |
Wskaźnikiem KPI jest VCPM (koszt tysiąca widocznych wyświetleń). |
KPI_TYPE_VTR |
Wskaźnik KPI to odsetek wyświetleń w YouTube (wyświetlenia w YouTube na wyświetlenie). |
KPI_TYPE_AUDIO_COMPLETION_RATE |
Wskaźnik KPI to odsetek odtworzeń w całości (pełne odsłuchania reklamy audio na wyświetlenie). |
KPI_TYPE_VIDEO_COMPLETION_RATE |
Wskaźnik KPI to współczynnik pełnych obejrzeń (pełne obejrzenia na wyświetlenie). |
KPI_TYPE_CPCL |
Wskaźnik KPI jest ustawiany w CPCL (koszt odsłuchania w całości). |
KPI_TYPE_CPCV |
Wskaźnik KPI jest ustawiany w CPCV (koszt obejrzenia w całości). |
KPI_TYPE_TOS10 |
Wskaźnik ten jest ustawiany w formie współczynnika czasu wyświetlania na ekranie równego 10 s lub dłuższemu (odsetek mierzalnych, niemożliwych do pominięcia wyświetleń, które były widoczne na ekranie przez co najmniej 10 sekund). |
KPI_TYPE_MAXIMIZE_PACING |
KPI jest ustawiony tak, aby maksymalizować wpływ marki, nadając priorytet wykorzystaniu całego budżetu. |
KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST |
Wskaźnik KPI jest ustawiany na podstawie niestandardowej wartości wyświetlenia podzielonej przez koszt. |
KPI_TYPE_OTHER |
Wskaźnik KPI ma inną wartość. |
InsertionOrderBudget
Ustawienia określające sposób przypisywania budżetu zamówienia reklamowego.
Zapis JSON |
---|
{ "budgetUnit": enum ( |
Pola | |
---|---|
budgetUnit |
Wymagany. Niezmienna. Jednostka budżetu określa, czy budżet jest oparty na walucie czy na wyświetleniach. |
automationType |
Opcjonalnie: Typ automatyzacji używanej do zarządzania stawką i budżetem zamówienia reklamowego. Jeśli to pole nie jest określone podczas tworzenia, domyślnie przyjmuje się wartość |
budgetSegments[] |
Wymagany. 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 jest określona lub jest nieznana w tej wersji. |
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET |
Automatyczne przydzielanie budżetu. Zezwalaj systemowi na automatyczne przenoszenie budżetu do elementów zamówienia, które je obejmują, aby optymalizować skuteczność zdefiniowaną przez kpi . 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 kpi . |
InsertionOrderBudgetSegment
Ustawienia, które kontrolują budżet pojedynczego segmentu budżetu.
Zapis JSON |
---|
{
"budgetAmountMicros": string,
"description": string,
"dateRange": {
object ( |
Pola | |
---|---|
budgetAmountMicros |
Wymagany. Kwota budżetu, jaką zamówienie reklamowe wyda na daną |
description |
Opcjonalnie: Opis segmentu budżetu. Możesz go używać do wpisywania informacji o zamówieniu dla każdego segmentu budżetu, które będą drukowane na fakturach. Musi być zakodowany w formacie UTF-8. |
dateRange |
Wymagany. Ustawienia daty rozpoczęcia i zakończenia segmentu budżetu. Są one rozwiązywane w zależności od strefy czasowej reklamodawcy nadrzędnego.
|
campaignBudgetId |
Opcjonalnie: |
OptimizationObjective
Możliwe typy celów optymalizacji.
Wartości w polu enum | |
---|---|
OPTIMIZATION_OBJECTIVE_UNSPECIFIED |
Wartość typu nie została określona lub jest nieznana w tej wersji. |
CONVERSION |
Nadawanie priorytetu wyświetleniom, 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 |
nadawać priorytet 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 zamówienia reklamowe w reklamodawcy. |
|
Wyświetla przypisane opcje kierowania zamówienia reklamowego według typów kierowania. |
|
Aktualizuje dotychczasowe zamówienie reklamowe. |