建立應用程式廣告活動

使用 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 資源:

  1. 為 campaign_budget 建立每日 CampaignBudget,並將 amount_micros 和 explicitly_shared 設為 false (預設為 true;共用和 CUSTOM_PERIOD 預算會失敗)。請參閱「建立廣告活動預算」。

  2. 設定 name,並在附加廣告時,視需要將 status 設為 PAUSED (預設為 ENABLED)。

  3. 將不可變動的 advertising_channel_type 設為 MULTI_CHANNEL,並將不可變動的 advertising_channel_sub_type 設為 APP_CAMPAIGN、APP_CAMPAIGN_FOR_ENGAGEMENT 或 APP_CAMPAIGN_FOR_PRE_REGISTRATION。

  4. 將 contains_eu_political_advertising 設為 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING 或 CONTAINS_EU_POLITICAL_ADVERTISING。獨立 MutateCampaigns 呼叫需要這項歐盟 (EU) 聲明 (在第 26 版和更新版本中,如果只指定非歐盟地區,則可選擇不提供;請參閱「歐盟政治廣告」)。

  5. 將 app_campaign_setting 設為 AppCampaignSetting 物件 (app_store 和 app_id 不可變):

  6. 在 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。
  7. 設定轉換或預先註冊目標:

  8. 選用:自第 24 版起,請在 Android APP_CAMPAIGN 廣告活動中,將 view_through_conversion_optimization_enabled 設為 true,以進行瀏覽後轉換出價 (使用者介面預設值為 true,API 預設值為 false)。

  9. 選用:在帳戶時區 (yyyy-MM-dd HH:mm:ss) 中設定 start_date_time (00:00:00,今天或之後) 和 end_date_time (23:59:59)。呼叫 MutateCampaigns 或 GoogleAdsService.Mutate。

選用:新增廣告活動指定目標和排除條件

建立後或在同一個 GoogleAdsService.Mutate 要求中,調整指定目標:

將 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)。

程式碼範例和後續步驟

附加廣告群組和廣告素材資源,讓廣告活動放送廣告: