2 階層企業管理平台解決方案原本的設計為每個用戶存取權杖只能建立一個下層企業管理平台。不過,現在用戶只要在每個下層企業管理平台上設定主要粉絲專頁,即可建立多個下層企業管理平台。
注意:根據應用程式設定中是否啟用 appsecret_proof,您在進行每個呼叫時,可能會需要 appsecret_proof 做為參數。請參閱保護圖形 API 要求文件,瞭解如何設定此選項,以及如何產生 appsecret_proof。
開始之前,建議您先查看以下必備條件和資訊:
business_management
ads_management
PARENT_BM_ID
:擁有應用程式的合作夥伴企業管理平台編號。CHILD_BM_ID
:上層企業管理平台為客戶建立的企業管理平台編號。USER_Personal_Access_Token
:提供憑證來建立下層企業管理平台的用戶存取權杖。
business_management
範圍,而不是細項範圍。PARENT_BM_ADMIN_SYSTEM_USER_ACCESS_TOKEN
:上層企業管理平台中的管理員系統用戶存取權杖。
CHILD_BM_SYSTEM_USER_ACCESS_TOKEN
:在下層企業管理平台中建立之管理員系統用戶的存取權杖。
使用 USER_Personal_Access_Token 來建立建立下層企業管理平台。
範例:傳回下層企業管理平台編號
curl \ -F 'id=<Parent_Business_Manager_ID>' \ -F 'name=Advertisers child BM (recommend naming similar to page)' \ -F 'vertical=OTHER' \ // Specify the Business vertical -F 'shared_page_id=<PAGE_ID_FROM_USER>' \ //Optional parameter but needed if you want to publish ads promoting this page //Note: the user must be an admin of the BM that owns this page if this page is owned -F 'page_permitted_tasks=["ADVERTISE", "ANALYZE"]' \ -F 'timezone_id=1' \ -F 'access_token=<USER_Personal_Access_Token>' \ -F 'appsecret_proof=<APP_SECRET_PROOF>' \ // Optional, depending on your app's security settings https://graph.facebook.com/<API_VERSION>/<PARENT_BM_Id>/owned_businesses
回應:
{ “ID” : “12312812123132” //store this child business manager ID and associate to user }
如果用戶想要使用相同的用戶憑證來建立多個下層企業管理平台,則必須在為該用戶建立的現有下層企業管理平台上設定 primary_page
。請發出另一個 POST
呼叫,以設定現有下層企業管理平台的 primary_page
:
curl \ -F 'primary_page=<PAGE_ID>' \ -F 'access_token=<USER_Personal_Access_Token>' \ -F 'appsecret_proof=<APP_SECRET_PROOF>' \ // Optional, depending on your app's security settings https://graph.facebook.com/<API_VERSION>/<BM_ID>
建立另一個下層企業管理平台時:
primary_page
。shared_page_id
。shared_page_id
已用來建立新的下層企業管理平台,就不能是任何現有下層企業管理平台上的 primary_page
。若要為下層企業管理平台廣告付款,您需要與每個下層企業管理平台分享您的帳號額度。
步驟 1:開設帳號額度。請聯絡您的 Facebook 業務代表,在該企業管理平台中開設 LOC(如果還沒有)。帳號額度會在您的上層企業管理平台中顯示為付款方式。
步驟 2:接受「帳號額度法律條款」。
步驟 3:擷取帳號額度編號,並與下層企業管理平台分享
PARENT_BM_Line_Of_Credit_ID
。網址如下所示:
https://business.facebook.com/settings/payment-methods/<PARENT_BM_Line_Of_Credit_ID>?business_id=<BUSINESS_ID>
amount
為選用項目。
curl \ -F 'receiving_business_id=<CHILD_BUSINESS_MANAGER_ID>' \ -F 'amount=<OPTIONAL_PARAMETER>' \ -F 'access_token=<Parent_BM_Admin_System_User_Access_Token>' \ -F 'appsecret_proof=<APP_SECRET_PROOF>' \ // Optional, depending on your app's security settings https://graph.facebook.com/<API_VERSION>/<PARENT_BM_Line_Of_Credit_ID>/owning_credit_allocation_configs
如果您未指定金額,帳號額度將平均分配給各個下層企業管理平台。
如果僅指定一個金額,則該部分的帳號額度會指派給下層企業管理平台。
在下層企業管理平台中,使用此 API 呼叫來建立系統用戶並擷取存取權杖。此權杖會用於對下層企業管理平台的所有後續呼叫,為此用戶建立或管理廣告。
curl \ -F 'id=<CHILD_BUSINESS_MANAGER>' \ -F 'app_id=<App_ID>' \ -F 'scope=ads_management,business_management' \ -F 'access_token=<Parent BM Admin System User Access Token>' \ -F 'appsecret_proof=<APP_SECRET>' \ https://graph.facebook.com/<API_VERSION>/<CHILD_BUSINESS_MANAGER_ID>/access_token
取得存取權杖後,您可以用它來找出應用程式範圍內的用戶編號。這對於稍後儲存編號非常重要。
curl -G \ -d 'access_token=<Child BM System User Access Token>' \ -d 'appsecret_proof=<APP_SECRET_PROOF>' \ // Optional, depending on your app's security settings https://graph.facebook.com/<API_VERSION>/<CHILD_BM_ID>/system_users
curl -G \ -d 'fields=id,max_balance' \ -d 'access_token=<Child BM Admin System User Access Token>' \ -d 'appsecret_proof=<APP_SECRET_PROOF>' \ // Optional, depending on your app's security settings https://graph.facebook.com/<API_VERSION>/<CHILD_BUSINESS_MANAGER_ID>/extendedcredits或者,您可以前往下層企業管理平台,並選擇付款 > 點擊帳號額度付款方式,以擷取加值來源。這樣會在網址中填入付款參數,如下所示:
payment-methods/<CHILD_PAYMENT_METHOD_ID>?business_id=
使用下層企業管理平台中的付款方式編號做為 funding_id
參數。
廣告帳號建立後,即無法更新 funding_id
。
curl \ -F 'name=Advertisers Ad Account' \ -F 'currency=USD' \ -F 'timezone_id=1' \ -F 'end_advertiser=<PAGE_ID>' \ -F 'media_agency=NONE' \ -F 'partner=NONE' \ -F 'funding_id=<PAYMENT_METHOD_ID(from above)>' \ -F 'access_token=<Child BM Admin System User Access Token>' \ -F 'appsecret_proof=<APP_SECRET_PROOF>' \ // Optional, depending on your app's security settings https://graph.facebook.com/<API_VERSION>/CHILD_BM_ID/adaccount
在下層企業管理平台中,新增系統用戶做為新廣告帳號的管理員:
curl \ -F 'user=<SYSTEM_USER_ID(from above)>' \ -F 'tasks=MANAGE,ADVERTISE,ANALYZE' \ -F 'business=<CHILD_BM_ID>' \ -F 'access_token=<Child BM Admin System User Access Token>' \ -F 'appsecret_proof=<APP_SECRET_PROOF>' \ // Optional, depending on your app's security settings https://graph.facebook.com/<API_VERSION>/<act_ACCOUNT_ID>/assigned_users
恭喜!這是設定下層企業管理平台來建立和管理客戶行銷活動的最後一步。
若要尋找所有下層企業管理平台編號,請執行下列指令,依客戶的應用程式範圍用戶編號進行篩選:
curl -i -X GET \ -F 'access_token=<PARENT_BM_ADMIN_SYSTEM_USER_ACCESS_TOKEN>' \ -F 'appsecret_proof=<APP_SECRET_PROOF>' \ // Optional, depending on your app's security settings "https://graph.facebook.com/<API_VERSION>/<parent_bm_id>/owned_businesses?client_user_id=<Client’s app scoped user ID>
使用 /me?fields=ids_for_apps
(客戶的用戶存取權杖)尋找應用程式範圍用戶編號。