Thiết lập Trình quản lý kinh doanh phụ mới

Ban đầu, giải pháp Trình quản lý kinh doanh 2 cấp được thiết kế để mỗi mã truy cập dành cho người dùng chỉ có thể tạo một Trình quản lý kinh doanh phụ. Tuy nhiên, người dùng hiện có thể tạo nhiều Trình quản lý kinh doanh phụ, miễn là đặt một trang chính trên mỗi Trình quản lý kinh doanh phụ.

Bắt đầu

Trước khi bắt đầu, bạn nên xem lại các yêu cầu và thông tin sau đây:

Quyền của ứng dụng

• business_management
• ads_management

ID

• PARENT_BM_ID: ID Trình quản lý kinh doanh của đối tác sở hữu ứng dụng.
• CHILD_BM_ID: ID Trình quản lý kinh doanh mà Trình quản lý kinh doanh chính tạo cho khách hàng.

Mã truy cập

• USER_Personal_Access_Token: Mã truy cập của người dùng cung cấp thông tin đăng nhập để tạo Trình quản lý kinh doanh phụ.

  • Mã này được tạo thông qua phương thức Đăng nhập bằng Facebook.
  • Đối tác nên yêu cầu toàn bộ phạm vi quyền business_management đối với doanh nghiệp và Trang của người dùng, thay vì phạm vi quyền chi tiết.
  • Người dùng này cần có đặc quyền của Quản trị viên trên Trang được chia sẻ vào Trình quản lý kinh doanh phụ.
  • Nếu Trang này thuộc sở hữu của Trình quản lý kinh doanh khác, người dùng nêu trên cần có đặc quyền của Quản trị viên trên Trình quản lý kinh doanh sở hữu Trang đó.
  • Mã này được dùng để cho phép tạo Trình quản lý kinh doanh phụ và để chia sẻ Trang vào Trình quản lý kinh doanh phụ cho mục đích quảng cáo.
• PARENT_BM_ADMIN_SYSTEM_USER_ACCESS_TOKEN: Mã truy cập của Người dùng hệ thống là quản trị viên trong Trình quản lý kinh doanh chính.

  • Mã này được dùng để tạo và quản lý Trình quản lý kinh doanh phụ.
• CHILD_BM_SYSTEM_USER_ACCESS_TOKEN: Mã truy cập của Người dùng hệ thống là quản trị viên, được tạo trong Trình quản lý kinh doanh phụ.

  • Mã này được dùng để tạo và quản lý Chiến dịch cũng như hoạt động khác trong Trình quản lý kinh doanh phụ.

Tạo Trình quản lý kinh doanh phụ

Dùng USER_Personal_Access_Token để tạo Trình quản lý kinh doanh phụ.

Ví dụ - Trả về một ID Trình quản lý kinh doanh phụ

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

Phản hồi:

{
    “ID” : “12312812123132”  //store this child business manager ID and associate to user
}

Tạo nhiều Trình quản lý kinh doanh phụ cho mỗi người dùng

Nếu muốn tạo nhiều Trình quản lý kinh doanh phụ dùng chung thông tin đăng nhập của người dùng, người dùng phải đặt primary_page trên Trình quản lý kinh doanh phụ hiện có được tạo cho người dùng đó. Hãy thực hiện một lệnh gọi POST khác để đặt primary_page của Trình quản lý kinh doanh phụ hiện có:

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>

Khi tạo một Trình quản lý kinh doanh phụ khác:

• Mọi Trình quản lý kinh doanh phụ hiện có đều cần có primary_page riêng biệt.
• Bạn phải đặt shared_page_id trên Trình quản lý kinh doanh phụ mới.
• Nếu bạn dùng shared_page_id để tạo Trình quản lý kinh doanh phụ mới, ID này không được là primary_page trên bất kỳ Trình quản lý kinh doanh phụ nào hiện có.

Thiết lập phương thức thanh toán

Để thanh toán cho quảng cáo của Trình quản lý kinh doanh phụ, bạn sẽ cần chia sẻ hạn mức tín dụng của mình với mỗi Trình quản lý kinh doanh phụ.

Bước 1. Mở hạn mức tín dụng. Liên hệ với người đại diện của Facebook và mở hạn mức tín dụng trong Trình quản lý kinh doanh đó nếu chưa có. Hạn mức tín dụng sẽ hiển thị dưới dạng một phương thức thanh toán trong Trình quản lý kinh doanh chính của bạn.

Bước 2. Chấp nhận điều khoản pháp lý về hạn mức tín dụng.

1. Mở Trình quản lý kinh doanh > Cài đặt cho doanh nghiệp > Phương thức thanh toán.
2. Nhấp vào Cài đặt tín dụng rồi nhấp vào Điều khoản pháp lý. Chấp nhận điều khoản pháp lý.

Bước 3. Tìm nạp ID hạn mức tín dụng và chia sẻ với Trình quản lý kinh doanh phụ

1. Chuyển đến Trình quản lý kinh doanh chính của bạn rồi mở mục Cài đặt cho doanh nghiệp > Phương thức thanh toán, nhấp vào Phương thức thanh toán. Lưu trữ PARENT_BM_Line_Of_Credit_ID từ URL. URL sẽ có dạng như sau:

   https://business.facebook.com/settings/payment-methods/<PARENT_BM_Line_Of_Credit_ID>?business_id=<BUSINESS_ID>

2. Sử dụng ID hạn mức tín dụng của Trình quản lý kinh doanh chính này trong lệnh gọi API bên dưới để chia sẻ ID hạn mức tín dụng từ Trình quản lý kinh doanh chính với Trình quản lý kinh doanh phụ. amount là thông số không bắt buộc.

   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

Lấy mã người dùng hệ thống phụ

Trong Trình quản lý kinh doanh phụ, hãy sử dụng lệnh gọi API dưới đây để tạo người dùng hệ thống và tìm nạp mã truy cập. Mã này được dùng cho mọi lệnh gọi tiếp theo đến Trình quản lý kinh doanh phụ để tạo hoặc quản lý quảng cáo cho người dùng nêu trên.

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

Tìm nạp ID người dùng hệ thống

Sau khi lấy mã truy cập, bạn có thể dùng mã này để tìm ra ID người dùng trong ứng dụng. Bạn cần lưu trữ mã đó để dùng sau này.

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

Lấy ID nguồn tiền (LOC)

1. Tìm nạp nguồn tiền mới trong Trình quản lý kinh doanh phụ. Trong ví dụ dưới đây, hãy sử dụng nguồn tiền này vào lúc khác khi tạo tài khoản quảng cáo.

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

Ngoài ra, bạn có thể tìm nạp nguồn tiền bằng cách chuyển đến Trình quản lý kinh doanh phụ và chọn Thanh toán > nhấp vào phương thức Thanh toán bằng hạn mức tín dụng. Thao tác này sẽ điền thông số thanh toán vào URL như sau:

payment-methods/<CHILD_PAYMENT_METHOD_ID>?business_id=

2. Lưu trữ ID phương thức thanh toán này để dùng sau.

Tạo tài khoản quảng cáo mới có nguồn tiền mặc định

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

Thêm người dùng hệ thống làm quản trị viên cho tài khoản quảng cáo mới

Thêm người dùng hệ thống làm quản trị viên cho tài khoản quảng cáo mới trong Trình quản lý kinh doanh phụ:

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

Xin chúc mừng! Đây là bước cuối cùng trong quá trình thiết lập Trình quản lý kinh doanh phụ để tạo và quản lý chiến dịch của khách hàng.

Tìm Trình quản lý kinh doanh phụ

Để tìm tất cả ID Trình quản lý kinh doanh phụ, hãy chạy lệnh sau đây để lọc theo ID người dùng trong ứng dụng của khách hàng:

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>

Bước tiếp theo

Chủ đề tiếp theo là về các tính năng/hành động bổ sung mà bạn có thể dùng để nâng cao trải nghiệm Trình quản lý kinh doanh của mình.

Ngoài ra, hãy tham khảo các hướng dẫn chia sẻ tài sản để truy cập vào tài sản của khách hàng trong Trình quản lý kinh doanh phụ:

• Chức năng giữa các doanh nghiệp
• Chia sẻ pixel của doanh nghiệp