基本基本功能

2022 年 10 月 6 日

基本基本功能 (RMF) 是指某些工具開發人員使用 Google Ads API 時,必須提供的功能和其他功能。如下所述,RMF 規則分為三個類別:「建立功能」、「管理功能」和「報表功能」。您必須遵守這些規則的使用方式,取決於您使用 Google Ads API 的方式 (「需遵守 RMF 規定」表示 RMF 適用情況):

建立功能 管理功能 報表功能
全方位工具
  • 廣告客戶、代理商及其他第三方可使用您的工具 管理他們的 Google Ads 帳戶
需遵守 RMF 規定 需遵守 RMF 規定 需遵守 RMF 規定
僅限報表
  • 廣告客戶只能使用報表資訊主頁
不適用 RMF 規定 不適用 RMF 規定 需遵守 RMF 規定
僅供內部使用
  • 僅限廣告客戶或代理商使用,而且第三方 無法存取您的工具 (這表示您是唯一使用這項工具的公司)
不適用 RMF 規定 不適用 RMF 規定 不適用 RMF 規定

如果您的工具提供的功能有限,且無法用來建立及管理廣告活動、廣告群組和廣告,就可能無法使用全方位服務工具。在這種情況下,建立和管理 RMF 就不適用。如果您不確定自己的工具是否適用「RMF」政策,請與 Google Ads API 法規遵循團隊聯絡。Google Ads API 法規遵循團隊將決定您的工具是否可正常使用。 如果工具功能有大幅變動,您可以重新評估。

請注意,RMF 只適用於具有標準存取權的開發人員權杖。

可進行重大更新的一次性擴充功能

有鑑於 API 工具可能會定期執行大量技術升級,只要符合所有 RMF 期限至少連續 2 年的工具,就可以申請延長 6 個月的 RMF 延長使用時間,以便將這些平台的升級導入平台。如果擴充功能獲得核准,則在擴充功能期間,我們不會審查這些工具是否符合 RMF 規定。工具在擴充功能期結束時,該工具必須符合在擴充功能期間最後日期當天或之前的所有 RMF 規定。在擴充功能期滿後到期的所有 RMF 規定,仍將保留在下表中指定的日期。

API 工具最多可以每四年最多使用一個擴充功能 (第二次擴充時,至少需在擴充功能啟動後至少 4 年)。

如果您想為工具申請延期,請透過 https://support.google.com/adspolicy/contact/contact_ads_api 與我們聯絡來申請申請表。您的申請必須由貴公司的高階主管 (CEO、技術長或資深副總裁) 簽名並提交。請注意,我們不保證您的申請能獲得核准。

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

如果您的工具僅用於建立及管理以下其中一種廣告活動類型,那麼您只需導入 Google Ads API 建立和管理功能,以及與該廣告活動類型搭配使用的「RMM」報表即可。

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

為配合「RMF」規定,「報表專用 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 用戶端的相關規定

為配合 RMF 相關規定,全方位服務 Google Ads API 用戶端必須執行下表中所有必要建立和管理功能,並顯示下方各報表的報表功能。 此外,您必須確實盡全力確保每項功能的使用便利性,且為廣告客戶提供功能。

提供 Planning 服務的 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 規定的條件,任何新的必要功能都必須在到期日前加入 (顯示在各項功能的旁邊,以 Due: 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.80 網站連結額外資訊 網站連結資訊提供預留位置
額外資訊設定服務
動態饋給服務
必要欄位。這項功能只能在帳戶層級加以支援。
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 出價策略成效   必要欄位。如果產品無法細分,此為選填屬性