Create an App campaign

  • 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_type of MULTI_CHANNEL and 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_ENGAGEMENT campaigns, automatically added for APP_CAMPAIGN_FOR_PRE_REGISTRATION campaigns, and optional otherwise.

  • Campaign targeting can be refined by adding CampaignCriterion objects 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:

  1. Create a daily CampaignBudget for campaign_budget with amount_micros and explicitly_shared set to false (defaults to true; shared and CUSTOM_PERIOD budgets fail). See Create campaign budgets.

  2. Set name, and optionally set status to PAUSED while attaching ads (defaults to ENABLED).

  3. Set immutable advertising_channel_type to MULTI_CHANNEL and immutable advertising_channel_sub_type to APP_CAMPAIGN, APP_CAMPAIGN_FOR_ENGAGEMENT, or APP_CAMPAIGN_FOR_PRE_REGISTRATION.

  4. Set contains_eu_political_advertising to DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING or CONTAINS_EU_POLITICAL_ADVERTISING. Standalone MutateCampaigns calls require this European Union (EU) declaration (optional in v26 and later when atomically targeting only non-EU locations; see EU political ads).

  5. Set app_campaign_setting to an AppCampaignSetting object (app_store and app_id are immutable):

  6. Set a standard bidding strategy on Campaign (portfolio BiddingStrategy resources aren't supported). Toggling an optional UI target switches both bidding_strategy_goal_type and the bidding oneof field:

  7. Configure conversion or pre-registration goals:

  8. Optional: Starting in v24, set view_through_conversion_optimization_enabled to true on Android APP_CAMPAIGN campaigns for view-through conversion (VTC) bidding (UI default true, API default false).

  9. Optional: Set start_date_time (00:00:00, today or later) and end_date_time (23:59:59) in the account's time zone (yyyy-MM-dd HH:mm:ss). Call MutateCampaigns or GoogleAdsService.Mutate.

Optional: Add campaign targeting and exclusions

Refine targeting after creation or in the same GoogleAdsService.Mutate request:

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: