如要存取推廣 API 端點,您的應用程式必須清除 Graph API 授權的多個層級。
當您建立 Facebook 應用程式時,系統會詢問您該應用程式的用途。您所作的選擇會決定應用程式的類型:商業、遊戲或者無。請查看應用程式類型。
若要存取推廣 API 端點,您需要建立商業應用程式。請查看商業應用程式可用的產品。
註冊應用程式後,您可以為任何擁有開發人員帳戶而會助您開發應用程式的用戶分配角色。
商業應用程式還需受制於另一層 Graph API 授權層級,稱為存取權限級別。在應用程式審查期間,您的應用程式亦必須申請特定的權限和功能。
功能存取權限級別 | 說明 |
---|---|
商業應用程式會自動通過標準存取權限的審查,可以使用適用於商業應用程式類型的所有權限和功能。 如果您是新手入門,請使用此選項。您可以在申請完整權限之前先建立端到端工作流程。您可以使用的廣告帳戶不限數量。 由於有些 API 呼叫可能屬於多個帳戶,或者系統無法透過程式輔助的方式識別受影響的帳戶,因此可能無法以標準存取權限執行這些呼叫。 | |
如需獲批進階存取權限,則必須就各個權限和功能申請分別通過應用程式審查程序以獲批准。 如需申請進階存取權限,請前往您應用程式的管理中心,然後點擊應用程式審查 > 權限和功能。 找出您想使用的權限或功能,然後點擊動作下方的申請進階存取權限。您可選擇一項或多項功能。選定選項後,點擊繼續要求,您將前往另一頁面,當中指示您完成整個提交流程。 提交資訊後,Facebook 會回覆批准或拒絕,如果您的應用程式不符合資格獲取標準存取權限,也會提供相關資訊。 如果您獲准使用進階存取權限,則需要完成以下操作以維持您的獲批狀態:
|
每個級別都設有各自的限制,詳情請參閱存取權限級別和功能。此外,所有開發人員亦必須遵守所有 Facebook 平台使用條款和開發商政策。就任何存取權限級別所執行的呼叫均以正式版數據為依據。
如要查看您目前的存取權限級別,請前往應用程式管理中心 > 應用程式審查 > 權限和功能。
推廣 API 存取權限 | 廣告管理一般存取權限 | 行動 |
---|---|---|
開發權限 | 一般存取權限 | 預設 |
一般存取權限 | 進階存取權限 | 需要在應用程式管理中心申請 |
視乎您希望存取的 API,您應該要求的權限將有所不同。
如果您的應用程式僅用於管理自己的廣告帳戶,則標準存取權限以及 ads_read
和 ads_management
權限已足夠。如果您的應用程式需要管理其他人的廣告帳戶,則需要進階存取權限 ads_read
和/或 ads_management
權限。請查看適用於商業應用程式的所有權限。
視乎您的 API 使用方式,您應該要求的功能將有所不同。如果您要管理廣告,您需要要求的其中一項常用功能則會是 Ads Management Standard Access
。請查看適用於商業應用程式的所有功能。
如要獲得廣告管理一般存取權限的進階存取權限,您的應用程式需要符合以下要求:
如果您要管理其他用戶的廣告,請使用 scope
參數來提示用戶提供 ads_management
或 ads_read
權限。當用戶點擊允許後,您的應用程式就會取得存取權限:
https://www.facebook.com/v21.0
/dialog/oauth?
client_id=<YOUR_APP_ID>
&redirect_uri=<YOUR_URL>
&scope=ads_management
輸入 YOUR_URL 欄位時,請在行尾加上 /
。範例:http://www.facebook.com/
使用案例 | 要求內容 |
---|---|
您想讀取及管理以下廣告帳戶的廣告:歸您所有或已獲廣告帳戶擁有者授予存取權限的廣告帳戶。 |
|
您想讀取以下廣告帳戶的廣告分析報告:歸您所有或已獲廣告帳戶擁有者授予存取權限的廣告帳戶。 |
|
您想提取一組客戶的廣告分析報告,並同時讀取及管理另一組客戶的廣告。 |
|
下表顯示了標準和進階存取權限級別對廣告管理標準存取權限功能的影響。
標準存取權限 | 進階存取權限 | |
---|---|---|
帳戶限制 | 管理無限量廣告帳戶。應用程式管理員或開發人員可代表廣告帳戶管理員或廣告客戶執行 API 呼叫。 | 假如您從廣告帳戶獲取了 |
傳輸限速 | 每個廣告帳戶設有相當嚴格的傳輸限速門檻。僅限開發目的使用,不適用於為實際廣告客戶運行的已發行應用程式。 | 每個廣告帳戶僅設有較寬鬆的傳輸限速門檻。 |
企業管理平台 | ||
系統用戶 | 可建立 1 個系統用戶與 1 個管理員系統用戶。 | 可建立 10 個系統用戶與 1 個管理員系統用戶。 |
建立專頁 | 無法透過 API 建立專頁。 | 無法透過 API 建立專頁。 |
應用程式的權限和功能包含兩種不同的存取權限級別:標準存取權限和進階存取權限。請注意,此處的「標準存取權限」與「廣告管理標準存取權限」功能無關。廣告管理一般存取權限要求應用程式通過審查,然後才能獲得功能的進階存取權限。
商家驗證是一項讓我們驗證您企業實體身分的程序;如果您的應用程式會存取敏感資料時,我們便會要求您完成此項驗證程序。進一步了解商家驗證程序。