Twórz kampanie promujące aplikacje za pomocą interfejsu Google Ads API, aby promować swoją aplikację mobilną w wyszukiwarce, Google Play, YouTube, AdMob, na kartach Discover i w sieci reklamowej Google. Optymalizuj kampanie pod kątem instalacji, działań w aplikacji, wartości konwersji lub rejestracji przed premierą na Androidzie. Włączone kampanie generują standardowe opłaty za wyświetlanie reklam Google Ads do wysokości budżetu.
Przygotowanie
Cel kampanii – koszt instalacji (CPI), koszt działania (CPA), zwrot z nakładów na reklamę (ROAS) lub rejestracje przed premierą – określa ustawienia interfejsu API. Zanim wykonasz czynności związane z tworzeniem celu, znajdź go w tabeli poniżej. Aby znaleźć element sterujący interfejsu Google Ads, zapoznaj się z artykułem Mapowanie ustawień interfejsu Google Ads na pola interfejsu API lub Kampanie promujące aplikacje.
| Wybór celu i interfejsu Google Ads | Typ wyliczeniowy podtypu i celu | Strategia ustalania stawek | Ustawienia konwersji (conversion_actions) |
|---|---|---|---|
|
Więcej instalacji (docelowy CPI). Liczba instalacji > Wszyscy użytkownicy, Ustaw docelowy koszt instalacji (opcjonalnie). |
APP_CAMPAIGN.OPTIMIZE_INSTALLS_TARGET_INSTALL_COST.
|
target_cpa (target_cpa_micros = docelowy CPI).
|
Opcjonalnie. Maksymalnie 1 działanie DOWNLOAD w conversion_actions.
|
|
Więcej instalacji bez docelowego CPI. Liczba instalacji > Wszyscy użytkownicy, Ustaw docelowy koszt instalacji (opcjonalnie) – odznaczone. |
APP_CAMPAIGN.OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST.
|
maximize_conversions (brak target_cpa_micros).
|
Opcjonalnie. Maksymalnie 1 działanie DOWNLOAD.
|
|
Instalacje z działaniem w aplikacji (docelowy CPI). Liczba instalacji > Użytkownicy skłonni wykonać działanie w aplikacji, Docelowy koszt instalacji. |
APP_CAMPAIGN.OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST.
|
target_cpa (target_cpa_micros = docelowy CPI).
|
Parametr wymagany. Jedno działanie w aplikacji i opcjonalne działanie DOWNLOAD.
|
|
Działania w aplikacji (docelowy CPA). Działania w aplikacji, Ustaw docelowy koszt działania w aplikacji (opcjonalnie) (lub Docelowy koszt działania w przypadku zaangażowania). |
APP_CAMPAIGN lub APP_CAMPAIGN_FOR_ENGAGEMENT.OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST.
|
target_cpa (target_cpa_micros = docelowy CPA).
|
Parametr wymagany. Działania po instalacji. Opcjonalnie: DOWNLOAD na APP_CAMPAIGN (brak w przypadku zaangażowania).
|
|
Działania w aplikacji bez docelowego CPA. Działania w aplikacji, Ustaw docelowy koszt działania w aplikacji (opcjonalnie) – odznaczone. |
APP_CAMPAIGN.OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA.
|
maximize_conversions (brak target_cpa_micros).
|
Parametr wymagany. Działania po instalacji oraz opcjonalne działanie DOWNLOAD.
|
|
Wartość działania w aplikacji (docelowy ROAS). Wartość działania w aplikacji, Ustaw docelowy zwrot z nakładów na reklamę (opcjonalnie) (lub Docelowy zwrot z nakładów na reklamę w przypadku zaangażowania). |
APP_CAMPAIGN lub APP_CAMPAIGN_FOR_ENGAGEMENT.OPTIMIZE_RETURN_ON_ADVERTISING_SPEND.
|
target_roas (target_roas = docelowy ROAS).
|
Parametr wymagany. Działania związane z wartością (np. Firebase lub GOOGLE_PLAY_IN_APP_PURCHASE). Opcjonalne tylko w przypadku DOWNLOAD na APP_CAMPAIGN.
|
|
Wartość działania w aplikacji bez docelowego ROAS. Wartość działania w aplikacji, Ustaw docelowy zwrot z nakładów na reklamę (opcjonalnie) – odznaczone. |
APP_CAMPAIGN.OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS.
|
maximize_conversion_value (brak target_roas).
|
Parametr wymagany. Działania związane z wartością (np. Firebase lub GOOGLE_PLAY_IN_APP_PURCHASE) oraz opcjonalne działanie DOWNLOAD.
|
|
Wcześniejsza rejestracja na aplikację (tylko w przypadku Androida). Wcześniejsza rejestracja (Docelowy koszt wcześniejszej rejestracji). |
APP_CAMPAIGN_FOR_PRE_REGISTRATION (tylko GOOGLE_APP_STORE).OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME.
|
target_cpa (target_cpa_micros = docelowy koszt wcześniejszej rejestracji).
|
Pozostaw pole selective_optimization nieustawione. Dodaj APP_PRE_REGISTRATION do optimization_goal_types.
|
Kroki
Utwórz wszystkie zasoby niepodzielnie w jednym żądaniu GoogleAdsService.Mutate, używając ujemnych tymczasowych identyfikatorów, lub wywołaj CampaignService.MutateCampaigns.
Konfigurowanie i tworzenie kampanii
Skonfiguruj zasób Campaign:
Utwórz dzienny
CampaignBudgetdlacampaign_budgetzamount_microsiexplicitly_sharedustawionymi nafalse(domyślnietrue; budżety wspólne iCUSTOM_PERIODnie działają). Zobacz Tworzenie budżetów kampanii.Ustaw
namei opcjonalnie ustawstatusnaPAUSEDpodczas dołączania reklam (domyślnieENABLED).Ustaw niezmienną wartość
advertising_channel_typenaMULTI_CHANNELi niezmienną wartośćadvertising_channel_sub_typenaAPP_CAMPAIGN,APP_CAMPAIGN_FOR_ENGAGEMENTlubAPP_CAMPAIGN_FOR_PRE_REGISTRATION.Ustaw
contains_eu_political_advertisingnaDOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISINGlubCONTAINS_EU_POLITICAL_ADVERTISING. Samodzielne wywołaniaMutateCampaignswymagają tej deklaracji dotyczącej Unii Europejskiej (UE) (opcjonalnie w przypadku wersji 26 i nowszych, gdy kierowanie dotyczy tylko lokalizacji spoza UE; patrz reklamy polityczne w UE).Ustaw
app_campaign_settingna obiektAppCampaignSetting(app_storeiapp_idsą niezmienne):app_store:AppCampaignAppStore(GOOGLE_APP_STORElubAPPLE_APP_STORE; rejestracja przed premierą wymagaGOOGLE_APP_STORE).app_id: nazwa pakietu Google Play (com.example.app) lub identyfikator numeryczny sklepu z aplikacjami Apple. Zaangażowanie wymaga minimalnej liczby instalacji, a rejestracja przed premierą wymaga nieopublikowanej aplikacji z rejestracją przed premierą w Konsoli Play (nie kwalifikuje się doAPP_CAMPAIGNdo momentu wprowadzenia na rynek).bidding_strategy_goal_type:AppCampaignBiddingStrategyGoalTypedla celu (zmienny).
Ustaw standardową strategię ustalania stawek w zasobie
Campaign(zasoby portfolioBiddingStrategynie są obsługiwane). Przełączenie opcjonalnego celu w interfejsie powoduje zmianę zarówno polabidding_strategy_goal_type, jak i pola określania stawekoneof:- Docelowy CPI, CPA lub rejestracja przed premierą: ustaw
target_cpaz dodatnią wartościątarget_cpa_microsw mikrowalucie konta (1500000= 1,50 jednostki, np. 1,50 USD). - Docelowy ROAS: ustaw
target_roasztarget_roasod0.01do1000.0(3.0= 300% ROAS). - Maksymalizacja bez wartości docelowej (tylko
APP_CAMPAIGN): ustaw pustą wartośćmaximize_conversionslubmaximize_conversion_value. Nie ustawiajmaximize_conversions.target_cpa_micros(odrzuconoMULTI_CHANNEL) animaximize_conversion_value.target_roas.
- Docelowy CPI, CPA lub rejestracja przed premierą: ustaw
Skonfiguruj cele konwersji lub rejestracji przed premierą:
APP_CAMPAIGNiAPP_CAMPAIGN_FOR_ENGAGEMENT: dodaj nazwy zasobówConversionActionpasujące doapp_iddoselective_optimization.conversion_actions(nie doCampaignConversionGoalani dooptimization_goal_setting; patrz Cele konwersji kampanii). W przypadkuAPP_CAMPAIGNuwzględnij maksymalnie 1 działanieDOWNLOAD, np.GOOGLE_PLAY_DOWNLOADlub Firebasefirst_open(wymagane w interfejsie, opcjonalne w interfejsie API, niedozwolone w przypadku zaangażowania).APP_CAMPAIGN_FOR_PRE_REGISTRATION: pozostawselective_optimizationbez ustawienia i dodajAPP_PRE_REGISTRATIONdooptimization_goal_setting.optimization_goal_types.
Opcjonalnie: od wersji 24 ustaw parametr
view_through_conversion_optimization_enablednatruew kampaniach na AndroidaAPP_CAMPAIGN, aby określać stawki pod kątem konwersji po wyświetleniu (VTC) (domyślna wartość w interfejsie:true, domyślna wartość w interfejsie API:false).Opcjonalnie: ustaw
start_date_time(00:00:00, dzisiaj lub później) iend_date_time(23:59:59) w strefie czasowej konta (yyyy-MM-dd HH:mm:ss). WywołajMutateCampaignslubGoogleAdsService.Mutate.
Opcjonalnie: dodaj kierowanie i wykluczenia kampanii
Doprecyzuj kierowanie po utworzeniu lub w tym samym żądaniu GoogleAdsService.Mutate:
- Lokalizacje i języki: dodaj zasoby
CampaignCriterionza pomocąCampaignCriterionService.MutateCampaignCriteria, np. kryterialanguageilocation(patrz Kryteria). - Listy wykluczających słów kluczowych: połącz
CampaignSharedSetzNEGATIVE_KEYWORDSSharedSet(patrz Udostępnione zestawy). - Odbiorcy: dołącz wymagane kryteria
UserListInfo(APP_CAMPAIGN_FOR_ENGAGEMENT) lub opcjonalne sygnałyAudienceInfo(APP_CAMPAIGN) do grup reklam aplikacji (patrz Tworzenie grupy reklam i reklamy promującej aplikację).
Mapowanie ustawień interfejsu Google Ads na pola interfejsu API
Użyj tej tabeli, aby zmapować elementy sterujące interfejsu Google Ads na pola interfejsu Google Ads API (Określanie stawek i budżet w przypadku instalacji aplikacji lub Budżet i określanie stawek w przypadku zaangażowania i rejestracji przed premierą).
| Sekcja i etykieta interfejsu Google Ads | Zasób i pole interfejsu API | Szczegóły |
|---|---|---|
| Aplikacja > Wybierz podtyp kampanii (Instalacje aplikacji, Zaangażowanie w aplikację, Wcześniejsza rejestracja na aplikację (tylko w przypadku Androida)). |
Campaign.advertising_channel_type,
Campaign.advertising_channel_sub_type.
|
Niezmienne: MULTI_CHANNEL z APP_CAMPAIGN, APP_CAMPAIGN_FOR_ENGAGEMENT lub APP_CAMPAIGN_FOR_PRE_REGISTRATION.
|
| Ustawienia kampanii > Nazwa kampanii. |
Campaign.name.
|
Wymagana wyświetlana nazwa na koncie klienta. |
| Ustawienia kampanii > Aplikacja mobilna. |
Campaign.app_campaign_setting.app_store,
Campaign.app_campaign_setting.app_id.
|
Niezmienne: GOOGLE_APP_STORE (nazwa pakietu; wymagana do rejestracji przed premierą) lub APPLE_APP_STORE (identyfikator numeryczny).
|
| Ustawienia kampanii > Lokalizacje i Języki. |
CampaignCriterion
(location,
language).
|
Dodano za pomocą MutateCampaignCriteria lub niepodzielnego GoogleAdsService.Mutate.
|
| Ustawienia kampanii > Optymalizacja konwersji po wyświetleniu > Włącz konwersje po wyświetleniu. |
Campaign.view_through_conversion_optimization_enabled.
|
Tylko Android APP_CAMPAIGN (wersja 24 lub nowsza). Domyślna wartość to true w interfejsie i false w interfejsie API.
|
| Ustawienia kampanii > Reklamy polityczne w UE (Czy Twoja kampania zawiera reklamy polityczne w Unii Europejskiej?). |
Campaign.contains_eu_political_advertising.
|
Mapuje opcje Tak, ta kampania zawiera reklamy polityczne w UE i Nie, ta kampania nie zawiera reklam politycznych w UE. |
| Ustawienia kampanii > Daty rozpoczęcia i zakończenia. |
Campaign.start_date_time,
Campaign.end_date_time.
|
Opcjonalne sygnatury czasowe w strefie czasowej konta (00:00:00 dzisiaj lub później oraz 23:59:59).
|
| Ustalanie stawek i budżet > Budżet. |
CampaignBudget.amount_micros,
Campaign.campaign_budget.
|
Wartości mikro dziennie w walucie konta, gdy parametr CampaignBudget.explicitly_shared ma wartość false.
|
|
Określanie stawek i budżet > Określanie stawek > Na czym chcesz się skupić? i Na jakich użytkowników chcesz kierować reklamy? Ustaw docelowy koszt instalacji (opcjonalnie), Ustaw docelowy koszt działania w aplikacji (opcjonalnie) i Ustaw docelowy zwrot z nakładów na reklamę (opcjonalnie). Docelowy koszt instalacji, Docelowy koszt działania i Docelowy zwrot z nakładów na reklamę. |
Campaign.app_campaign_setting.bidding_strategy_goal_type,
Campaign.target_cpa.target_cpa_micros,
Campaign.target_roas.target_roas,
Campaign.maximize_conversions,
Campaign.maximize_conversion_value.
|
Ustawia zarówno typ wyliczeniowy celu, jak i pole oneof określania stawek (patrz Przygotowanie). Strategie inne niż docelowe mają zastosowanie tylko do: APP_CAMPAIGN. W przypadku iOS Optymalizuj pod kątem wartości konwersji SKAdNetwork jest dostępna tylko w interfejsie (odczytuj schematy za pomocą CustomerSkAdNetworkConversionValueSchema).
|
|
Określanie stawek i budżet > Określanie stawek > Jak chcesz monitorować liczbę instalacji? Które działanie jest dla Ciebie najważniejsze? i Które działania są dla Ciebie najważniejsze? |
Campaign.selective_optimization.conversion_actions.
|
Selektor instalacji dodaje maksymalnie DOWNLOAD działanie (tylko APP_CAMPAIGN). Selektory działań dodają jedno (liczba pojedyncza) lub wiele (liczba mnoga) działań pasujących do: app_id.
|
| Budżet i ustalanie stawek > Ustalanie stawek > Wcześniejsza rejestracja i Docelowy koszt wcześniejszej rejestracji. |
Campaign.target_cpa.target_cpa_micros,
Campaign.optimization_goal_setting.optimization_goal_types.
|
Używa OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME i APP_PRE_REGISTRATION (pozostaw selective_optimization nieustawione).
|
Przykładowy kod i dalsze kroki
Dołącz grupę reklam i komponenty kreacji, aby kampania mogła wyświetlać reklamy:
- Utwórz grupę reklam aplikacji i reklamę aplikacji: dodaj zasób
AdGroup(z wymaganymi kryteriamiUserListInfowAPP_CAMPAIGN_FOR_ENGAGEMENT) i reklamę aplikacji. - Przykładowy kod kampanii promującej aplikację: zapoznaj się z
AddAppCampaign, czyli wielojęzycznym przykładem tworzenia budżetu, kampanii, kryteriów, grupy reklam i reklamy. - Raporty dotyczące kampanii promujących aplikacje: możesz wysyłać zapytania o dane dotyczące kampanii, komponentów, instalacji i SKAdNetwork za pomocą języka zapytań Google Ads.