借助 Google Ads API 制作应用广告系列,在 Google 搜索、Google Play、YouTube、AdMob、Google 探索和 Google 展示广告网络中宣传您的移动应用。以提升安装量、应用内操作次数、转化价值或 Android 预注册量为目标优化广告系列。启用的广告系列会产生标准 Google Ads 广告投放费用,最高不超过您的预算。
准备工作
您的广告系列目标(每次安装费用 [CPI]、每次转化费用 [CPA]、广告支出回报率 [ROAS] 或预注册人数)决定了您的 API 设置。在完成创建步骤之前,请在下表中找到您的目标。如需查找 Google Ads 界面控件,请参阅将 Google Ads 界面设置映射到 API 字段或应用广告系列简介。
| 目标和 Google Ads 界面选择 | 子类型和目标枚举 | 出价策略 | 转化设置 (conversion_actions) |
|---|---|---|---|
|
更多安装量(目标每次安装费用)。 安装量 > 所有用户,选中设置目标每次安装费用(可选)。 |
APP_CAMPAIGN。OPTIMIZE_INSTALLS_TARGET_INSTALL_COST。
|
target_cpa
(target_cpa_micros
= 目标每次安装费用)。
|
可选。conversion_actions 中最多一个 DOWNLOAD 操作。
|
|
不设置目标每次安装费用,以获得更多安装。 安装量 > 所有用户,设置目标每次安装费用(可选)处于未选中状态。 |
APP_CAMPAIGN。OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST。
|
maximize_conversions(无 target_cpa_micros)。
|
可选。最多一项 DOWNLOAD 操作。
|
|
安装量和应用内操作(目标每次安装费用)。 安装量 > 很可能会执行应用内操作的用户、目标每次安装费用。 |
APP_CAMPAIGN。OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST。
|
target_cpa(target_cpa_micros = 目标每次安装费用)。
|
必需。一项应用内操作,以及可选的DOWNLOAD操作。
|
|
应用内操作(目标每次转化费用)。 应用内操作,已选择设置目标每次应用内操作费用(可选)(或目标每次转化费用,适用于互动广告系列)。 |
APP_CAMPAIGN 或 APP_CAMPAIGN_FOR_ENGAGEMENT。OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST。
|
target_cpa(target_cpa_micros = 目标每次转化费用)。
|
必需。安装后操作。DOWNLOAD(APP_CAMPAIGN 上)可选(互动广告系列上无)。
|
|
不设目标每次转化费用的应用内操作。 应用内操作、设置目标每次应用内操作费用(可选)已清除。 |
APP_CAMPAIGN。OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA。
|
maximize_conversions(无 target_cpa_micros)。
|
必需。安装后操作,以及可选的 DOWNLOAD 操作。
|
|
应用内操作价值(目标广告支出回报率)。 应用内操作价值,已选中设置目标广告支出回报率(可选)(或目标广告支出回报率,适用于互动)。 |
APP_CAMPAIGN 或 APP_CAMPAIGN_FOR_ENGAGEMENT。OPTIMIZE_RETURN_ON_ADVERTISING_SPEND。
|
target_roas
(target_roas
= 目标广告支出回报率)。
|
必需。值操作(例如 Firebase 或 GOOGLE_PLAY_IN_APP_PURCHASE)。仅在 APP_CAMPAIGN 上可选 DOWNLOAD。
|
|
不设目标广告支出回报率的应用内操作价值。 应用内操作价值、设置目标广告支出回报率(可选)已清除。 |
APP_CAMPAIGN。OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS。
|
maximize_conversion_value(无 target_roas)。
|
必需。价值操作(例如 Firebase 或 GOOGLE_PLAY_IN_APP_PURCHASE),以及可选的 DOWNLOAD 操作。
|
|
应用预注册(仅限 Android)。 预注册 (目标每次预注册费用). |
APP_CAMPAIGN_FOR_PRE_REGISTRATION(仅限 GOOGLE_APP_STORE)。OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME。
|
target_cpa(target_cpa_micros = 目标每次预注册费用)。
|
不设置 selective_optimization。将 APP_PRE_REGISTRATION 添加到 optimization_goal_types。
|
步骤
使用负临时 ID 在一个 GoogleAdsService.Mutate 请求中以原子方式创建所有资源,或调用 CampaignService.MutateCampaigns。
配置并制作广告系列
配置 Campaign 资源:
为
campaign_budget创建每日CampaignBudget,并将amount_micros和explicitly_shared设置为false(默认为true;共享预算和CUSTOM_PERIOD预算会失败)。请参阅创建广告系列预算。将不可变
advertising_channel_type设置为MULTI_CHANNEL,并将不可变advertising_channel_sub_type设置为APP_CAMPAIGN、APP_CAMPAIGN_FOR_ENGAGEMENT或APP_CAMPAIGN_FOR_PRE_REGISTRATION。将
contains_eu_political_advertising设置为DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING或CONTAINS_EU_POLITICAL_ADVERTISING。独立的MutateCampaigns调用需要此欧盟 (EU) 声明(在 v26 及更高版本中,如果仅定位到非欧盟地理位置,则为可选;请参阅欧盟政治广告)。将
app_campaign_setting设置为AppCampaignSetting对象(app_store和app_id不可变):app_store:AppCampaignAppStore(GOOGLE_APP_STORE或APPLE_APP_STORE;预注册需要GOOGLE_APP_STORE)。app_id:Google Play 软件包名称 (com.example.app) 或 Apple 应用商店数字 ID。互动广告系列要求达到最低安装量;预注册广告系列要求在 Play 管理中心内有未发布的应用(在发布前不符合APP_CAMPAIGN的条件)。bidding_strategy_goal_type:目标的AppCampaignBiddingStrategyGoalType(可变)。
为
Campaign设置标准出价策略(不支持组合BiddingStrategy资源)。切换可选界面目标会同时切换bidding_strategy_goal_type和出价oneof字段:- 目标每次安装费用、每次转化费用或预注册:以账号币种的微单位设置
target_cpa,并指定正数target_cpa_micros(1500000= 1.50 个单位,例如 1.50 美元)。 - 目标广告支出回报率:将
target_roas设置为target_roas,范围为0.01到1000.0(3.0= 300% 的广告支出回报率)。 - 不设目标的“尽可能提高”出价策略(仅限
APP_CAMPAIGN):设置为空maximize_conversions或maximize_conversion_value。 请勿设置maximize_conversions.target_cpa_micros(在MULTI_CHANNEL上被拒绝)或maximize_conversion_value.target_roas。
- 目标每次安装费用、每次转化费用或预注册:以账号币种的微单位设置
配置转化目标或预注册目标:
APP_CAMPAIGN和APP_CAMPAIGN_FOR_ENGAGEMENT:将与app_id匹配的ConversionAction资源名称添加到selective_optimization.conversion_actions(而不是CampaignConversionGoal或optimization_goal_setting;请参阅广告系列转化目标)。在APP_CAMPAIGN上,最多可包含一个DOWNLOAD操作,例如GOOGLE_PLAY_DOWNLOAD或 Firebasefirst_open(界面必需、API 可选、互动广告系列中禁止使用)。APP_CAMPAIGN_FOR_PRE_REGISTRATION:将selective_optimization留空,并将APP_PRE_REGISTRATION添加到optimization_goal_setting.optimization_goal_types。
可选:从 v24 开始,在 Android
APP_CAMPAIGN广告系列中将view_through_conversion_optimization_enabled设置为true,以便针对浏览型转化 (VTC) 出价(界面默认值为true,API 默认值为false)。可选:在账号的时区 (
yyyy-MM-dd HH:mm:ss) 中设置start_date_time(00:00:00,今天或更晚)和end_date_time(23:59:59)。调用MutateCampaigns或GoogleAdsService.Mutate。
可选:添加广告系列定位条件和排除对象
在创建后或在同一 GoogleAdsService.Mutate 请求中优化定位:
- 地理位置和语言:使用
CampaignCriterionService.MutateCampaignCriteria添加CampaignCriterion资源,例如language和location条件(请参阅条件)。 - 否定关键字列表:将
CampaignSharedSet关联到NEGATIVE_KEYWORDSSharedSet(请参阅共享集)。 - 受众群体:在广告组中附加必需的
UserListInfo条件 (APP_CAMPAIGN_FOR_ENGAGEMENT) 或可选的AudienceInfo信号 (APP_CAMPAIGN)(请参阅创建应用广告组和广告)。
将 Google Ads 界面设置映射到 API 字段
使用此表格可将 Google Ads 界面控件映射到 Google Ads API 字段(对于应用安装广告系列,为出价和预算;对于互动广告系列和预注册广告系列,为预算和出价)。
| Google Ads 界面部分和标签 | API 资源和字段 | 详细信息 |
|---|---|---|
| 应用 > 选择广告系列子类型(应用安装、应用互动、应用预注册 [仅限 Android])。 |
Campaign.advertising_channel_type、Campaign.advertising_channel_sub_type。
|
不可变:MULTI_CHANNEL,值为 APP_CAMPAIGN、APP_CAMPAIGN_FOR_ENGAGEMENT 或 APP_CAMPAIGN_FOR_PRE_REGISTRATION。
|
| 广告系列设置 > 广告系列名称。 |
Campaign.name。
|
客户账号中的必填显示名称。 |
| 广告系列设置 > 移动应用。 |
Campaign.app_campaign_setting.app_store、Campaign.app_campaign_setting.app_id。
|
不可变:GOOGLE_APP_STORE(软件包名称;预注册时必须提供)或 APPLE_APP_STORE(数字 ID)。
|
| 广告系列设置 > 地理位置和语言。 |
CampaignCriterion
(location、
language)。
|
通过 MutateCampaignCriteria 或原子 GoogleAdsService.Mutate 添加。
|
| 广告系列设置 > 浏览型转化优化 > 启用浏览型转化。 |
Campaign.view_through_conversion_optimization_enabled。
|
仅限 Android APP_CAMPAIGN(v24 及更高版本)。在界面中默认为 true,在 API 中默认为 false。
|
| 广告系列设置 > 欧盟政治广告(您的广告系列是否包含欧盟政治广告?)。 |
Campaign.contains_eu_political_advertising。
|
映射是,此广告系列包含欧盟政治广告和否,此广告系列不包含欧盟政治广告。 |
| 广告系列设置 > 开始日期和结束日期。 |
Campaign.start_date_time、Campaign.end_date_time。
|
可选的账号时区时间戳(00:00:00今天或之后,以及 23:59:59)。
|
| 出价和预算 > 预算。 |
CampaignBudget.amount_micros、Campaign.campaign_budget。
|
以账号币种表示的每日微单位,其中 CampaignBudget.explicitly_shared 设置为 false。
|
|
出价和预算 > 出价 > 您希望侧重于什么?和您希望定位哪类用户? 设置目标每次安装费用(可选)、设置目标每次应用内操作费用(可选)和设置目标广告支出回报率(可选)。 目标每次安装费用、目标每次转化费用和目标广告支出回报率。 |
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。
|
同时设置目标枚举和出价 oneof 字段(请参阅准备工作)。非目标策略仅适用于 APP_CAMPAIGN。在 iOS 上,针对 SKAdNetwork 转化价值进行优化仅限界面(使用 CustomerSkAdNetworkConversionValueSchema 读取架构)。
|
|
出价和预算 > 出价 > 您希望如何跟踪安装量? 哪项转化操作对您最重要?和哪些转化操作对您最为重要? |
Campaign.selective_optimization.conversion_actions。
|
安装选择器最多可添加一项 DOWNLOAD 操作(仅限 APP_CAMPAIGN)。操作选择器会添加一个(单数)或多个(复数)与 app_id 匹配的操作。
|
| 预算和出价 > 出价 > 预注册和目标每次预注册费用。 |
Campaign.target_cpa.target_cpa_micros、Campaign.optimization_goal_setting.optimization_goal_types。
|
使用 OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME 和 APP_PRE_REGISTRATION(不设置 selective_optimization)。
|
代码示例和后续步骤
请附加广告组和广告素材资源,以便您的广告系列能够投放广告:
- 创建应用广告组和广告:添加
AdGroup资源(在APP_CAMPAIGN_FOR_ENGAGEMENT上具有必需的UserListInfo条件)和应用广告。 - 应用广告系列代码示例:查看多语言
AddAppCampaign示例,了解如何创建预算、广告系列、条件、广告组和广告。 - 应用广告系列报告:使用 Google Ads 查询语言查询广告系列、素材资源、安装和 SKAdNetwork 指标。