Page Summary
-
App campaigns in the Google Ads API support different goals, including getting more installs, finding users likely to install and perform in-app actions, finding users most likely to complete specific in-app actions, driving in-app action value, and driving app pre-registrations.
-
The settings for specific campaign types, such as
advertising_channel_sub_type,app_campaign_setting.bidding_strategy_goal_type, and bidding strategy, vary depending on the chosen campaign focus. -
App campaigns in the Google Ads API have an
advertising_channel_typeofMULTI_CHANNELand cannot use a shared campaign budget or a portfolio bidding strategy. -
Selective optimization is used to indicate the conversion types for which Google Ads should optimize your campaign and is required for
APP_CAMPAIGN_FOR_ENGAGEMENTcampaigns, automatically added forAPP_CAMPAIGN_FOR_PRE_REGISTRATIONcampaigns, and optional otherwise. -
Campaign targeting can be refined by adding
CampaignCriterionobjects for language and location.
Create App campaigns with the Google Ads API to promote your mobile app across Search, Google Play, YouTube, AdMob, Discover, and the Google Display Network. Optimize campaigns for installs, in-app actions, conversion value, or Android pre-registrations. Enabled campaigns incur standard Google Ads ad serving charges up to your budget.
Preparation
Your campaign goal—cost per install (CPI), cost per action (CPA), return on ad spend (ROAS), or pre-registrations—determines your API settings. Find your goal in the following table before completing the creation steps. To look up a Google Ads UI control, see Map Google Ads UI settings to API fields, or see About App campaigns.
| Goal and Google Ads UI selection | Subtype and goal enum | Bidding strategy | Conversion settings (conversion_actions) |
|---|---|---|---|
|
More installs (target CPI). Install volume > All users, Set a target cost per install (optional) selected. |
APP_CAMPAIGN.OPTIMIZE_INSTALLS_TARGET_INSTALL_COST.
|
target_cpa
(target_cpa_micros
= target CPI).
|
Optional. Up to one
DOWNLOAD
action in
conversion_actions.
|
|
More installs without target CPI. Install volume > All users, Set a target cost per install (optional) cleared. |
APP_CAMPAIGN.OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST.
|
maximize_conversions
(no target_cpa_micros).
|
Optional. Up to one DOWNLOAD action.
|
|
Installs with in-app action (target CPI). Install volume > Users likely to perform an in-app action, Target cost per install. |
APP_CAMPAIGN.OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST.
|
target_cpa (target_cpa_micros = target
CPI).
|
Required. One in-app action, plus optional
DOWNLOAD action.
|
|
In-app actions (target CPA). In-app actions, Set a target cost per in-app action (optional) selected (or Target cost per action for engagement). |
APP_CAMPAIGN or
APP_CAMPAIGN_FOR_ENGAGEMENT.OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST.
|
target_cpa (target_cpa_micros = target
CPA).
|
Required. Post-install actions. Optional
DOWNLOAD on APP_CAMPAIGN (none on
engagement).
|
|
In-app actions without target CPA. In-app actions, Set a target cost per in-app action (optional) cleared. |
APP_CAMPAIGN.OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA.
|
maximize_conversions (no
target_cpa_micros).
|
Required. Post-install actions, plus optional
DOWNLOAD action.
|
|
In-app action value (target ROAS). In-app action value, Set a target return on ad spend (optional) selected (or Target return on ad spend for engagement). |
APP_CAMPAIGN or
APP_CAMPAIGN_FOR_ENGAGEMENT.OPTIMIZE_RETURN_ON_ADVERTISING_SPEND.
|
target_roas
(target_roas
= target ROAS).
|
Required. Value actions (such as
Firebase or
GOOGLE_PLAY_IN_APP_PURCHASE).
Optional DOWNLOAD on APP_CAMPAIGN only.
|
|
In-app action value without target ROAS. In-app action value, Set a target return on ad spend (optional) cleared. |
APP_CAMPAIGN.OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS.
|
maximize_conversion_value
(no target_roas).
|
Required. Value actions (such as Firebase or
GOOGLE_PLAY_IN_APP_PURCHASE), plus optional
DOWNLOAD action.
|
|
App pre-registrations (Android only). Pre-registration (Target cost per pre-registration). |
APP_CAMPAIGN_FOR_PRE_REGISTRATION
(GOOGLE_APP_STORE only).OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME.
|
target_cpa (target_cpa_micros = target
cost per pre-registration).
|
Leave selective_optimization unset. Add
APP_PRE_REGISTRATION
to
optimization_goal_types.
|
Steps
Create all resources atomically in one
GoogleAdsService.Mutate request by
using negative temporary IDs, or call
CampaignService.MutateCampaigns.
Configure and create the campaign
Configure the Campaign resource:
Create a daily
CampaignBudgetforcampaign_budgetwithamount_microsandexplicitly_sharedset tofalse(defaults totrue; shared andCUSTOM_PERIODbudgets fail). See Create campaign budgets.Set
name, and optionally setstatustoPAUSEDwhile attaching ads (defaults toENABLED).Set immutable
advertising_channel_typetoMULTI_CHANNELand immutableadvertising_channel_sub_typetoAPP_CAMPAIGN,APP_CAMPAIGN_FOR_ENGAGEMENT, orAPP_CAMPAIGN_FOR_PRE_REGISTRATION.Set
contains_eu_political_advertisingtoDOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISINGorCONTAINS_EU_POLITICAL_ADVERTISING. StandaloneMutateCampaignscalls require this European Union (EU) declaration (optional in v26 and later when atomically targeting only non-EU locations; see EU political ads).Set
app_campaign_settingto anAppCampaignSettingobject (app_storeandapp_idare immutable):app_store:AppCampaignAppStore(GOOGLE_APP_STOREorAPPLE_APP_STORE; pre-registration requiresGOOGLE_APP_STORE).app_id: Google Play package name (com.example.app) or Apple App Store numeric ID. Engagement requires minimum installs; pre-registration requires an unreleased Play Console pre-registration app (ineligible forAPP_CAMPAIGNuntil launch).bidding_strategy_goal_type:AppCampaignBiddingStrategyGoalTypefor your goal (mutable).
Set a standard bidding strategy on
Campaign(portfolioBiddingStrategyresources aren't supported). Toggling an optional UI target switches bothbidding_strategy_goal_typeand the biddingoneoffield:- Target CPI, CPA, or pre-registration: Set
target_cpawith positivetarget_cpa_microsin account currency micros (1500000= 1.50 units, such as $1.50 USD). - Target ROAS: Set
target_roaswithtarget_roasfrom0.01to1000.0(3.0= 300% ROAS). - Maximize without target (
APP_CAMPAIGNonly): Set emptymaximize_conversionsormaximize_conversion_value. Don't setmaximize_conversions.target_cpa_micros(rejected onMULTI_CHANNEL) ormaximize_conversion_value.target_roas.
- Target CPI, CPA, or pre-registration: Set
Configure conversion or pre-registration goals:
APP_CAMPAIGNandAPP_CAMPAIGN_FOR_ENGAGEMENT: AddConversionActionresource names matchingapp_idtoselective_optimization.conversion_actions(notCampaignConversionGoaloroptimization_goal_setting; see Campaign conversion goals). OnAPP_CAMPAIGN, include up to oneDOWNLOADaction, such asGOOGLE_PLAY_DOWNLOADor Firebasefirst_open(UI-required, API-optional, prohibited on engagement).APP_CAMPAIGN_FOR_PRE_REGISTRATION: Leaveselective_optimizationunset, and addAPP_PRE_REGISTRATIONtooptimization_goal_setting.optimization_goal_types.
Optional: Starting in v24, set
view_through_conversion_optimization_enabledtotrueon AndroidAPP_CAMPAIGNcampaigns for view-through conversion (VTC) bidding (UI defaulttrue, API defaultfalse).Optional: Set
start_date_time(00:00:00, today or later) andend_date_time(23:59:59) in the account's time zone (yyyy-MM-dd HH:mm:ss). CallMutateCampaignsorGoogleAdsService.Mutate.
Optional: Add campaign targeting and exclusions
Refine targeting after creation or in the same GoogleAdsService.Mutate
request:
- Locations and languages: Add
CampaignCriterionresources withCampaignCriterionService.MutateCampaignCriteria, such aslanguageandlocationcriteria (see Criteria). - Negative keyword lists: Link a
CampaignSharedSetto aNEGATIVE_KEYWORDSSharedSet(see Shared sets). - Audiences: Attach required
UserListInfocriteria (APP_CAMPAIGN_FOR_ENGAGEMENT) or optionalAudienceInfosignals (APP_CAMPAIGN) on ad groups (see Create an App ad group and ad).
Map Google Ads UI settings to API fields
Use this table to map Google Ads UI controls to Google Ads API fields (Bidding and budget for App installs, or Budget and bidding for engagement and pre-registration).
| Google Ads UI section and label | API resource and field | Details |
|---|---|---|
| App > Select a campaign subtype (App installs, App engagement, App pre-registration (Android only)). |
Campaign.advertising_channel_type,
Campaign.advertising_channel_sub_type.
|
Immutable: MULTI_CHANNEL with
APP_CAMPAIGN, APP_CAMPAIGN_FOR_ENGAGEMENT,
or APP_CAMPAIGN_FOR_PRE_REGISTRATION.
|
| Campaign settings > Campaign name. |
Campaign.name.
|
Required display name in the customer account. |
| Campaign settings > Mobile app. |
Campaign.app_campaign_setting.app_store,
Campaign.app_campaign_setting.app_id.
|
Immutable: GOOGLE_APP_STORE (package name; required for
pre-registration) or APPLE_APP_STORE (numeric ID).
|
| Campaign settings > Locations and Languages. |
CampaignCriterion
(location,
language).
|
Added with MutateCampaignCriteria or atomic
GoogleAdsService.Mutate.
|
| Campaign settings > View-through conversion optimization > Turn on view-through conversions. |
Campaign.view_through_conversion_optimization_enabled.
|
Android APP_CAMPAIGN only (v24 and later). Defaults to
true in the UI and false in the API.
|
| Campaign settings > EU political ads (Does your campaign have European Union political ads?). |
Campaign.contains_eu_political_advertising.
|
Maps Yes, this campaign has EU political ads and No, this campaign doesn't have EU political ads. |
| Campaign settings > Start and end dates. |
Campaign.start_date_time,
Campaign.end_date_time.
|
Optional account-timezone timestamps (00:00:00 today or
later, and 23:59:59).
|
| Bidding and budget > Budget. |
CampaignBudget.amount_micros,
Campaign.campaign_budget.
|
Daily micros in account currency with
CampaignBudget.explicitly_shared set to
false.
|
|
Bidding and budget > Bidding >
What do you want to focus on? and
What kind of users do you want to target? Set a target cost per install (optional), Set a target cost per in-app action (optional), and Set a target return on ad spend (optional). Target cost per install, Target cost per action, and Target return on ad spend. |
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.
|
Sets both the goal enum and bidding oneof field (see
Preparation). Non-target strategies apply
to APP_CAMPAIGN only. On iOS,
Optimize for SKAdNetwork conversion values is UI-only (read
schemas with
CustomerSkAdNetworkConversionValueSchema).
|
|
Bidding and budget > Bidding >
How do you want to track install volume? Which action is most important to you? and Which actions are most important to you? |
Campaign.selective_optimization.conversion_actions.
|
Install picker adds up to one DOWNLOAD action
(APP_CAMPAIGN only). Action pickers add one (singular)
or multiple (plural) actions matching app_id.
|
| Budget and bidding > Bidding > Pre-registration and Target cost per pre-registration. |
Campaign.target_cpa.target_cpa_micros,
Campaign.optimization_goal_setting.optimization_goal_types.
|
Uses OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME and
APP_PRE_REGISTRATION (leave
selective_optimization unset).
|
Code example and next steps
Attach an ad group and creative assets so your campaign can serve ads:
- Create an App ad group and ad: Add an
AdGroupresource (with requiredUserListInfocriteria onAPP_CAMPAIGN_FOR_ENGAGEMENT) and an App ad. - App campaign code example: Inspect the
multi-language
AddAppCampaignsample creating a budget, campaign, criteria, ad group, and ad. - App campaign reporting: Query campaign, asset, install, and SKAdNetwork metrics with Google Ads Query Language.