推廣 API

授權

授權程序會驗證將存取推廣 API 的用戶和應用程式，並向其授予權限。

應用程式角色

在您應用程式的管理中心，您可以按需要為自己或團隊成員設定管理員、開發人員、測試人員的角色。

備註：視乎您的預期用途而定，您可能需要提交應用程式以供審查，進而獲得與廣告管理相關的特定權限。

存取權限級別、權限和功能

商業應用程式還需受制於另一層 Graph API 授權層級，稱為存取權限級別。在應用程式審查期間，您的應用程式亦必須申請特定的權限和功能。

每個級別都設有各自的限制，詳情請參閱存取權限級別和功能。此外，所有開發人員亦必須遵守所有 Meta 的《平台使用條款》和開發商政策。就任何存取權限級別所執行的呼叫均以正式版數據為依據。

推廣 API 存取權限級別與廣告管理標準權限

應用程式的權限和功能分為兩種不同存取權限級別：一般存取權限與進階存取權限（備註：此處所指的「一般存取權限」與廣告管理標準權限功能無關）。應用程式仍要需通過審查，才能獲得廣告管理標準權限功能的進階存取權限。

對應推廣 API 存取權限與廣告管理標準權限

推廣 API 存取權限廣告管理標準權限動作

開發權限

一般存取權限

預設

一般存取權限

進階存取權限

在應用程式管理中心申請

如要查看您目前的存取權限級別，請前往應用程式管理中心 > 應用程式審查 > 權限和功能。

權限和功能

權限

視乎您希望存取的 API，您應該申請的權限將有所不同。

如果您的應用程式僅用於管理自己的廣告帳戶，只需取得 ads_read 與 ads_management 權限的一般存取權限已足夠。如果您的應用程式需要管理其他用戶的廣告帳戶，則需要取得 ads_read 和／或 ads_management 權限的進階存取權限。請查看適用於商業應用程式的所有權限。

功能

視乎您的 API 使用方式，您應該申請的功能將有所不同。如果您要管理廣告，常申請的功能是廣告管標準權限。請查看適用於商業應用程式的所有功能。

功能存取權限級別
功能存取權限級別說明

一般存取權限

商業應用程式會自動通過一般存取權限的審查，可以使用適用於商業應用程式類型的所有權限和功能。

如果您是新手入門，請使用此選項。在申請完整權限之前，您可以建立端對端的工作流程，並可存取數量不限的廣告帳戶。

由於有些 API 呼叫可能屬於多個帳戶，或者系統無法透過程式輔助的方式識別受影響的帳戶，因此可能無法以一般存取權限執行這些呼叫。

進階存取權限

如需獲批進階存取權限，則必須就各個權限和功能申請分別通過應用程式審查程序以獲批准。

  1. 如需申請進階存取權限，請前往您應用程式的管理中心，然後點擊應用程式審查 > 權限和功能。
  2. 找出您想使用的權限或功能，然後點擊動作下方的申請進階存取權限。您可選擇一項或多項功能。完成選擇後，點擊繼續申請。系統會將您帶到新畫面，指引您完成提交程序。

提交資訊後，Meta 會回覆批准或拒絕；如果您的應用程式不符合資格獲取一般存取權限，則會提供額外資訊。

如果您獲准使用進階存取權限，則需要做到以下幾點來維持您的獲批狀態：

  • 在過去 15 天內成功執行最少 1,500 次推廣 API 呼叫。
  • 在過去 15 天內的推廣 API 呼叫出錯率低於 10%。
存取權限的重要性

下表說明一般和進階存取權限級別對廣告管理標準權限功能的影響。

一般存取權限 進階存取權限

帳戶限制

管理數量不限的廣告帳戶。應用程式管理員或開發人員可代表廣告帳戶管理員或廣告客戶執行 API 呼叫。

假如您從廣告帳戶獲取了 ads_read 或 ads_management 權限，便可管理數量不限的廣告帳戶。

限速

每個廣告帳戶設有相當嚴格的傳輸限速門檻。僅限開發目的使用，不適用於為實際廣告客戶運行的正式版應用程式。

每個廣告帳戶僅設有較寬鬆的限速門檻。

企業管理平台

僅可存取部分企業管理平台及目錄 API。無法使用企業管理平台來管理廣告帳戶、用戶權限與專頁。

可存取所有企業管理平台及目錄 API。

系統用戶

可建立 1 個系統用戶與 1 個管理員系統用戶。

可建立 10 個系統用戶與 1 個管理員系統用戶。

建立專頁

無法透過 API 建立專頁。

無法透過 API 建立專頁。

取得進階存取權限

如要獲得廣告管理標準權限的進階存取權限，您的應用程式需要符合以下要求：

  • 在過去 15 天內成功執行最少 1,500 次推廣 API 呼叫。
  • 在過去 15 天內的推廣 API 呼叫出錯率低於 10%。

如果您要管理其他用戶的廣告，請使用 scope 參數來提示用戶提供 ads_management 或 ads_read 權限。當用戶點擊允許後，您的應用程式就會取得存取權限。

https://www.facebook.com/v22.0/dialog/oauth? client_id=<YOUR_APP_ID> &redirect_uri=<YOUR_URL> &scope=ads_management

備註：填寫 YOUR_URL 欄位時，請在結尾加上 /，例如 http://www.facebook.com/。

使用案例範例
使用案例要求內容

您想讀取及管理以下廣告帳戶的廣告：歸您所有或已獲廣告帳戶擁有者授予存取權限的廣告帳戶。

  • 權限：ads_management
  • 功能：廣告管理標準權限

您想讀取以下廣告帳戶的廣告分析報告：歸您所有或已獲廣告帳戶擁有者授予存取權限的廣告帳戶。

  • 權限：ads_read
  • 功能：廣告管理標準權限

您想提取一組客戶的廣告分析報告，並同時讀取及管理另一組客戶的廣告。

  • 權限：ads_management 和 ads_read
  • 功能：廣告管理標準權限

商家驗證

商家驗證是一項讓我們驗證您企業實體身分的程序；如果您的應用程式會存取敏感資料，我們便會要求您完成此項驗證程序。進一步了解商家驗證程序。

了解詳情