設定新的下層企業管理平台

2 階層企業管理平台解決方案原本的設計為每個用戶存取權杖只能建立一個下層企業管理平台。不過,現在用戶只要在每個下層企業管理平台上設定主要粉絲專頁,即可建立多個下層企業管理平台。

注意:根據應用程式設定中是否啟用 appsecret_proof,您在進行每個呼叫時,可能會需要 appsecret_proof 做為參數。請參閱保護圖形 API 要求文件,瞭解如何設定此選項,以及如何產生 appsecret_proof

開始使用

開始之前,建議您先查看以下必備條件和資訊:

應用程式權限

  • business_management
  • ads_management

編號

  • PARENT_BM_ID:擁有應用程式的合作夥伴企業管理平台編號。
  • CHILD_BM_ID:上層企業管理平台為客戶建立的企業管理平台編號。

存取權杖

  • USER_Personal_Access_Token:提供憑證來建立下層企業管理平台的用戶存取權杖。
    • 此權杖是使用「Facebook 登入」所產生。
    • 合作夥伴應要求用戶的商家和粉絲專頁全域 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:接受「帳號額度法律條款」。

  1. 開啟企業管理平台 > 企業管理平台設定 > 付款方式
  2. 點擊額度設定,然後按一下「法律條款」。接受法律條款

步驟 3:擷取帳號額度編號,並與下層企業管理平台分享

  1. 前往上層企業管理平台和企業管理平台設定 > 付款方式,點擊付款方式。儲存網址中的 PARENT_BM_Line_Of_Credit_ID。網址如下所示:
    https://business.facebook.com/settings/payment-methods/<PARENT_BM_Line_Of_Credit_ID>?business_id=<BUSINESS_ID>
  2. 在下面的 API 呼叫中使用此上層企業管理平台帳號額度編號,將上層企業管理平台的帳號額度編號分享給下層企業管理平台。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

取得加值來源編號(LOC)

  1. 在下層企業管理平台中擷取新的加值來源。在此範例中,稍後在建立廣告帳號時,會使用此加值來源。
  2. 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=
  3. 儲存此付款方式編號,以供稍後使用。

使用預設加值來源建立新的廣告帳號

使用下層企業管理平台中的付款方式編號做為 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(客戶的用戶存取權杖)尋找應用程式範圍用戶編號。

後續步驟

後續主題包括可用來提升企業管理平台體驗的其他功能/動作。

此外,請參考資產分享指南將用戶資產存取至下層企業管理平台: