總覽

行銷 API 是 HTTP 型 API,可讓您以程式設計的方式來查詢資料、建立和管理廣告,以及執行各種工作。本文內容包括行銷 API、存取權限、版本控制等一般資訊。

由於 API 屬於 HTTP 型,因此適用於任何支援 HTTP 的語言或軟體,包括 cURL 和大部分最新的網頁瀏覽器。行銷 API 建立在 Meta 圖形 API 的最上層,因此應將大部分的要求傳遞至 graph.facebook.com 主機網址

基本概念

您應瞭解這些概念,才能使用行銷 API:

廣告行銷活動架構

Meta 將廣告組織為 3 個層級的架構:行銷活動、廣告組合和廣告。在 API 中,開發人員可存取第 4 個層級:廣告創意。

授權

若要存取行銷 API 端點,應用程式必須清除多個圖形 API 授權階層。

驗證

瞭解如何取得和儲存 API 呼叫所需的存取權杖。

限速

行銷 API 有自己的限速邏輯,並且獨立於所有圖形 API 速率限制之外。

版本控制

Meta 的平台具備核心與延伸版本控制模式。深入瞭解我們的版本控制和移轉系統的近期變更與淘汰項目。請參閱版本排程移轉變更紀錄

應用程式審查

若要使用行銷 API,應用程式須經應用程式審查,其中伺服器端 API 和離線轉換有部分例外。

權限

主要的廣告權限有兩個:ads_managementads_read。您應將權限授予用來進行呼叫的應用程式。您可以在應用程式審查程序期間,要求權限。請參閱商業應用程式的可用權限清單

錯誤代碼

使用 API 時,可能會出現錯誤代碼。請參考此內容,瞭解每個錯誤代碼的詳細資訊。

後續處理

瞭解 Meta 收到要求後的後續處理階段。