Business Management APIs

Tài khoản quảng cáo

Với vai trò quản trị viên doanh nghiệp, bạn có thể xác nhận quyền sở hữu các tài khoản quảng cáo thuộc một doanh nghiệp. Nhờ vậy, bạn có thể dễ dàng chỉ định những người sẽ có quyền truy cập vào các tài khoản quảng cáo đó. Bạn cũng có thể chỉ định Nguồn tiền chung cho các tài khoản quảng cáo của mình.

Doanh nghiệp không thể xác nhận quyền sở hữu các nhóm tài khoản quảng cáo. Sau khi được thêm vào Trình quản lý kinh doanh, những người dùng có quyền truy cập vào một số nhóm tài khoản quảng cáo vẫn có quyền truy cập vào các nhóm đó.

Xác nhận quyền sở hữu tài khoản

Nếu quản lý các tài khoản quảng cáo bên ngoài Trình quản lý kinh doanh bằng vai trò Quản trị viên, bạn có thể xác nhận quyền sở hữu những tài khoản đó cho doanh nghiệp của mình. Đây là quy trình một lần. Sau khi xác nhận quyền sở hữu, bạn chỉ có thể quản lý các tài khoản quảng cáo trong Trình quản lý kinh doanh nêu trên.

Không thể xác nhận quyền sở hữu Tài khoản nội dung.

Để xác nhận quyền sở hữu tài khoản quảng cáo cho doanh nghiệp của bạn, hãy cung cấp ID tài khoản quảng cáo ở định dạng act_###. Gửi yêu cầu POST: \Người yêu cầu cần phải là quản trị viên của Doanh nghiệp xác nhận quyền sở hữu tài khoản quảng cáo

curl \
  -F "adaccount_id=act_<AD_ACCOUNT_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_ad_accounts"

Nếu bạn là Quản trị viên của tài khoản quảng cáo, chúng tôi sẽ lập tức phê duyệt yêu cầu xác nhận quyền sở hữu này. Facebook sẽ trả về access_status được đặt là CONFIRMED.

Nếu bạn là người dùng không có quyền thích hợp đối với tài khoản quảng cáo, chúng tôi sẽ gửi yêu cầu quyền sở hữu cho Quản trị viên của tài khoản quảng cáo. Sau khi chúng tôi gửi yêu cầu, phản hồi sẽ chứa access_status được đặt là PENDING.

Để chấp nhận yêu cầu quyền sở hữu, bạn phải là quản trị viên tài khoản quảng cáo, đồng thời phải đăng nhập và chấp nhận yêu cầu trong Trình quản lý quảng cáo.

Yêu cầu quyền truy cập tài khoản

Hầu hết các công ty marketing sẽ không cần phải xác nhận quyền sở hữu tài khoản quảng cáo từ khách hàng của họ. Hãy xem bài viết Chức năng giữa các doanh nghiệp để yêu cầu quyền truy cập vào các tài sản thuộc sở hữu của trình quản lý kinh doanh khác.

Tạo tài khoản quảng cáo

Bạn phải là quản trị viên của doanh nghiệp thì mới có thể tạo tài khoản quảng cáo mới. Bạn không thể sử dụng thông tin đăng nhập dùng chung của quản trị viên doanh nghiệp để tạo tài khoản quảng cáo mới hoặc thực hiện các hành động khác.

Để sử dụng API này, bạn phải thiết lập một doanh nghiệp và trang hợp lệ. Nếu có tài khoản quảng cáo nào chưa hoàn thiện hoặc trang nào bị Facebook hủy đăng, bạn sẽ không thể tạo tài khoản quảng cáo mới.

Bạn chỉ tạo được tối đa 5 tài khoản quảng cáo thông qua API. Nếu muốn tạo nhiều hơn 5 tài khoản quảng cáo, bạn phải thực hiện theo cách thủ công.

Sau đây là các trường có sẵn:

Tên Mô tả

name

loại: string

Tên của tài khoản quảng cáo

timezone_id

loại: int

ID của múi giờ

currency

loại: string

Chữ viết tắt đơn vị tiền tệ được dùng cho tài khoản quảng cáo này

partner

loại: long hoặc string

Đối tác kinh doanh của Facebook (FBP). Phải là Bí danh của Trang Facebook, ID Trang Facebook hoặc ID ứng dụng trên Facebook. Nếu không có, hãy sử dụng NONE hoặc UNFOUND.

end_advertiser

loại: long hoặc string

Thực thể mà quảng cáo sẽ nhắm mục tiêu. Phải là ID doanh nghiệp. Nếu không có, hãy sử dụng NONE hoặc UNFOUND.

media_agency

loại: long hoặc string

Agency; đây có thể là doanh nghiệp của chính bạn. Phải là Bí danh của Trang Facebook, ID Trang Facebook hoặc ID ứng dụng trên Facebook. Nếu không có, hãy sử dụng NONE hoặc UNFOUND.

invoice

loại: boolean

Nếu doanh nghiệp có Hạn mức tín dụng thông thường thuộc sở hữu của Trình quản lý kinh doanh với Facebook, chúng tôi sẽ gắn tài khoản quảng cáo với hạn mức tín dụng đó.

Để tạo tài khoản quảng cáo mới cho doanh nghiệp, hãy chỉ định name, currency, timezone_id, end_advertiser, media_agency và partner. Vui lòng xem các điều kiện sau đây:

  • media_agency và partner phải là Bí danh của Trang Facebook, ID Trang Facebook hoặc ID ứng dụng trên Facebook.
  • end_advertiser phải là ID doanh nghiệp.

Nếu tài khoản quảng cáo của bạn không có nhà quảng cáo, Agency truyền thông hoặc Đối tác, hãy chỉ định NONE. Nếu tài khoản quảng cáo của bạn có nhà quảng cáo, Agency truyền thông hoặc Đối tác nhưng họ không phải là Trang hay ứng dụng trên Facebook, hãy chỉ định UNFOUND.

Cách tạo tài khoản quảng cáo:

curl \
  -F "name=MyAdAccount" \
  -F "currency=USD" \
  -F "timezone_id=1" \
  -F "end_advertiser=<END_ADVERTISER_ID>" \
  -F "media_agency=<MEDIA_AGENCY_ID>" \
  -F "partner=NONE" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/adaccount"

Nếu đã có hạn mức tín dụng mở rộng với Facebook, bạn có thể đặt invoice thành true. Sau đó, chúng tôi sẽ liên kết tài khoản quảng cáo mới với hạn mức tín dụng mở rộng của bạn.

Phản hồi có dạng như sau:

{
  "id": "act_<ADACCOUNT_ID>",
  "account_id": "<ADACCOUNT_ID>",
  "business_id": "<BUSINESS_ID>",
  "end_advertiser_id": "<END_ADVERTISER_ID>",
  "media_agency_id": "<MEDIA_AGENCY_ID>",
  "partner_id": "NONE"
}

Xem tài khoản thuộc sở hữu

Để xem tất cả tài khoản quảng cáo mà doanh nghiệp của bạn có quyền truy cập, hãy thực hiện lệnh gọi GET:

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_ad_accounts"

Lệnh gọi này sẽ trả về tất cả tài khoản quảng cáo thuộc sở hữu của một doanh nghiệp. Một số trường sẽ tùy theo mối quan hệ giữa tài khoản quảng cáo và doanh nghiệp.

  • permitted_tasks là một mảng các nhiệm vụ bạn có thể chỉ định cho tài khoản quảng cáo cụ thể đó.
  • access_type xác định xem doanh nghiệp của bạn đóng vai trò là OWNER hay AGENCY của tài khoản quảng cáo.

Để xem các tài khoản quảng cáo vẫn đang chờ xử lý quyền truy cập, hãy thực hiện lệnh gọi GET sau đây:

curl -G \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pending_owned_ad_accounts"

Gỡ tài khoản

Bạn không thể gỡ tài khoản quảng cáo khỏi doanh nghiệp của mình nếu bạn là OWNER và nếu tài khoản ở trạng thái CONFIRMED. Nếu có yêu cầu quyền truy cập PENDING hoặc có quyền truy cập AGENCY vào tài khoản quảng cáo, bạn có thể thực hiện lệnh gọi DELETE sau đây:

curl \
  -X DELETE \
  -F "adaccount_id=act_<AD_ACCOUNT_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_accounts"

Xem quyền truy cập tài khoản

Để xem các tài khoản quảng cáo mà ai đó có quyền truy cập, hãy thực hiện lệnh gọi GET sau đây:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>/assigned_ad_accounts"

Để xem các quyền mà ai đó có đối với một tài khoản quảng cáo, hãy thực hiện lệnh gọi GET sau đây:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"

Thêm người dùng vào tài khoản

Sau khi liên kết Trình quản lý kinh doanh của mình với tài khoản quảng cáo, bạn có thể chỉ định nhiệm vụ cho những người dùng doanh nghiệp khác. Các nhiệm vụ bạn có thể chỉ định bao gồm:

Tên Hằng số API Mô tả

Chỉ báo cáo

['ANALYZE']

Có thể xem dữ liệu về hiệu quả quảng cáo

Người dùng thông thường

['ADVERTISE', 'ANALYZE']

Có thể xem và chỉnh sửa quảng cáo cũng như tạo quảng cáo bằng nguồn tiền được liên kết với tài khoản quảng cáo. Không thể đặt bất kỳ nội dung nào ở cấp độ tài khoản quảng cáo, chẳng hạn như nguồn tiền.

Quản trị viên

['MANAGE', 'ADVERTISE', 'ANALYZE']

Có thể quản lý tất cả khía cạnh của chiến dịch, báo cáo, lập hóa đơn và quyền đối với tài khoản quảng cáo.

Bạn cần:

  • adaccount_id - ID tài khoản quảng cáo, ở dạng act_123
  • user_id - ID người dùng cần thêm
  • Nhiệm vụ cần chỉ định

Để thêm người dùng mới có nhiệm vụ ['MANAGE', 'ADVERTISE', 'ANALYZE'], hãy thực hiện lệnh gọi POST sau đây:

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['MANAGE', 'ADVERTISE', 'ANALYZE']" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"

Thay đổi quyền đối với tài khoản

Để thay đổi nhiệm vụ của người dùng hiện có, hãy thực hiện lệnh gọi POST giống như khi bạn thêm người dùng mới:

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['ANALYZE']" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"

Xóa người dùng khỏi tài khoản quảng cáo

Để xóa ai đó khỏi tài khoản, bạn cần:

  • adaccount_id - ID tài khoản quảng cáo, ở dạng act_123
  • user_id - ID người dùng cần xóa

Lệnh gọi DELETE như sau:

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