基本必備功能

2022-10-06 版

「基本必備功能」(RMF) 是指某些工具開發人員使用 Google Ads API 時必須提供的功能。如下所述，RMF 規則分為三類：「建立功能」、「管理功能」和「報表功能」。您必須按照自己使用 Google Ads API 的情況遵守相關規則 (「適用 RMF」表示您必須遵守 RMF)：

建立功能 管理功能 報表功能
全方位服務工具
  • 廣告主、代理商和其他第三方使用您的工具，全方位管理 Google Ads 帳戶
 需遵守 RMF 規定 需遵守 RMF 規定 需遵守 RMF 規定
報表專用工具
  • 廣告客戶只能使用報表資訊主頁
 不適用 RMF 規定 不適用 RMF 規定 需遵守 RMF 規定
僅限內部使用
  • 僅限個別廣告主或代理商使用；第三方無法存取工具 (也就是只有您使用自己的工具)
 不適用 RMF 規定 不適用 RMF 規定 不適用 RMF 規定

如果您的工具功能不多且應用範圍不廣，也無法用於建立及管理廣告活動、廣告群組和廣告，可能就不屬於全方位服務工具。在這種情況下，廣告建立和管理的相關基本必備功能規定就不適用。如果不確定自己的工具是否需遵守「基本必備功能」政策，請聯絡 Google Ads API 法規遵循團隊，Google Ads API 合規團隊將判斷您的工具是否為全方位服務工具。如果工具功能有大幅變動，可能需要重新評估。

請注意，RMF 僅適用於存取層級為「標準」的 Google Cloud 專案。

重大更新的一次性延期

考量到 API 工具可能定期進行大規模技術升級，如果工具連續至少 2 年符合所有 RMF 期限，則可申請延長 RMF 期限 6 個月，以便在平台上實施這類升級。如果獲得展延，在展延期間，系統不會審查這些工具是否符合 RMF 規定。展延期結束時，工具必須完全符合展延期最後一天或之前到期的所有 RMF 規定。延期結束後，所有 RMF 規定的到期日仍為下表指定的日期。

每項 API 工具每四年最多可獲得一次延期 (第二次延期必須在第一次延期結束後至少 4 年才能開始)。

如要為工具申請延期，請與 Google Ads API 法規遵循團隊聯絡，索取申請表。申請書必須由貴公司的高階主管 (執行長、技術長或資深副總裁) 簽署並提交。請注意，我們不保證一定會核准申請。

僅限購物、僅限應用程式宣傳和僅限飯店 API 工具的規定

如果您的工具只能建立及管理下列其中一種廣告活動類型，則只需在 RMF 中導入適用於該廣告活動類型的 Google Ads API 建立和管理功能及報表。

僅限報表的 Google Ads API 用戶端規定

為符合 RMF 規定，報表專用 Google Ads API 用戶端必須在報表介面中，為 Google Ads 階層的每個層級顯示報表功能。Google Ads 階層中的層級是指帳戶、廣告活動、廣告群組、廣告或關鍵字。舉例來說，如果報表專用 Google Ads 用戶端確實顯示廣告群組，就必須導入下方標示為「必要」的所有「廣告群組」層級報表功能。

報表專用 Google Ads API 用戶端可選擇不在報表介面中顯示特定層級的 Google Ads 階層。舉例來說，如果 Google Ads API 用戶端僅用於製作報表，且介面未顯示任何廣告群組層級的成效資料，就不必導入任何「廣告群組」層級的報表 RMF。

上述規定也適用於所有其他報表類型 (即便不屬於 Google Ads 階層的層級)。如果您選擇導入其中任何一種報表，每份報表都必須顯示所有必要欄位。

為符合 RMF 規定，Google Ads API 用戶端必須預設顯示每個報表的「物件/欄位/指南」欄中標示為必要的資料欄。所有其他指標欄都必須提供，做為 Google Ads API 用戶端使用者的選項。Google Ads 報表資料應合理醒目，且使用者可輕鬆存取。

可下載報表

如果您的工具提供 CSV 等下載選項，而不是在使用者介面中顯示報表功能，則下載連結必須顯眼且標示簡單易懂。下載檔案一定要清楚標示，且包含所有必要報表欄位。

報表日期範圍

建議您允許使用者按照日期範圍篩選報表資料。如果您的工具不支援自訂日期範圍，應至少為每個必要報表欄位提供最近 30 天的資料。

提供建立或管理功能的 API 用戶端相關規定

為符合 RMF 規定，全服務 Google Ads API 用戶端必須導入下表列出的所有必要建立和管理功能，並為下列各項報表顯示報表功能。此外，您必須盡合理努力，確保最終廣告主能輕鬆存取及使用各項功能，並以這些功能的使用情形做為衡量標準。

提供規劃服務的 API 用戶端相關規定

如果 Google Ads API 用戶端提供與 KeywordPlanIdeaService 或 KeywordPlanService 相關的任何功能，則必須完整導入下表中標示為「必要」的必要建立功能、管理功能和報表功能。

提供推薦服務的 API 用戶端規定

所有 API 用戶端都可以使用 GoogleAdsService 和 RecommendationService 擷取最佳化建議。

RecommendationService.ApplyRecommendation() 和 RecommendationService.DismissRecommendation() 僅限下列類型的 Google Ads API 用戶端使用：

  • 全方位服務工具
  • 內部專用工具
  • 僅限購物、僅限最高成效/智慧購物、僅限應用程式宣傳，以及僅限飯店 API 工具
  • 提供廣告活動管理功能的特殊用途工具

如果 Google Ads API 用戶端提供使用 RecommendationService 套用或關閉最佳化建議的功能，則必須符合下列規定：

  1. 必須完整實作工具類別所需的建立、管理和報表功能。
  2. 向使用者顯示的所有 Google Ads 最佳化建議，都必須在工具的使用者介面中標示為「Google Ads 最佳化建議」。
  3. 使用者必須能查看並套用 Google Ads API 用戶端顯示的所有 Google Ads 最佳化建議。

出價調整幅度相關規定

所有提供建立或管理功能的 API 用戶端，都必須符合下列出價調整幅度相關規定：

  1. 使用者必須能夠輸入整個範圍內的允許值。
  2. 使用者必須能先查看及編輯出價調整幅度，Google Ads API 用戶端才能設定。
  3. 出價調整幅度只能用於調整出價，不得用於啟用或模擬其他功能，例如指定目標或排除條件。

功能導入

除非以下另有指示，否則導入功能時，一定要一併導入所有可用的子功能及參數。API 參考資料會列出可用的參數和子功能。舉例來說，「選擇加入/退出聯播網」功能代表支援選擇加入/退出 Google 搜尋、搜尋夥伴和多媒體廣告聯播網。此外，如果您在 Google Ads API 用戶端中導入的功能，與 Google 未要求提供的任何功能類似，則您也必須在 Google Ads API 用戶端中導入類似的 Google 功能。舉例來說，如果您在 Google Ads API 用戶端中導入自己的「關鍵字提案」版本，則也必須在 Google Ads API 用戶端中導入 Google 的「關鍵字提案」功能。

為維持 RMF 法規遵循狀態，您必須在到期日前新增所有必要功能 (每項功能旁會顯示「到期日：YYYY-MM-DD」)。未指定到期日的 RMF 則視為逾期。此外，您必須在 Google Ads API 用戶端重大變更生效前至少兩週，使用工具變更表單傳送擬議變更的螢幕截圖和/或模擬圖。為求明確，兩週過後，您無須等待 Google 回覆，即可讓重大變更生效。

全方位服務工具功能清單

項目編號 功能 物件/欄位/指南 規定

建立功能
C.10 建立廣告活動 campaign 必填
C.20 啟用指定地理區域 指定地區 必要。 如果使用者族群只與一個國家/地區相關，則可選擇是否向使用者顯示。
C.30 啟用指定語言 campaign_criterion.language
language_constant		 必填。如果使用者族群只與一種語言相關，則可選擇是否向使用者顯示。
C.65 建立網站/來電轉換，並產生程式碼片段 轉換追蹤 至少須採用一種轉換追蹤。
C.75 摘要額外資訊 摘要動態饋給預留位置
額外資訊設定服務
動態饋給服務
 必填。這項功能僅需在帳戶層級支援。
C.96 設定出價選項：目標單次動作出價 (組合和標準) campaign.target_cpa (標準)
bidding_strategy.target_cpa (組合)		 必填。廣告活動層級必須同時支援組合和標準策略。
C.97 設定出價選項：目標廣告投資報酬率 (組合和標準) campaign.target_roas (標準)
bidding_strategy.target_roas (組合)		 必填。廣告活動層級必須同時支援組合和標準策略。
C.98 設定出價選項：盡量爭取轉換 (標準) campaign.maximize_conversions (標準) 必填
C.120 設定預算 campaign_budget 必填
C.190 建立廣告群組 ad_group 必填。選用：可建立多個廣告群組。
C.260 新增關鍵字 ad_group_criterion.keyword 必填
C.270 替廣告活動排除關鍵字 campaign_criterion.negative 必填
C.300 設定關鍵字比對類型 ad_group_criterion.keyword
 .match_type		 必填

管理功能
M.10 編輯廣告活動設定 campaign.*setting 必填。只有建立時必要的設定，在變更時才需要提供。
M.96 編輯出價選項：目標單次轉換出價 (組合和標準) campaign.target_cpa (標準)
bidding_strategy.target_cpa (組合)		 必填。廣告活動層級必須同時支援組合和標準策略。
M.97 編輯出價選項：目標廣告投資報酬率 (組合和標準) campaign.target_roas (標準)
bidding_strategy.target_roas (組合) 		必填。廣告活動層級必須同時支援組合和標準策略。
M.98 編輯出價選項：盡量爭取轉換 (標準) campaign.maximize_conversions (標準) 必填
M.110 暫停/啟用/移除廣告活動 campaign.status 必填
M.130 暫停/啟用/移除廣告 ad_group_ad.status 必填
M.140 暫停/啟用/移除關鍵字 ad_group_criterion.status 必填

報表功能
R.10 客戶 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions 		必填
R.20 廣告活動 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
 必填
campaign.status 如要顯示已暫停、有效和已移除的廣告活動，則為必填。
如果只顯示有效廣告活動，則可不填。
R.40 廣告群組廣告 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions 		必填
ad_group_ad.status 如要顯示已暫停、有效和已移除的廣告，則必須提供。
如果只顯示有效廣告，則可不填。
R.50 關鍵字檢視 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
ad_group_criterion
 .position_estimates
 .first_page_cpc_micros
ad_group_criterion
 .position_estimates
 .first_position_cpc_micros 		必填
ad_group_criterion.status 如要顯示已暫停、有效和已移除的關鍵字，則為必填。
如果只顯示有效關鍵字，則可不填。
R.70 搜尋字詞檢視 search_term_view.search_term
segments.search_term_match_type
metrics.clicks
metrics.cost_micros
metrics.impressions 		必填
R.100 動態搜尋廣告搜尋字詞檢視 dynamic_search_ads_search_term_view.search_term
metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions 		只有在導入動態搜尋廣告時才需要。
R.130 出價策略 bidding_strategy.type
metrics.clicks
metrics.cost_micros
metrics.cost_per_conversion
metrics.impressions
metrics.average_cpc
metrics.conversions 		必填
bidding_strategy.status 如果顯示已暫停、有效及已移除的策略，則為必要功能。
如果只顯示有效策略，則可省略。

應用程式廣告活動工具功能清單

項目編號 功能 物件/欄位/指南 規定

建立功能
C.20 啟用指定地理區域 指定地區 必要。 如果使用者族群只與一個國家/地區相關，則可選擇是否向使用者顯示。
C.30 啟用指定語言 campaign_criterion.language
language_constant		 必填。如果使用者族群只與一種語言相關，則可選擇是否向使用者顯示。
C.65 建立網站/來電轉換，並產生程式碼片段 轉換追蹤 至少須採用一種轉換追蹤。
C.96 設定出價選項：目標單次動作出價 (組合和標準) campaign.target_cpa (標準)
bidding_strategy.target_cpa (組合)		 必填。廣告活動層級必須同時支援組合和標準策略。
設定出價選項：預先註冊 預先註冊應用程式廣告 預先註冊應用程式廣告活動必須提供。
C.190 建立廣告群組 ad_group 必填。選用：可建立多個廣告群組。
在廣告群組中新增素材資源 ad_group 必要：文字素材資源。圖片和影片素材資源可選用。
C.601 建立安裝或再參與 應用程式廣告活動   必要：應用程式廣告活動安裝或應用程式廣告活動再參與，但不能兩者都選。
C.602 啟用應用程式廣告活動設定 AppCampaignSetting 必要：能夠選取要宣傳的應用程式，或新增參與式深層連結。

管理功能
M.601 暫停/啟用/移除應用程式廣告活動 campaign.status 必填
M.602 編輯應用程式廣告活動設定 campaign.*setting 必填

報表功能
R.10 帳戶成效 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions 		必填
R.20 廣告活動成效 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
 如要顯示已暫停、有效和已移除的廣告活動，則為必填。
如果只顯示有效廣告活動，則可不填。

飯店專用工具功能清單

項目編號 功能 物件/欄位/指南 規定

建立功能
C.11 建立飯店廣告活動 飯店廣告活動 必填
C.12 設定飯店廣告活動的 Hotel Center ID HotelSettingInfo 必填
C.20 啟用指定地理區域 指定地區 必填 如果使用者族群只與一個國家/地區相關，則可選擇是否向使用者顯示。
C.30 啟用指定語言 campaign_criterion.language
language_constant		 必填。如果使用者族群只與一種語言相關，則可選擇是否向使用者顯示。
C.65 建立網站/來電轉換，並產生程式碼片段 轉換追蹤 至少須採用一種轉換追蹤。
C.120 設定預算 campaign_budget 必填
  設定出價策略 飯店出價 可選擇是否允許使用者選擇特定出價策略並設定目標。
C.190 建立飯店廣告群組 ad_group 必填。選用：可建立多個廣告群組。
C.526 新增第一個 (根) 劃分飯店群組劃分 飯店商家資訊群組 這是放送飯店廣告活動的必要條件，但不必向使用者顯示。

管理功能
M.10 編輯廣告活動設定 campaign.*setting 必填
M.110 暫停/啟用/移除廣告活動 campaign.status 必填
M.161 細分 (新增飯店群組分區) 飯店商家資訊群組 必填
M.191 排除飯店群組 AdGroupCriterion 必填

報表功能
R.10 帳戶成效 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions 		必填
R.20 廣告活動成效 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
 如要顯示已暫停、有效和已移除的廣告活動，則為必填。
如果只顯示有效廣告活動，則可不填。
R.111 飯店成效檢視報表 hotel_performance_view 必填

最高成效廣告活動功能清單

項目編號 功能 物件/欄位/指南 規定

建立功能
C.10 建立廣告活動 campaign 必填。選用：可建立多個廣告活動。
C.20 啟用指定地理區域 指定地區 必要。 如果使用者族群只與一個國家/地區相關，則可選擇是否向使用者顯示。
C.30 啟用指定語言 campaign_criterion.language
language_constant		 必填。如果使用者族群只與一種語言相關，則可選擇是否向使用者顯示。
C.65 建立網站/來電轉換，並產生程式碼片段 轉換追蹤 至少須採用一種轉換追蹤。
C.120 設定預算 campaign_budget 必填
  設定出價策略   可選擇是否允許使用者選擇特定出價策略並設定目標。

管理功能
M.10 編輯廣告活動設定 campaign.*setting 必填。只有建立時必要的設定，在變更時才需要提供。
M.110 暫停/啟用/移除廣告活動 campaign.status 必填

報表功能
R.10 客戶 metrics.clicks
metrics.cost_micros
metrics.conversions
 必填。如果只顯示一個廣告活動，則可不填。
R.20 廣告活動 metrics.clicks
metrics.cost_micros
metrics.conversions
 必填

智慧廣告活動功能清單

下表定義了導入智慧廣告活動所需的最少功能。如果您的工具導入了智慧廣告活動，則至少必須導入這組功能。如果工具未導入智慧廣告活動，則不需要這些功能。

項目編號 功能 物件/欄位/指南 規定

建立功能
C.10 建立智慧廣告活動 智慧廣告活動 必填
  新增關鍵字主題 KeywordThemeInfo 建立廣告活動時必須提供，但可選擇是否向使用者顯示。
C.20 啟用指定地理區域 指定地區 建立廣告活動時必須提供，但可選擇是否向使用者顯示。
C.70 地點素材資源 地點素材資源 只有在與商家檔案整合時才需要。
C.120 設定預算 campaign_budget 必填
C.200 新增廣告 建立廣告 建立廣告活動時必須提供，但可選擇是否向使用者顯示。

管理功能
M.10 編輯廣告活動設定 (向廣告主顯示所有廣告活動建立設定) campaign.*setting 必填
M.110 暫停/啟用/移除廣告活動 campaign.status 必填
M.130 暫停/啟用/移除廣告 ad_group_ad.status 必填
  設定/編輯廣告活動時間表 ad_schedule 必填
  移除/新增關鍵字主題 KeywordThemeInfo 建立廣告活動時必須提供，但可選擇是否向使用者顯示。
  新增/移除排除關鍵字主題 KeywordThemeInfo 建立廣告活動時必須提供，但可選擇是否向使用者顯示。

報表功能
R.20 廣告活動成效 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
 如要顯示已暫停、有效和已移除的廣告活動，則為必填。 如果只顯示有效廣告活動，則可選填。
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL
SMART_CAMPAIGN_MAP_DIRECTIONS 		只有在與商家檔案整合時才需要。
R.70 智慧廣告活動搜尋字詞檢視畫面 metrics.clicks
metrics.cost_micros
 必填

標準購物廣告活動工具功能清單

項目編號 功能 物件/欄位/指南 規定

建立功能
C.10 建立廣告活動 campaign 必填
C.20 啟用指定地理區域 指定地區 必要。 如果使用者族群只與一個國家/地區相關，則可選擇是否向使用者顯示。
C.65 建立網站/來電轉換，並產生程式碼片段 轉換追蹤 至少須採用一種轉換追蹤。
C.97 設定出價選項：目標廣告投資報酬率 (組合和標準) campaign.target_roas (標準)
bidding_strategy.target_roas (組合)		 必填。廣告活動層級必須同時支援組合和標準策略。
C.120 設定預算 campaign_budget 必填
C.190 建立廣告群組 ad_group 必填。選用：可建立多個廣告群組。
C.270 替廣告活動排除關鍵字 campaign_criterion.negative 必填
C.300 設定關鍵字比對類型 ad_group_criterion.keyword
 .match_type		 必填
C.505 設定商家識別碼   必填
C.506 設定銷售國家/地區   必填
C.510 設定廣告空間篩選器   必填
C.520 建立產品廣告   必填
C.525 新增第一個 (根) 產品分區   必填
C.530 建立店面商品目錄廣告   必填

管理功能
M.10 編輯廣告活動設定 campaign.*setting 必填。只有建立時必要的設定，在變更時才需要提供。
M.97 編輯出價選項：目標廣告投資報酬率 (組合和標準) campaign.target_roas (標準)
bidding_strategy.target_roas (組合) 		必填。廣告活動層級必須同時支援組合和標準策略。
M.110 暫停/啟用/移除廣告活動 campaign.status 必填
M.150 修改廣告空間篩選器   必填
M.160 細分 (新增產品分區)   必填
M.170 刪除產品分區   必填
M.190 排除產品劃分   必填

報表功能
R.10 客戶 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversion_value
 必填。如果只顯示一個廣告活動，則可不填。
R.20 廣告活動 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversion_value
 必填
R.70 搜尋字詞檢視 search_term_view.search_term
segments.search_term_match_type
metrics.clicks
metrics.cost_micros
metrics.impressions 		必填
R.110 購物成效 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversion_value
 只有在導入動態搜尋廣告時才需要。
R.120 產品劃分 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversion_value
 必填。如果產品未細分，則為選用
R.130 出價策略成效   必填。如果產品未細分，則為選用
上一頁
價目表
下一頁
違規費用