授權

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

階層 1:應用程式類型

建立 Facebook 應用程式時,系統會詢問您應用程式的使用方式。您所做的選擇將決定應用程式類型:企業遊戲。請參閱應用程式類型

若要存取行銷 API 端點,您需要建立企業應用程式。請參閱可用的企業應用程式產品

完成應用程式註冊之後,您可以指派角色給具有開發人員帳號的任何人,這些人將會協助您進行開發。

階層 2:存取權限層級、權限和功能

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

存取權限層級

存取權限層級說明

標準存取權限

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


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


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

進階存取權限

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


如需要求進階存取權限,請前往應用程式的主控板,然後點擊「應用程式審查」>「權限和功能」


找到您想要存取的權限或功能,然後點擊「動作」下方的「要求進階存取權限」。您可以選擇一或多個功能。選擇完選項後,點擊「繼續要求」,即可進入引導您完成提交程序的畫面。


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


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

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

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

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

權限和功能

您應該根據自己想要存取的 API 來要求變更的權限。

如果應用程式只負責管理您的廣告帳號,標準存取權限以及 ads_readads_management 權限就已足夠。如果應用程式負責管理其他用戶的廣告帳號,則需要進階存取權限 ads_read 和/或 ads_management 權限。請參閱所有可用的企業應用程式權限

您應該根據自己想要的 API 使用方式來要求變更的功能。如果您要管理廣告,經常要求的功能為 Ads Management Standard Access。請參閱所有可用的企業應用程式功能

為了取得廣告管理標準權限的進階存取權限,您的應用程式需要符合以下必備條件:

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

如果您要管理用戶的廣告,請使用 scope 參數提示用戶授予 ads_managementads_read 權限。當用戶點擊「允許」時,您的應用程式即可得到存取權限:

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

輸入 YOUR_URL 欄位時,請在最後面加上 /,例如:http://www.facebook.com/

範例

使用案例要求方式

您希望讀取及管理您自有廣告帳號的廣告,或是廣告帳號擁有者授權您存取的廣告。

  • 權限:ads_management
  • 功能:Ads Management Standard Access

您希望讀取您自有廣告帳號的廣告分析報告,或是廣告帳號擁有者授權您存取的廣告分析報告。

  • 權限:ads_read
  • 功能:Ads Management Standard Access

您希望自一組用戶端提取廣告分析報告,以及讀取和管理另一組用戶端的廣告。

  • 權限:ads_managementads_read
  • 功能:Ads Management Standard Access

存取權限層級和功能

下表顯示標準和進階存取權限層級如何影響廣告管理標準存取功能。

標準存取 進階存取

帳號限制

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

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

速率限制

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

依廣告帳號低度限速

企業管理平台

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

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

系統用戶

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

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

建立粉絲專頁

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

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

存取權限層級與廣告管理標準權限

應用程式的權限和功能有兩種不同存取權限層級:標準存取權限和進階存取權限。請注意,此處使用的「標準存取權限」一詞與廣告管理標準權限功能並不相關。廣告管理標準權限的進階存取權限仍要求應用程式必須通過審查,才能夠使用相關功能。

階層 3:商家驗證

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