基本必備功能

2022-10-06 版

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

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

如果您的工具功能非常有限且特殊，且無法用於建立及管理廣告活動、廣告群組和廣告，可能就不屬於全方位服務工具。在這種情況下，廣告製作和管理的相關基本必備功能規定就不適用。如果您不確定自己的工具是否需遵守「基本必備功能」政策，請與 Google Ads API 審核團隊聯絡，Google Ads API 法規遵循團隊會決定您的工具是否為全方位服務。 如果工具功能有大幅變動，您可以重新評估。

請注意，「基本必備功能」規定只適用於擁有「標準存取權」的開發人員權杖。

一次性重大更新

有鑑於 API 工具可定期執行大量技術升級，為確保 API 工具可定期執行大量技術升級，如果工具已完全符合所有 RMF 期限至少 2 年，可申請 6 個月的 RMF 延長期限，以便將這類升級作業套用到其平台。若獲準延期，在延長效期內，這些工具將無法審查是否符合「基本必備功能」規定。展延期結束時，工具必須完全符合延展期最後一個日期當天或之前到期的所有「基本必備功能」要求。凡是在延期結束後到期的「基本必備功能」要求，在下表指定的日期仍然有效。

API 工具每四年最多只能獲得一個擴充功能 (第二個展延期限必須在第一次延期結束後至少 4 年)。

如要為工具申請延長期限，請前往 https://support.google.com/adspolicy/contact/contact_ads_api 與我們聯絡。申請書必須由貴公司的高階主管 (CEO、技術長或資深副總裁) 簽署及提交。請注意，我們不保證您的應用程式一定會獲得核准。

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

如果您的工具主要是設計和管理以下其中一種廣告活動類型，那麼您只需要在與該廣告活動類型搭配使用的「基本必備功能」中，導入 Google Ads API 建立和管理功能及報表即可。

「報表專用 Google Ads API 用戶端」的相關規定

為符合「基本必備功能」的條件，「報表專用 Google Ads API 用戶端」必須顯示 Google Ads 報表介面中各階層的「報表功能」。各個 Google Ads 階層可代表帳戶、廣告活動、廣告群組、廣告或關鍵字。舉例來說，如果「報表專用 Google Ads 用戶端」會在報表中顯示「廣告群組」，則必須導入下方所有標示為「必要」的「廣告群組」層級報表功能。

「報表專用 Google Ads API 用戶端」可能會選擇不在 Google Ads 報表介面中顯示特定層級。舉例來說，如果「報表專用 Google Ads API 用戶端」不會在介面中顯示任何「廣告群組」成效資料，就不需要導入任一項「廣告群組」層級報表「基本必備功能」。

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

為符合「基本必備功能」的規定，Google Ads API 用戶端必須預設顯示每份報表中「物件/欄位/指南」欄中標示為必備的所有資料欄。至於所有其他指標欄，則必須以選項的形式提供給 Google Ads API 用戶端的使用者。Google Ads 報表資料應以顯眼易懂的方式呈現，方便使用者存取。

可下載的報告

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

報表日期範圍

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

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

為符合「基本必備功能」的規定，「全方位服務 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 的「關鍵字提案」功能。

為持續符合「基本必備功能」的規定，您必須在到期日前加入所有新的必要功能 (各項功能旁顯示的格式如下：到期日：YYYY-MM-DD)。任何未指定截止日的「基本必備功能」都表示逾期。此外，根據規定，您必須將 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 出價策略成效   必要欄位。如產品未細分，則為選填