授權

授權程序會驗證將存取行銷 API 的用戶和應用程式,並授予其權限。

應用程式角色

在應用程式主控板中,您可以視需要為自己或團隊成員設定角色:管理員、開發人員、測試人員。

注意:根據您的預定使用案例,您可能需要提交應用程式進行審查,以獲得與廣告管理相關的特定權限。

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

商業應用程式受限於稱為存取權限層級的額外圖形 API 授權階層。在應用程式審查期間,應用程式也必須要求特定的權限和功能。

各層級均有其限制,詳情請參閱存取權限層級和功能,也請所有開發人員務必遵循所有 Meta《開放平台使用條款》和開發商政策任何存取權限層級的呼叫都是對照生產資料發出。

行銷 API 存取權限層級與廣告管理一般存取權限

應用程式的權限和功能有兩種不同的存取權限層級:一般存取權限和進階存取權限(注意:這裡使用的「一般存取權限」一詞與「廣告管理一般存取權限」功能無關。)「廣告管理一般存取權限」的進階存取權限層級仍要求應用程式必須通過審查,才能存取該功能。

行銷 API 存取權限與廣告管理一般存取權限對照

行銷 API 存取權限廣告管理一般存取權限動作

開發存取權限

一般存取權限

預設

一般存取權限

進階存取權限

在應用程式主控板中申請

若要檢查目前的存取權限層級,請前往「應用程式主控板」>「應用程式審查」>「權限和功能」。

權限和功能

權限

您應該要求的權限會依您想要存取的 API 而不同。

如果您的應用程式只管理您的廣告帳號,則 ads_readads_management 的一般存取權限即已足夠。如果您的應用程式也管理其他用戶的廣告帳號,則需要 ads_read 和/或 ads_management 的進階存取權限。請參閱所有可用的商業應用程式權限

功能

您應該要求的功能會依您想要使用 API 的方式而不同。如果您要管理廣告,經常要求的功能為廣告管理一般存取權限。請參閱所有可用的商業應用程式功能

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

一般存取權限

商業應用程式會針對適用於商業應用程式類型的所有權限和功能的一般存取權限進行自動批准。

如果您是新手,請使用此選項。您可以在要求完整權限之前建置端對端工作流程,並存取不限數量的廣告帳號。

部分 API 呼叫可能不適用於一般存取權限,因其可能屬於多個帳號,或是無法以程式設計方式識別受影響的帳號。

進階存取權限

進階存取權限必須根據個別權限和功能,經由應用程式審查程序獲得批准。

  1. 如需要求進階存取權限,請前往應用程式的主控板,然後點擊「應用程式審查」>「權限和功能」。
  2. 找到您想要存取的權限或功能,然後點擊「動作」下方的「要求進階存取權限」。您可以選擇一或多個功能。選擇完選項後,點擊「繼續要求」,即可進入引導您完成提交程序的畫面。

提交資訊後,Meta 會做出「接受」或「拒絕」的回覆;如果您的應用程式不符合一般存取權限的資格,則回覆中也會包含其他相關資訊。

如果您獲准使用進階存取權限,必須進行下列操作才能維持您的狀態:

  • 在過去 15 天內已成功發出至少 1500 次行銷 API 呼叫。
  • 在過去 15 天內發出的行銷 API 呼叫錯誤率低於 10%。
存取權限層級的意義

下表顯示一般和進階存取權限層級對「廣告管理一般存取權限」功能有何影響。

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

帳號限制

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

管理不限數量的廣告帳號(假設您已經取得該廣告帳號的 ads_readads_management 權限)。

速率限制

依廣告帳號高度限速。僅供開發之用。不適用於刊登真實廣告商廣告的生產應用程式。

依廣告帳號低度限速

企業管理平台

企業管理平台目錄 API 的存取有所限制。無法存取企業管理平台來管理廣告帳號、用戶權限和粉絲專頁。

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

系統用戶

可建立 1 位系統用戶和 1 位管理員系統用戶。

可建立 10 位系統用戶和 1 位管理員系統用戶。

建立粉絲專頁

無法透過 API 建立粉絲專頁。

無法透過 API 建立粉絲專頁。

取得進階存取權限

為了取得「廣告管理一般存取權限」的進階存取權限,您的應用程式必須符合以下必備條件:

  • 在過去 15 天內已成功發出至少 1500 次行銷 API 呼叫。
  • 在過去 15 天內發出的行銷 API 呼叫錯誤率低於 10%。

如果您要管理用戶的廣告,請使用 scope 參數提示用戶授予 ads_managementads_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_managementads_read
  • 功能:廣告管理一般存取權限

商家驗證

商家驗證是讓我們驗證貴企業實體身分的程序,如果您的應用程式會存取敏感資料,我們將需要取得此實體身分。深入瞭解商家驗證程序。