Page Summary
-
App campaigns require ad groups and ads.
-
Create ad groups using
AdGroupServiceand do not specify atype. -
For
APP_CAMPAIGN_FOR_ENGAGEMENTcampaigns, you can optionally override the target CPA at the ad group level and must target an audience usingAdGroupCriterionand aUserListInfo. -
For
APP_CAMPAIGNcampaigns, you cannot override bid settings or add ad group criteria. -
Add an ad group ad for each set of assets, using the appropriate ad info based on the campaign's advertising channel sub-type.
Each App campaign needs at least one ad group and a single
asset-based ad per ad group before it can serve. Create these resources
individually with their mutate services, or bundle them with the campaign in one
atomic GoogleAdsService.Mutate
request by using negative temporary IDs. Depending on the campaign subtype, you
also configure ad group bid overrides and audience criteria.
Create an ad group and criteria
Create up to 100 enabled AdGroup resources per
campaign by calling
AdGroupService.MutateAdGroups
or sending AdGroupOperation entries to GoogleAdsService.Mutate. Use separate
ad groups to organize distinct creative themes or target segments, and leave the
type field unset.
Configure ad group bid overrides
Ad group bid overrides depend on the campaign's
advertising_channel_sub_type
field:
APP_CAMPAIGN_FOR_ENGAGEMENT(optional): Override the campaign-level bid target on the ad group:- For target CPA campaigns, set the
target_cpa_microsfield. - For target ROAS campaigns, set the
target_roasfield.
- For target CPA campaigns, set the
APP_CAMPAIGNandAPP_CAMPAIGN_FOR_PRE_REGISTRATION: Leave thetarget_cpa_microsandtarget_roasfields unset. The API rejectstarget_cpa_microson both subtypes, rejectstarget_roasonAPP_CAMPAIGN, and ignorestarget_roasonAPP_CAMPAIGN_FOR_PRE_REGISTRATION.
Configure ad group criteria
Add AdGroupCriterion resources with
AdGroupCriterionService.MutateAdGroupCriteria
(or AdGroupCriterionOperation in GoogleAdsService.Mutate) according to the
campaign's
advertising_channel_sub_type
field:
APP_CAMPAIGN_FOR_ENGAGEMENT(required): Target an app-reengagement-eligible user segment by setting theuser_listfield to aUserListInfoobject. Set theUserListInfo.user_listfield to the resource name of an eligibleUserListbacked by your mobile app data.APP_CAMPAIGN(optional): Provide audience signals by setting theaudiencefield to anAudienceInfoobject (at most one per ad group). Set theAudienceInfo.audiencefield to theAudienceresource name, and leave theAdGroup.optimized_targeting_enabledfield unset ortrue. Don't attachUserListInfocriteria toAPP_CAMPAIGNad groups.APP_CAMPAIGN_FOR_PRE_REGISTRATION: Don't addAdGroupCriterionresources. Pre-registration campaigns don't support ad-group-level criteria.
Keep the following AdGroupCriterion restrictions in mind across all App
campaigns:
- Leave bid and
bid_modifierfields unset onAdGroupCriterionresources. App campaigns don't support criterion-level bid overrides. - Keep the
negativefield set tofalse(or unset) on audience criteria, because you can't exclude audiences or keywords at the ad group level. To exclude audiences onAPP_CAMPAIGN, add campaign-levelCampaignCriterionresources withuser_listandnegativeset totrue(not supported on engagement or pre-registration). To exclude keywords at the campaign level, link aNEGATIVE_KEYWORDSshared set with aCampaignSharedSetresource (direct negative keywordCampaignCriterionresources aren't supported).
Create an ad group ad
Each App campaign ad group supports at most one
AdGroupAd resource. Create the ad with
AdGroupAdService.MutateAdGroupAds
(or an AdGroupAdOperation in GoogleAdsService.Mutate), and populate the
Ad field matching the campaign's
advertising_channel_sub_type
value:
- For
APP_CAMPAIGN, set theapp_adfield to anAppAdInfoobject with 2–5headlinesand 1–5descriptionstext assets. Optionally add up to 20images, 20youtube_videos, and 20html5_media_bundlesassets, plusmandatory_ad_textandapp_deep_linkfields. - For
APP_CAMPAIGN_FOR_ENGAGEMENT, set theapp_engagement_adfield to anAppEngagementAdInfoobject with 2–5headlinesand 1–5descriptionstext assets. Optionally add up to 20imagesand 20videosassets (HTML5 bundles aren't supported). Also populate theAd.final_app_urlsfield with at least oneFinalAppUrldeep link matching the app's operating system. - For
APP_CAMPAIGN_FOR_PRE_REGISTRATION, set theapp_pre_registration_adfield to anAppPreRegistrationAdInfoobject with 2–5headlinesand 1–5descriptionstext assets. Optionally add up to 20imagesand 20youtube_videosassets (HTML5 bundles aren't supported).
What's next
- App campaign code example: Review a complete
implementation in the
AddAppCampaignsample. - App campaign reporting: Retrieve campaign, conversion, and asset performance metrics.