Bắt đầu

Để sử dụng Trình quản lý kinh doanh, doanh nghiệp cần có ít nhất một trang, một quản trị viên, một tên doanh nghiệp và một địa chỉ email hợp lệ.

Tên doanh nghiệp chỉ được dùng cho doanh nghiệp của bạn và bất kỳ doanh nghiệp nào khác mà bạn chọn chia sẻ đối tượng. Sau khi tạo doanh nghiệp này, bạn có thể thêm trang, tài khoản quảng cáo, ứng dụng, đối tượng theo dõi lượt chuyển đổi ngoài trang web và các tài sản khác liên quan đến quảng cáo thuộc về một doanh nghiệp.

Yêu cầu

• Ứng dụng của bạn cần có Cấp độ truy cập API Marketing thích hợp để sử dụng API Trình quản lý kinh doanh. Lưu ý rằng trong một số trường hợp, ứng dụng đó có thể yêu cầu Quyền truy cập nâng cao. Tìm hiểu thêm về các cấp độ truy cập khác nhau.
• Ứng dụng của bạn cũng cần có quyền business_management.

Tạo trình quản lý kinh doanh mới

Tạo trình quản lý kinh doanh mới để đại diện cho doanh nghiệp bạn. Chỉ tạo trình quản lý kinh doanh mới nếu bạn đang thiết lập trình quản lý kinh doanh mới cho chính mình hoặc cho khách hàng. Nếu cần tài khoản quảng cáo khác hoặc cần quyền truy cập vào trang khác, bạn nên sử dụng quyền truy cập tài sản và trình quản lý hiện có. Không cho phép xóa trình quản lý kinh doanh.

Ví dụ: tạo Trình quản lý kinh doanh mới thông qua POST:

curl \
  -F "name=Pomni Media" \
  -F "vertical=ADVERTISING" \
  -F "primary_page=<PAGE_ID>" \
  -F "timezone_id=1" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<USER_ID>/businesses"

Yêu cầu

Để tạo một doanh nghiệp, bạn cần:

• Mã truy cập
• ID Trang
• Ngành dọc
• ID người dùng trong ứng dụng

ID Trang mà bạn cung cấp sẽ là trang chính của doanh nghiệp bạn. Trang này đại diện công khai cho doanh nghiệp bạn trên Facebook. Bất cứ ai tạo doanh nghiệp đều là người quản lý của trang này. Nếu bạn chưa có trang đại diện cho doanh nghiệp mình trên Facebook, hãy tạo một trang.

Ngành dọc là một trong các hằng số chuỗi sau:

ADVERTISING , AUTOMOTIVE , CONSUMER_PACKAGED_GOODS , ECOMMERCE , EDUCATION , ENERGY_AND_UTILITIES , ENTERTAINMENT_AND_MEDIA , FINANCIAL_SERVICES , GAMING , GOVERNMENT_AND_POLITICS ,MARKETING , ORGANIZATIONS_AND_ASSOCIATIONS , PROFESSIONAL_SERVICES , RETAIL , TECHNOLOGY , TELECOM , TRAVEL , OTHER

Để xem các tài sản của một doanh nghiệp, hãy sử dụng ID tương ứng:

curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>?access_token=<ACCESS_TOKEN>"

Bạn cũng có thể xem danh sách các trình quản lý kinh doanh mà mình có thể truy cập:

curl "https://graph.facebook.com/<API_VERSION>/me/businesses?access_token=<ACCESS_TOKEN>"

Trường phản hồi bao gồm:

Cập nhật trình quản lý kinh doanh

Cập nhật các trường trong trình quản lý kinh doanh này bằng cách gửi yêu cầu POST đến https://graph.facebook.com/{API_VERSION}/{BUSINESS_ID}. Ví dụ: thay đổi tên doanh nghiệp:

curl \
-F "name=My Actual Business Name" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/"

Thay đổi ngành dọc của doanh nghiệp bằng cách gửi yêu cầu POST sau:

curl \
-F "vertical=RETAIL" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/"

Bạn có những tùy chọn sau đây:

Bạn có thể cập nhật trang chính bằng cách gửi yêu cầu POST sau đây. Trang chính phải do trình quản lý kinh doanh sở hữu.

curl \
  -F "primary_page=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/"

Bạn cũng có thể cập nhật mọi trường ở trên trong một yêu cầu POST:

curl \
  -F "name=My Actual Business Name" \
  -F "vertical=RETAIL" \
  -F "primary_page=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/"

Quản lý mọi người và vai trò

Có 2 loại vai trò trong Trình quản lý kinh doanh:

Để biết thêm thông tin về vai trò, hãy xem bài viết Thiết lập các vai trò trên danh mục trong Trình quản lý kinh doanh.

Ban đầu, người tạo Doanh nghiệp là người dùng duy nhất trên Doanh nghiệp và là Quản trị viên.

Mời mọi người

Để thêm đồng nghiệp vào doanh nghiệp mình, bạn phải mời họ. Để mời ai đó, hãy cung cấp địa chỉ email hợp lệ mà họ có quyền truy cập. Việc gửi yêu cầu thêm nhân viên vào trình quản lý kinh doanh bị giới hạn. Khi đạt đến giới hạn này, bạn sẽ nhận được mã lỗi 17. Bạn nên tiếp tục sau 24 giờ.

Để mời ai đó làm quản trị viên, hãy gửi yêu cầu POST:

curl \
-F "email=some@email.com" \
-F "role=ADMIN" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_users"

Để mời ai đó làm nhân viên, hãy gửi yêu cầu POST:

curl \
-F "email=some@email.com" \
-F "role=EMPLOYEE" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_users"

Facebook gửi email mời đến địa chỉ email công việc mà bạn đã chỉ định. Người được mời phải kiểm tra email và tuân theo quy trình đăng ký. Sau khi họ hoàn tất, bạn có thể nhìn thấy họ trong danh sách Người dùng.

Mọi người trên Trình quản lý kinh doanh

Kể từ v2.11, chúng tôi có điểm cuối riêng để lấy người dùng dựa trên trạng thái của họ. Hãy gửi yêu cầu GET để truy xuất từng nhóm người dùng. Cách lấy tất cả người dùng doanh nghiệp như sau (Lưu ý rằng Quyền truy cập nâng cao là bắt buộc.):

curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_users?access_token=<ACCESS_TOKEN>"

Cách lấy người dùng hệ thống, có quyền truy cập ở cấp độ hệ thống:

curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users?access_token=<ACCESS_TOKEN>"

Cách lấy người dùng đang chờ được mời truy cập vào một doanh nghiệp, nhưng chưa chấp nhận:

curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pending_users?access_token=<ACCESS_TOKEN>"

Các điểm cuối này trả về người dùng đang hoạt động, đang chờ hoặc người dùng hệ thống cho Doanh nghiệp của bạn. Ví dụ:

{
  "data": [
    {
      "id": "<BUSINESS_ID>",
      "name": "Alpha MK",
      "email": "some@email.com",
      "role": "EMPLOYEE",
    }
  ]
}

Kết quả cho người dùng đang chờ có dạng như sau:

{
  "data": [
    {
      "id": "<BUSINESS_ID>",
      "email": "some@email.com",
      "role": "EMPLOYEE",
      "status": "PENDING",
      "owner": {
        "id": "USER_ID",
        "name": "Generic Emporium"
      }
    }
  ]
}

Định nghĩa cho các trường được trả về như sau:

Thay đổi vai trò

Để thay đổi vai trò của người dùng đang hoạt động trong Doanh nghiệp bạn, hãy cung cấp ID người dùng cho người dùng đó. Ví dụ: bạn có thể nâng cấp vai trò Nhân viên lên Quản trị viên thông qua yêu cầu POST sau:

curl \
  -F "role=ADMIN" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>"

Để thay đổi vai trò của ai đó từ Quản trị viên thành Nhân viên, hãy gửi yêu cầu POST:

curl \
  -F "role=EMPLOYEE" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>"

Bạn có thể thay đổi vai trò cho người dùng đang chờ thông qua yêu cầu POST sau:

curl \
  -F "role=EMPLOYEE" \
    -F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<PENDING_USER_ID>"

Xóa người dùng

Gỡ các quyền được cấp cho ai đó dựa trên tư cách thành viên trong trình quản lý kinh doanh của bạn. Giới hạn quyền truy cập vào tài khoản quảng cáo và trang. Nếu người dùng có quyền truy cập vào tài khoản quảng cáo hoặc trang bên ngoài Trình quản lý kinh doanh thì các quyền đó sẽ không thay đổi. Ví dụ: có thể ai đó đã thêm chính mình hoặc có quyền truy cập thông qua trình quản lý kinh doanh khác

Để xóa người dùng đang hoạt động khỏi doanh nghiệp của bạn, hãy thực hiện lệnh gọi DELETE sau:

curl \
  -X DELETE \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>"

Cách hủy người dùng đang chờ bằng yêu cầu DELETE:

curl \
  -X DELETE \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<PENDING_USER_ID>"

Thao tác này sẽ xóa người dùng khỏi Doanh nghiệp của bạn và gỡ quyền truy cập vào các tài sản của Doanh nghiệp đó.

Lấy đối tượng kết nối

Đối tượng kết nối là các đối tượng Facebook (ví dụ: trang, ứng dụng, v.v.) mà quản trị viên quản lý. Quản trị viên có thể là người dùng hoặc doanh nghiệp hay nhà phát triển hoặc nhà quảng cáo trong trường hợp là ứng dụng. Các loại đối tượng kết nối bao gồm:

• Trang và địa điểm
• Sự kiện
• Ứng dụng
• Miền

Hãy xem truy vấn mẫu và tìm hiểu thêm ở bài viết Đối tượng kết nối.

Hóa đơn

Với API Trình quản lý kinh doanh, bạn có thể xem và quản lý nguồn tín dụng liên kết với một doanh nghiệp. API này sẽ thử lại mọi hóa đơn hiển thị với một Trình quản lý kinh doanh. Nghĩa là mọi hóa đơn mà Trình quản lý kinh doanh này chịu trách nhiệm pháp lý đều hiển thị qua API, chứ không chỉ các hóa đơn thuộc về một ID doanh nghiệp riêng.

Hạn mức tín dụng thông thường của trình quản lý kinh doanh

Đối với những đối tác API Marketing đã bật tính năng lập hóa đơn, bạn có thể tận dụng Hạn mức tín dụng thông thường của trình quản lý kinh doanh.

Đối tác marketing Facebook (FBMP) cần liên hệ với đại diện bán hàng của họ để lấy cách thiết lập trình quản lý kinh doanh cho tín dụng. Hãy nhớ yêu cầu Hạn mức tín dụng thông thường của trình quản lý kinh doanh. Sau khi thiết lập xong, bạn có thể bắt đầu sử dụng API tạo tài khoản quảng cáo để bắt đầu tạo tài khoản quảng cáo. Phí sẽ dựa trên hạn mức tín dụng của trình quản lý kinh doanh.

Đối với tài khoản quảng cáo được tạo qua API sau đây, chúng tôi sẽ phân phối tín dụng một cách linh động giữa các tài khoản, cũng như cập nhật hạn mức tín dụng và chi tiêu để tránh đạt đến hạn mức tín dụng. Bạn cũng có thể xem tín dụng có sẵn ở dạng tóm tắt và lượng tín dụng trên mỗi tài khoản quảng cáo.

Hiện nay, chúng tôi chỉ hỗ trợ trách nhiệm pháp lý thông thường mà không hỗ trợ trách nhiệm pháp lý tuần tự. Quy trình thiết lập trách nhiệm pháp lý này sẽ vẫn không thay đổi.

Lập hóa đơn cuối tháng

Sau khi bạn thiết lập hạn mức tín dụng cho một doanh nghiệp và doanh nghiệp này dùng hạn mức đó để chạy quảng cáo, chúng tôi sẽ tạo hóa đơn cuối tháng cho tài khoản kinh doanh đó. Để xem hóa đơn doanh nghiệp, bạn cần có vai trò tài chính. Đối với quản trị viên và nhân viên thông thường của một doanh nghiệp, bạn có thể chỉ định quyền trong phần People của Trình quản lý kinh doanh. Bạn cũng có thể chỉ định quyền tài chính cho người dùng hệ thống bằng Trình quản lý kinh doanh.

Để truy xuất hóa đơn trong tài khoản kinh doanh bằng API, hãy gửi yêu cầu GET:

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_invoices?start_date=2017-01-01&end_date=2017-04-01"

Kết quả mẫu có dạng như sau:

{
  "business_invoices": {
    "data": [
      {
        "id": "1659175694099710",
        "billing_period": "2017-03-01"
      },
      {
        "id": "1303851778395619",
        "billing_period": "2017-01-01"
      },
      {
        "id": "1415846861611329",
        "billing_period": "2017-02-01"
      }
    ],
    "paging": {
      "cursors": {
        "before": "MAZDZD",
        "after": "MgZDZD"
      }
    }
  },
  "id": "249554531892085"
}

Bạn có thể lấy chi tiết hóa đơn ở cấp độ chiến dịch bằng yêu cầu sau:

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_invoices?fields=billed_amount_details,billing_period,entity,id,invoice_id,payment_term,type,campaigns&start_date=2019-06-01&end_date=2019-07-01"

Phản hồi tương tự như sau:

{
  "business_invoices": {
    "data": [
      {
        "billed_amount_details": {
          "currency": "USD",
          "net_amount": "387.70",
          "tax_amount": "0.00",
          "total_amount": "387.70"
        },
        "billing_period": "2017-03-01",
        "entity": "FBUS",
        "id": "1659175694099710",
        "invoice_id": "22736800",
        "liability_type": "Normal",
        "invoice_type": "Invoice",
        "payment_term": "CUSTOMER",
        "type": "Invoice",
        "campaigns": {
          "data": [
            {
              "campaign_id": "6056967798500",
              "campaign_name": "Nhận ưu đãi",
              "tags": [
                "hello2"
              ],
              "billed_amount_details": {
                "currency": "USD",
                "net_amount": "207.62",
                "tax_amount": "0.00",
                "total_amount": "207.62"
              }
            },
            {
              "campaign_id": "6056958052500",
              "campaign_name": "Nhận ưu đãi",
              "billed_amount_details": {
                "currency": "USD",
                "net_amount": "180.08",
                "tax_amount": "0.00",
                "total_amount": "180.08"
              }
              "impressions": 100,
              "clicks": 50,
              "conversions": 30
            }
          ]
        }
      },
      {
        "billed_amount_details": {
          "currency": "USD",
          "net_amount": "382.99",
          "tax_amount": "0.00",
          "total_amount": "382.99"
        },
        ......
    "paging": {
      "cursors": {
        "before": "MAZDZD",
        "after": "MgZDZD"
      }
    }
  },
  "id": "1515766328651000"
}

Bạn cũng có thể truy xuất các trường lập hóa đơn khác:

• invoice_date - Ngày mà Facebook tạo hóa đơn
• due_date - Ngày đến hạn hóa đơn
• payment_status - Cho biết liệu hóa đơn là Paid, Unpaid hay Partially Paid
• amount_due - Số tiền hiện đến hạn và chưa thanh toán trên hóa đơn
• download_uri - Tải xuống file PDF hóa đơn tại URI này

API Nguồn vốn

Để truy xuất nguồn vốn tín dụng mở rộng được liên kết với trình quản lý kinh doanh, hãy gửi yêu cầu GET sau.

curl "https://www.graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/extendedcredits"

Để thiết lập nguồn vốn cho một doanh nghiệp, hãy chuyển đến phần cài đặt của doanh nghiệp bạn trên Trình quản lý kinh doanh.

Phân bổ tín dụng động

Phân bổ tín dụng động (còn gọi là DCAF) là hệ thống phân bổ tín dụng của chúng tôi để định kỳ điều chỉnh khoản tín dụng có sẵn trên mỗi tài khoản quảng cáo. Tập lệnh tự động của chúng tôi chạy khoảng 30 phút một lần và nhận khoản tín dụng có sẵn của bạn rồi phân bổ đều khoản tín dụng đó trên mọi tài khoản đang hoạt động mà bạn bật cho DCAF. Khoản tín dụng có sẵn bao gồm tổng số khoản tín dụng đã phê duyệt trừ đi tổng dư nợ. Việc này tạo điều kiện quản lý chi tiêu ở cấp độ tài khoản quảng cáo của bạn và phân bổ vốn cho từng tài khoản quảng cáo.

Doanh nghiệp cũng có thể "vô hiệu hóa" một tài khoản quảng cáo đã lập hóa đơn và gỡ tài khoản quảng cáo đó khỏi danh sách cần chỉ định tín dụng. Doanh nghiệp không cần phải yêu cầu Facebook quản lý trạng thái này nữa.