Page Summary
-
App campaigns promote your app based on a specific area of focus.
-
Creating an App campaign involves specifying app info, campaign details, and targeting criteria, then creating an ad group and asset-based ads.
-
Google Ads automates targeting and bidding based on the specified goal and provided assets.
-
App Campaign Legacy (installs) is not supported in the Google Ads API, only in the UI.
App campaigns let you promote mobile apps across Search, Google Play, YouTube, AdMob, Discover, and the Google Display Network through the Google Ads API. Google Ads automatically manages targeting and bidding for your selected goal and assembles ads from your assets.
Campaign architecture
An App campaign consists of three main resource layers:
- Campaign: Defines the promoted app, the
advertising_channel_sub_typevalue (APP_CAMPAIGN,APP_CAMPAIGN_FOR_ENGAGEMENT, orAPP_CAMPAIGN_FOR_PRE_REGISTRATION), the bidding goal, a dedicated budget, and optional location or language criteria. - Ad group and audience criteria: Organizes creative
themes or user segments under the campaign (up to 100 enabled ad groups per
campaign). Engagement campaigns (
APP_CAMPAIGN_FOR_ENGAGEMENT) requireAdGroupCriterion.user_listtargeting and support optionalAdGroup.target_cpa_microsorAdGroup.target_roasbid overrides. Install campaigns (APP_CAMPAIGN) support optionalAdGroupCriterion.audiencesignals, whereas pre-registration campaigns (APP_CAMPAIGN_FOR_PRE_REGISTRATION) don't support ad group criteria or bid overrides. - Asset-based ad: Supplies one ad
per ad group with text, image, video, and HTML5 (for
APP_CAMPAIGN) assets matching the campaign subtype.
Promoted app metadata
The campaign.app_campaign_setting.app_id and
campaign.app_campaign_setting.app_store fields on the
campaign resource store each campaign's app ID and store
(Google Play or Apple App Store). The following Google Ads Query Language query returns
all non-removed App campaigns and their promoted apps:
SELECT
campaign.id,
campaign.name,
campaign.advertising_channel_sub_type,
campaign.app_campaign_setting.app_id,
campaign.app_campaign_setting.app_store
FROM campaign
WHERE campaign.advertising_channel_type = 'MULTI_CHANNEL'
AND campaign.advertising_channel_sub_type IN (
'APP_CAMPAIGN',
'APP_CAMPAIGN_FOR_ENGAGEMENT',
'APP_CAMPAIGN_FOR_PRE_REGISTRATION'
)
AND campaign.status != 'REMOVED'
What's next
- Create an App campaign: Configure budgets, bidding, UI field mappings, and app settings.
- Create an App ad group and ad: Configure ad group bid overrides, audience criteria, and ads.
- App campaign reporting: Query impressions, conversions, SKAdNetwork installs, and asset performance.
- App campaign code example: Inspect an end-to-end client library sample.