- Zasób: kampania
- CampaignGoal
- CampaignGoalType
- PerformanceGoal
- PerformanceGoalType
- CampaignFlight
- CampaignBudget
- ExternalBudgetSource
- PrismaConfig
- PrismaType
- PrismaCpeCode
- Metody
Zasób: Kampania
Jedna kampania.
Zapis JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "displayName": string, "entityStatus": enum ( |
Pola | |
---|---|
name |
Tylko dane wyjściowe. Nazwa zasobu kampanii. |
advertiserId |
Tylko dane wyjściowe. Unikalny identyfikator reklamodawcy, do którego należy kampania. |
campaignId |
Tylko dane wyjściowe. Unikalny identyfikator kampanii. Przypisany przez system. |
displayName |
Wymagany. Wyświetlana nazwa kampanii. Musi być zakodowany w formacie UTF-8 i mieć maksymalny rozmiar 240 bajtów. |
entityStatus |
Wymagany. Określa, czy proponowane zamówienia reklamowe w ramach tej kampanii mogą wydawać budżety i ustalać stawki za zasoby reklamowe.
|
updateTime |
Tylko dane wyjściowe. Sygnatura czasowa określająca, kiedy kampania została ostatnio zaktualizowana. 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ą również przesunięcia inne niż „Z”. Przykłady: |
campaignGoal |
Wymagany. Cel kampanii. |
campaignFlight |
Wymagany. planowane wydatki i czas trwania kampanii; |
frequencyCap |
Wymagany. Ustawienie limitu wyświetleń na użytkownika w kampanii. |
campaignBudgets[] |
Lista budżetów dostępnych dla tej kampanii. Jeśli to pole nie jest ustawione, kampania korzysta z nieograniczonego budżetu. |
CampaignGoal
Ustawienia, które kontrolują cel kampanii.
Zapis JSON |
---|
{ "campaignGoalType": enum ( |
Pola | |
---|---|
campaignGoalType |
Wymagany. Typ celu kampanii. |
performanceGoal |
Wymagany. Cel skuteczności kampanii. Akceptowane wartości
|
CampaignGoalType
Możliwe typy celów kampanii
Wartości w polu enum | |
---|---|
CAMPAIGN_GOAL_TYPE_UNSPECIFIED |
Wartość celu nie została określona lub jest nieznana w tej wersji. |
CAMPAIGN_GOAL_TYPE_APP_INSTALL |
Zwiększanie liczby instalacji aplikacji lub zaangażowania |
CAMPAIGN_GOAL_TYPE_BRAND_AWARENESS |
Zwiększanie świadomości marki lub produktu. |
CAMPAIGN_GOAL_TYPE_OFFLINE_ACTION |
Zwiększanie sprzedaży offline lub sprzedaży w sklepie tradycyjnym. |
CAMPAIGN_GOAL_TYPE_ONLINE_ACTION |
Zwiększ liczbę działań online lub wizyt w witrynie. |
PerformanceGoal
Ustawienia, które kontrolują cel skuteczności kampanii.
Zapis JSON |
---|
{ "performanceGoalType": enum ( |
Pola | |
---|---|
performanceGoalType |
Wymagany. Typ docelowej skuteczności. |
Pole unii performance_goal_value . Wymagany. Wartość celu skuteczności odpowiadająca danemu elementowi performance_goal_type . performance_goal_value może być tylko jednym z tych elementów: |
|
performanceGoalAmountMicros |
Wartość celu w milionowych częściach waluty reklamodawcy. Dotyczy, gdy
Na przykład 1500000 reprezentuje 1,5 standardowej jednostki waluty. |
performanceGoalPercentageMicros |
Ułamek dziesiętny odsetka celu w mikro. Dotyczy, gdy
Na przykład 70000 to 7% (cyfra dziesiętna 0, 07). |
performanceGoalString |
Ciąg znaków kluczowego wskaźnika wydajności (KPI), który może być pusty. Musi być zakodowany w formacie UTF-8 i mieć maksymalnie 100 znaków. Dotyczy to sytuacji, gdy wartość parametru |
PerformanceGoalType
Możliwe typy celów związanych ze skutecznością.
Wartości w polu enum | |
---|---|
PERFORMANCE_GOAL_TYPE_UNSPECIFIED |
Typ celu skuteczności nie jest określony lub jest nieznany w tej wersji. |
PERFORMANCE_GOAL_TYPE_CPM |
Cel skuteczności jest ustawiany w CPM (kosztie tysiąca wyświetleń). |
PERFORMANCE_GOAL_TYPE_CPC |
Cel skuteczności jest ustawiany w CPC (koszt kliknięcia). |
PERFORMANCE_GOAL_TYPE_CPA |
Cel skuteczności jest ustawiany w CPA (koszt działania). |
PERFORMANCE_GOAL_TYPE_CTR |
Docelowa skuteczność jest określana w sposób procentowy (CTR, współczynnik klikalności). |
PERFORMANCE_GOAL_TYPE_VIEWABILITY |
Cel skuteczności jest ustawiany w procentach widoczności. |
PERFORMANCE_GOAL_TYPE_CPIAVC |
Cel skuteczności jest ustawiony jako CPIAVC (koszt pełnego wyświetlenia reklamy wideo z dźwiękiem). |
PERFORMANCE_GOAL_TYPE_CPE |
Cel skuteczności jest ustawiany w CPC (koszt zaangażowania). |
PERFORMANCE_GOAL_TYPE_CPV |
Cel skuteczności jest ustawiany w CPV (koszt obejrzenia). |
PERFORMANCE_GOAL_TYPE_CLICK_CVR |
Cel skuteczności jest ustawiany w sposób procentowy (stosunek konwersji do kliknięć). |
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR |
Cel skuteczności jest ustawiany w procentach współczynnika konwersji na wyświetlenie (konwersje na wyświetlenie). |
PERFORMANCE_GOAL_TYPE_VCPM |
Cel związany z wydajnością jest ustawiany w VCPM (koszt tysiąca widocznych wyświetleń). |
PERFORMANCE_GOAL_TYPE_VTR |
Docelowy wynik jest ustawiany w procentach w sposób analogiczny do współczynnika obejrzeń w YouTube (wyświetleń w YouTube na wyświetlenie). |
PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE |
Cel skuteczności jest ustawiany jako odsetek współczynnika pełnych odtworzeń (pełne odsłuchania na wyświetlenie). |
PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE |
Cel skuteczności jest ustawiany w ujęciu odsetkowym (odsetek pełnych obejrzeń filmu na wyświetlenie). |
PERFORMANCE_GOAL_TYPE_OTHER |
Cel skuteczności ma wartość Inne. |
CampaignFlight
Ustawienia, które śledzą planowany wydatek i długość trwania kampanii.
Zapis JSON |
---|
{
"plannedSpendAmountMicros": string,
"plannedDates": {
object ( |
Pola | |
---|---|
plannedSpendAmountMicros |
Kwota, którą prawdopodobnie wyda kampania w danym Kwota jest wyrażona w mikro. Musi być większa od lub równa 0. Na przykład 500000000 reprezentuje 500 standardowych jednostek waluty. |
plannedDates |
Wymagany. Przewidywane daty trwania kampanii. Są one rozwiązywane w zależności od strefy czasowej reklamodawcy nadrzędnego.
|
CampaignBudget
Ustawienia określające sposób alokacji budżetu kampanii.
Zapis JSON |
---|
{ "budgetId": string, "displayName": string, "budgetUnit": enum ( |
Pola | |
---|---|
budgetId |
Unikalny identyfikator budżetu kampanii. Przypisany przez system. Nie ustawiaj w przypadku nowych budżetów. Musi być uwzględniony podczas aktualizowania lub dodawania budżetów do |
displayName |
Wymagany. Wyświetlana nazwa budżetu. Musi być zakodowany w formacie UTF-8 i mieć maksymalny rozmiar 240 bajtów. |
budgetUnit |
Wymagany. Niezmienna. Określa, czy budżet jest mierzony w walucie czy w liczbie wyświetleń. |
budgetAmountMicros |
Wymagany. Łączna kwota, jaką mogą zaplanować powiązane segmenty zamówienia reklamowego. Kwota jest wyrażona w mikro. Musi być większy niż 0. Na przykład 500000000 reprezentuje 500 standardowych jednostek waluty. |
dateRange |
Wymagany. Zakres dat budżetu kampanii. Połączone segmenty budżetu mogą mieć inny zakres dat. Są one rozwiązywane w zależności od strefy czasowej reklamodawcy nadrzędnego. Wartości |
externalBudgetSource |
Wymagany. Źródło zewnętrzne budżetu. |
externalBudgetId |
Niezmienna. Identyfikator identyfikujący ten budżet w źródle zewnętrznym. Jeśli to pole jest ustawione, a poziom szczegółów faktury w odpowiednim profilu płatności to „Numer zamówienia na poziomie budżetu”, wszystkie wyświetlenia zrealizowane w ramach tego budżetu będą zawierać ten identyfikator na fakturze. Musi być niepowtarzalna w ramach kampanii. |
invoiceGroupingId |
Niezmienna. Identyfikator używany do grupowania budżetów, które mają być uwzględnione na tej samej fakturze. Jeśli to pole jest ustawione, a poziom faktury w odpowiednim profilu płatności ma wartość „Identyfikator grupowania faktur w budżecie”, wszystkie |
prismaConfig |
dodatkowe metadane do wykorzystania przez narzędzie Prisma Mediaocean. Wymagane w przypadku budżetów Mediaocean. Dotyczy to tylko reklamodawców |
ExternalBudgetSource
Źródło zewnętrzne segmentu budżetu kampanii.
Wartości w polu enum | |
---|---|
EXTERNAL_BUDGET_SOURCE_UNSPECIFIED |
Wartość zewnętrznego źródła budżetu nie jest określona lub jest nieznana w tej wersji. |
EXTERNAL_BUDGET_SOURCE_NONE |
Budżet nie ma źródła zewnętrznego. |
EXTERNAL_BUDGET_SOURCE_MEDIA_OCEAN |
Źródło budżetu to Mediaocean. |
PrismaConfig
Ustawienia dotyczące narzędzia Prisma w Mediaocean.
Zapis JSON |
---|
{ "prismaType": enum ( |
Pola | |
---|---|
prismaType |
Wymagany. Typ aplikacji Prisma. |
prismaCpeCode |
Wymagany. odpowiednie kody klienta, produktu i szacowania z narzędzia Prisma firmy Mediaocean; |
supplier |
Wymagany. Identyfikator podmiotu, któremu przypisano ten budżet (platforma DSP, witryna itp.). |
PrismaType
Możliwe typy budżetu Prisma.
Wartości w polu enum | |
---|---|
PRISMA_TYPE_UNSPECIFIED |
Typ nie jest określony lub jest nieznany w tej wersji. |
PRISMA_TYPE_DISPLAY |
Typ wyświetlania. |
PRISMA_TYPE_SEARCH |
Typ wyszukiwania. |
PRISMA_TYPE_VIDEO |
Typ filmu. |
PRISMA_TYPE_AUDIO |
Typ dźwięku. |
PRISMA_TYPE_SOCIAL |
Typ społecznościowy. |
PRISMA_TYPE_FEE |
Typ opłaty. |
PrismaCpeCode
Centrum Google Payments obsługuje wyszukiwanie i filtrowanie według pól komponentów tego kodu.
Zapis JSON |
---|
{ "prismaClientCode": string, "prismaProductCode": string, "prismaEstimateCode": string } |
Pola | |
---|---|
prismaClientCode |
Kod klienta aplikacji Prisma. |
prismaProductCode |
Kod produktu Prisma. |
prismaEstimateCode |
Orientacyjny kod aplikacji Prisma. |
Metody |
|
---|---|
|
Tworzy nową kampanię. |
|
Trwale usuwa kampanię. |
|
Pobiera kampanię. |
|
Wyświetla listę kampanii reklamodawcy. |
|
Wyświetla przypisane opcje kierowania kampanii według typów kierowania. |
|
Aktualizuje istniejącą kampanię. |