最佳做法

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

影片:查看 2019 年研討會的最佳做法最佳做法

本指南將介紹一些最佳做法,協助您提升應用程式的效率和效能。

持續維護

如何確保應用程式正常運作:

  • 請在 API 中心提供最新的開發人員聯絡電子郵件地址。這是我們用來聯絡您的別名。如果我們遵循 API 條款及細則而無法與您聯絡,可能會在您不知情的情況下撤銷您的 API 存取權。避免使用與個人或未監控帳戶相關的個人電子郵件地址。

  • 如要得知產品變更、維護停機時間、淘汰日期等問題,請訂閱我們的

論壇會定期由 Google Ads API 團隊監控,因此很適合用來張貼 API 問題。

  • 確保應用程式符合 Google Ads API 條款及細則 (T&C)。如有必要,權杖審查和法規遵循團隊會透過聯絡電子郵件與您聯絡。如果您對 T&C 有任何疑問或疑慮,可以回覆審查團隊權杖時發送的電子郵件,聯絡審查團隊。

最佳化

批次作業

向 API 發出要求會產生許多固定費用,例如來回網路延遲時間、序列化和反序列化處理,以及對後端系統的呼叫。為降低這些固定費用造成的影響,並提高整體效能,API 中的大部分 專為 不同 方法而設計,可接受各種運算。透過將多項作業批次處理到每個要求中,您可以減少提出要求的次數,以及相關的固定費用。如果可以的話,請避免只執行一項作業來提出要求。

舉例來說,假設您要為多個廣告群組的廣告活動新增 50,000 個關鍵字。請不要提出 50,000 個要求,每個要求各含 1 個關鍵字,而請提出 100 項要求 (各 500 個關鍵字),甚至是提出 10 項要求 (各加入 5,000 個關鍵字)。要求所允許的作業數量設有限制,因此您可能需要調整批次大小,以達到最佳效能。

傳送稀疏物件

將物件傳送至 API 時,欄位必須經過反序列化、驗證,然後儲存在資料庫中。如果只想更新幾個欄位,則傳入完整物件可能會導致額外的處理時間增加,並降低效能。為減緩這一點,Google Ads API 支援稀疏更新,因此您可以在需要變更或需要的物件中填入欄位。稀疏更新處理速度較快,產生錯誤的機率較低。update_mask 中的欄位 (也稱為 FieldMask) 維持不變。

舉例來說,更新概略出價的應用程式可能會使用廣告群組更新,因為只需要填入廣告群組 ID、條件 ID 和出價欄位。

處理及管理錯誤

在開發過程中,您可能會遇到錯誤。本節說明在應用程式中建構錯誤管理的注意事項和策略。此外,請參閱「疑難排解指南」,進一步瞭解如何管理錯誤。

區分要求來源

部分應用程式主要為互動式應用程式,會發出 API 呼叫,以回應使用者在 UI 中執行的動作。其他 API 主要是離線運作,並在定期後端程序中發出 API 呼叫。許多應用程式結合了兩者。思考錯誤管理情形時,建議區分不同類型的要求。

針對使用者提出的要求,您的主要考量是為使用者提供良好的體驗。使用發生的特定錯誤,盡可能在 UI 中向使用者提供充分的背景資訊。提供簡單步驟,協助他們解決錯誤 (請參閱下列建議)。

如果是在後端發起的要求,請為應用程式可能遇到的各種錯誤實作處理常式。請務必納入預設處理常式,以處理罕見或從未發生的錯誤。預設處理常式的處理方式是將失敗作業和錯誤新增至佇列,以供真人操作人員審查及決定適當的解析度。

區分錯誤類型

建立完善的錯誤處理方式時,瞭解 Google Ads API 中錯誤類型之間的差異即可。常見的錯誤類型如下:

  1. 驗證錯誤
  2. 可重試的錯誤
  3. 驗證錯誤
  4. 同步處理相關錯誤

詳情請參閱「錯誤類型」和「常見錯誤」。

同步後端

如果應用程式使用者手動存取 Google Ads 帳戶,他們可能會注意到應用程式不知道的內容,導致應用程式的本機資料庫無法同步處理。如「錯誤類型」指南所述,您可以在發生同步處理錯誤時主動解決,但也可以嘗試主動防止這些錯誤。其中一項主動策略是執行所有帳戶的夜間同步處理工作、擷取帳戶中的 Google Ads 物件,並與本機資料庫進行比較。

記錄檔錯誤

應記錄所有錯誤,以便進行偵錯和監控。請至少記錄要求 ID、導致錯誤的作業和錯誤本身。要記錄的其他資訊包括客戶 ID、API 服務、來回要求延遲時間、重試次數,以及原始要求和回應。

請務必監控 API 錯誤趨勢,以便偵測及解決應用程式問題。建議您自行建立解決方案,或透過許多現成的商業工具使用記錄檔,以產生互動式資訊主頁並傳送自動快訊。

開發

使用測試帳戶

測試帳戶是指實際上並未放送廣告的 Google Ads 帳戶,您可以使用測試帳戶來測試 Google Ads API,並測試您的應用程式連線能力、廣告活動管理邏輯或其他處理功能是否正常運作。開發人員權杖不需要經過核准即可使用在測試帳戶中,則在要求開發人員權杖後,您可以立即透過 Google Ads API 進行開發,即使應用程式尚未接受審查也一樣。