새로운 하위 비즈니스 관리자 설정

2티어 비즈니스 관리자 솔루션은 본래 각 사용자 액세스 토큰으로 하나의 하위 비즈니스 관리자만 생성할 수 있도록 설계되었습니다. 그러나 이제 각 하위 비즈니스 관리자에 기본 페이지가 설정되어 있는 한 사용자가 여러 하위 비즈니스 관리자를 생성할 수 있습니다.

참고: appsecret_proof가 앱 설정에서 활성화되어 있는지 여부에 따라 호출을 보낼 때마다 appsecret_proof가 매개변수로 필요할 수 있습니다. 이 옵션을 설정하는 방법과 appsecret_proof를 생성하는 방법은 그래프 API 요청 보안 문서를 참조하세요.

시작하기

시작하기 전에 다음 요구 사항과 정보를 검토하는 것이 좋습니다.

앱 권한

  • business_management
  • ads_management

ID

  • PARENT_BM_ID: 앱을 소유하는 파트너의 비즈니스 관리자 ID입니다.
  • CHILD_BM_ID: 상위 비즈니스 관리자가 클라이언트를 대신해 생성하는 비즈니스 관리자 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을 사용하여 하위 비즈니스 관리자를 만드세요.

— 하위 비즈니스 관리자 ID를 반환합니다.

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단계. 크레딧 라인을 개설합니다. 크레딧 라인(LOC)이 없는 경우 Facebook 담당자에게 연락하여 비즈니스 관리자 내에서 크레딧 라인을 개설하세요. 크레딧 라인은 상위 비즈니스 관리자에서 결제 수단으로 표시됩니다.

2단계. 크레딧 라인 법적 약관을 수락합니다.

  1. 비즈니스 관리자 > 비즈니스 설정 > 결제 수단을 엽니다.
  2. 크레딧 설정을 클릭하고 법적 약관을 클릭합니다. 법적 약관을 수락합니다.

3단계. 크레딧 라인 ID를 가져오고 하위 비즈니스 관리자에 공유합니다.

  1. 상위 비즈니스 관리자의 비즈니스 설정 > 결제 수단으로 이동하여 결제 수단을 클릭합니다. URL에서 PARENT_BM_Line_Of_Credit_ID를 저장합니다. URL은 다음과 같이 표시됩니다.
    https://business.facebook.com/settings/payment-methods/<PARENT_BM_Line_Of_Credit_ID>?business_id=<BUSINESS_ID>
  2. 아래와 같은 API 호출에서 상위 비즈니스 관리자 크레딧 라인 ID를 사용하여 상위 비즈니스 관리자에서 하위 비즈니스 관리자로 크레딧 라인 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

시스템 사용자의 ID 가져오기

액세스 토큰을 가져오고 나면 앱 범위 사용자 ID를 알아내는 데 사용할 수 있습니다. 나중에 사용할 수 있도록 이 ID를 보관하는 것이 중요합니다.

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

결제 수단 ID(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
    또는 하위 비즈니스 관리자로 이동하여 결제를 선택하고 크레딧 라인 결제 수단을 클릭하면 결제 수단을 가져올 수 있습니다. 그러면 URL에 다음과 같이 결제 매개변수가 입력됩니다.
    payment-methods/<CHILD_PAYMENT_METHOD_ID>?business_id=
  3. 나중에 사용할 수 있도록 이 결제 수단 ID를 저장합니다.

기본 결제 수단으로 새 광고 계정 만들기

하위 비즈니스 관리자에서 결제 수단 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

축하합니다! 클라이언트의 캠페인을 만들고 관리하기 위해 하위 비즈니스 관리자를 설정하기 위한 마지막 단계에 왔습니다.

하위 비즈니스 관리자 찾기

모든 하위 비즈니스 관리자 ID를 찾으려면 다음 명령을 실행하여 클라이언트의 앱 범위 사용자 ID로 필터링합니다.

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(클라이언트 사용자 액세스 토큰)로 앱 범위 사용자 ID를 찾습니다.

다음 단계

다음 주제에는 비즈니스 관리자 경험을 증강하는 데 사용할 수 있는 추가적인 기능/작업이 포함됩니다.

또한 클라이언트 자산을 하위 비즈니스 관리자에 액세스하도록 하기 위한 자산 공유 가이드를 참조하세요.