使用 Google Ads API 建立應用程式廣告活動,在 Google 搜尋、Google Play、YouTube、AdMob、探索和 Google 多媒體廣告聯播網上宣傳行動應用程式。針對安裝、應用程式內動作、轉換價值或 Android 預先註冊,對廣告活動進行最佳化。啟用的廣告活動會產生標準 Google Ads 廣告放送費用,最高不超過預算。
準備
廣告活動目標 (單次安裝出價、單次動作出價、廣告投資報酬率或預先註冊) 會決定 API 設定。請先在下表中找出目標,再完成建立步驟。如要查詢 Google Ads UI 控制項,請參閱「將 Google Ads UI 設定對應至 API 欄位」或「關於應用程式廣告活動」。
| 目標和 Google Ads UI 選項 | 子類型和目標列舉 | 出價策略 | 轉換設定 (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) 聲明 (在第 26 版和更新版本中,如果只指定非歐盟地區,則可選擇不提供;請參閱「歐盟政治廣告」)。將
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資源)。切換選用的 UI 目標會同時切換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(UI 必須提供,API 則不一定,參與式廣告活動則禁止使用)。APP_CAMPAIGN_FOR_PRE_REGISTRATION:不設定selective_optimization,並將APP_PRE_REGISTRATION新增至optimization_goal_setting.optimization_goal_types。
選用:自第 24 版起,請在 Android
APP_CAMPAIGN廣告活動中,將view_through_conversion_optimization_enabled設為true,以進行瀏覽後轉換出價 (使用者介面預設值為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 UI 設定對應至 API 欄位
請使用下表,將 Google Ads UI 控制項對應至 Google Ads API 欄位 (應用程式安裝的「出價和預算」,或參與度和預先註冊的「預算和出價」)。
| Google Ads UI 專區和標籤 | 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 (第 24 版以上)。使用者介面中的預設值為 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 轉換價值」僅限 UI (使用 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 指標。