Tích hợp nội dung FBE

Tiện ích Facebook Business (FBE) cho phép người dùng dễ dàng tải các tài sản nội dung lên nhóm ứng dụng của Meta bằng cách kết nối với Trình quản lý kinh doanh mới hoặc hiện có. Đối tác có thể sử dụng Trình quản lý kinh doanh được trả về sau khi hoàn tất quy trình này để tải các tài sản nội dung lên Facebook thay mặt cho khách hàng của mình:

Tài liệu này nêu rõ các điều kiện tiên quyết chính đối với quy trình FBE dành cho Nội dung cùng với các bước cần thiết để hoàn tất quy trình. Vui lòng tham khảo hướng dẫn về Tiện ích Facebook Business để biết thông tin cụ thể về tất cả các tiện ích tích hợp.

Ví dụ - Quy trình tích hợp từ nền tảng đối tác (Đăng nhập cho doanh nghiệp)

Trước khi bạn bắt đầu

Đăng ký làm nhà phát triển trên Facebook để truy cập vào các công cụ dành cho nhà phát triển của chúng tôi và tạo ứng dụng trên Facebook.
Tạo một ứng dụng trên Meta nếu bạn chưa có.
Ứng dụng trên Meta của bạn phải thuộc sở hữu của Trình quản lý kinh doanh là một doanh nghiệp đã được xác minh. Tìm hiểu thêm về cách xác minh doanh nghiệp của bạn.
Tạo một ứng dụng thử nghiệm rồi dùng ứng dụng đó để thực hiện tất cả hoạt động phát triển và thử nghiệm mới. Hãy nhớ chỉ định một Trình quản lý kinh doanh khác cho ứng dụng thử nghiệm của bạn.
Quyền/tính năng riêng tư:

manage_business_extension - Quyền truy cập Tiện ích Facebook Business. Sau khi tính năng này được phát hành cho ứng dụng của bạn, bạn có thể tìm thấy Bảng điều khiển dành cho nhà phát triển FBE trong phần Sản phẩm.
Business_creative_asset_management - Quyền truy cập API quản lý tài sản liên quan đến nội dung. Sau khi được cấp tính năng này, bạn có thể có quyền sử dụng các quyền sau:
- business_creative_insights: Truy cập thông tin chi tiết về tài sản nội dung của doanh nghiệp.
- business_creative_management: Cho phép ứng dụng tạo, chỉnh sửa và chia sẻ các thư mục mới, cũng như tải các tài sản lên những thư mục này trong thực thể kinh doanh của chính bạn.
- business_creative_insights_share (trong giai đoạn phát triển): Một quyền tùy chọn được sử dụng trong quy trình chia sẻ thư mục. Nếu người dùng cấp quyền này, ứng dụng sẽ có thể chia sẻ thư mục nội dung với các doanh nghiệp khác và cho phép những doanh nghiệp đó xem thông tin chi tiết về tài sản nội dung.

Sau khi hoàn tất quy trình Xét duyệt ứng dụng

Tạo mã truy cập dành cho đối tác:

Tạo mã truy cập dành cho người dùng hệ thống quản trị trong trình quản lý kinh doanh của bạn bằng cách làm theo các hướng dẫn này.
Đảm bảo rằng mã truy cập này có quyền business_creative_insights, business_creative_management và business_management đã chọn trong bước "phạm vi có sẵn".

Triển khai nút "Gửi thiết kế của tôi lên Facebook"

Nút này được dùng để gửi tài sản lên Thư viện file phương tiện trên Facebook của người dùng từ ứng dụng của bạn. Trong quy trình này, ứng dụng của bạn cần cho phép người dùng chọn hoặc tạo thư mục để gửi tài sản đến thư mục đó.

Chúng tôi đề xuất 2 phương pháp để thực hiện bước này:

1. (Tối thiểu) Người dùng chỉ có thể chọn hoặc tạo một thư mục cấp cao nhất. Trong doanh nghiệp đã chọn, hãy truy vấn tất cả các thư mục cấp cao nhất mà người dùng có quyền truy cập. Yêu cầu người dùng chọn một thư mục cấp cao nhất hiện có hoặc tạo thư mục mới. Người dùng có thể chỉ định tên thư mục hoặc sử dụng tên thư mục mặc định <YourBusinessName>_<UserBusinessName>_<UserName>. Tải các tài sản lên thư mục cấp cao nhất mới hoặc đã chọn. Phương pháp này yêu cầu giao diện người dùng tối thiểu và thông tin chi tiết về API có trong Bước 3 dưới đây.

2. (Không bắt buộc) Người dùng có toàn quyền kiểm soát thư mục và thư mục con. Trong doanh nghiệp đã chọn, hãy truy vấn tất cả các thư mục cấp cao nhất mà người dùng có quyền truy cập và yêu cầu người dùng chọn một thư mục cấp cao nhất hiện có hoặc tạo thư mục mới. Đối với thư mục mới, hãy yêu cầu người dùng đặt tên cho thư mục hoặc sử dụng tên mặc định <YourBusinessName>_<UserBusinessName>_<UserName>. Trong thư mục cấp cao nhất đã chọn, người dùng có thể điều hướng đến thư mục con hiện có, tạo thư mục con mới hoặc tải các tài sản lên. Với tùy chọn này, bạn sẽ cần triển khai điều hướng thư mục trong giao diện người dùng. Bạn có thể xem hướng dẫn tích hợp API trong Bước 3 và Bước 4 bên dưới.

Dưới đây là các bước cụ thể cần thực hiện để triển khai quy trình này:

Triển khai Tiện ích Facebook Business
Lấy ngữ cảnh doanh nghiệp
Chọn hoặc tạo thư mục cấp cao nhất
Chọn hoặc tạo thư mục con
Tải hình ảnh/video lên
Yêu cầu chia sẻ thư mục với bạn (không bắt buộc)
Xem thông tin chi tiết về hình ảnh/video (không bắt buộc)

1. Triển khai Tiện ích Facebook Business

Khi người dùng gửi tài sản nội dung lên Facebook lần đầu, bạn cần nhắc Tiện ích Facebook Business yêu cầu người dùng xác thực và cấp cho ứng dụng của bạn các quyền cần thiết và quyền truy cập vào tài sản (ở dạng mã truy cập) để truy cập vào dữ liệu của người dùng đó trên Facebook. Hãy xem phần Tiện ích Facebook Business: Bắt đầu để triển khai Tiện ích Facebook Business trong ứng dụng của bạn. Làm theo hướng dẫn về Ứng dụng kinh doanh để cho phép ứng dụng của bạn hiển thị trên Ứng dụng kinh doanh.

Cách gợi ý quy trình dành cho Nội dung:

Chuyển channel: CREATIVE và business_vertical: CREATIVE vào trong đối tượng setup.
Sử dụng các quyền business_creative_management và business_creative_insights
- Cần có các quyền này để truy vấn ID doanh nghiệp, tạo thư mục và tải các tài sản nội dung lên thư mục
(Không bắt buộc) Sử dụng quyền business_creative_insights_share
- Cho phép người dùng chia sẻ với bạn thư mục kèm theo quyền thực hiện tác vụ VIEW_INSIGHTS

Bạn có thể dùng mã truy cập dành cho người dùng được trả về từ gợi ý này để thực hiện các lệnh gọi API thay mặt cho người dùng.

Cấu hình bắt buộc

Bổ sung

Trường Loại Mô tả

Trường	Loại	Mô tả
`setup`	thiết lập	Bắt buộc Đối tượng thiết lập Facebook của người bán, chẳng hạn như thông tin nhận dạng duy nhất (`external_business_id`) hoặc đơn vị tiền tệ cho danh mục (`currency`) của họ. Hãy xem phần chi tiết đối tượng thiết lập.
`business_config`	business_config	Bắt buộc Đối tượng cấu hình mà Tiện ích Facebook Business sử dụng để đặt cấu hình quy trình Tiện ích Facebook Business. Hãy xem phần chi tiết đối tượng `business_config`.
`repeat`	boolean	Bắt buộc Đặt giá trị này thành `false`.

setup

thiết lập

Bắt buộc

Đối tượng thiết lập Facebook của người bán, chẳng hạn như thông tin nhận dạng duy nhất (external_business_id) hoặc đơn vị tiền tệ cho danh mục (currency) của họ. Hãy xem phần chi tiết đối tượng thiết lập.

business_config

business_config

Bắt buộc

Đối tượng cấu hình mà Tiện ích Facebook Business sử dụng để đặt cấu hình quy trình Tiện ích Facebook Business. Hãy xem phần chi tiết đối tượng business_config.

repeat

boolean

Bắt buộc

Đặt giá trị này thành false.

Thiết lập

Sử dụng đối tượng này để xác định chế độ cài đặt cho sự hiện diện của người dùng cuối trên Facebook

Trường	Mô tả
`external_business_id` Loại: chuỗi	Bắt buộc. ID doanh nghiệp duy nhất để đại diện cho doanh nghiệp của khách hàng. Chúng tôi sử dụng ID này làm thông tin nhận dạng duy nhất. Ví dụ: nếu công ty của người bán có tên là "Fubar" thì "fubar-123" có thể là `external_business_id` của họ.
`timezone` Loại: chuỗi	Bắt buộc. Múi giờ hoạt động của doanh nghiệp. Hãy xem phần các giá trị múi giờ có thể sử dụng.
`currency` Loại: chuỗi	Bắt buộc. Mã đơn vị tiền tệ theo tiêu chuẩn ISO gồm 3 chữ cái của đơn vị tiền tệ mặc định được dùng cho các mặt hàng trong danh mục của doanh nghiệp. Hãy xem bài viết mã đơn vị tiền tệ được hỗ trợ.
`business_vertical` Loại: enum	Bắt buộc. Ngành dọc được liên kết với doanh nghiệp Giá trị:`CREATIVE`
`channel` Loại: enum	Bắt buộc. Cung cấp phương thức để đối tác bày tỏ ý định với người dùng về những tính năng cần có các bước hoặc ràng buộc bổ sung. Giá trị: `CREATIVE`. `CREATIVE` - Quy trình cho phép người dùng tạo nội dung trên nền tảng đối tác và chia sẻ nội dung đó với Trình quản lý kinh doanh của người dùng.
`business_manager_id` Loại: chuỗi	Không bắt buộc. ID Trình quản lý kinh doanh cho Trình quản lý kinh doanh hiện tại của người dùng mà đối tác có thể nhập để chọn trước cho người dùng trong quy trình thiết lập.

Cấu hình doanh nghiệp

Sử dụng đối tượng này để đặt cấu hình cài đặt cho doanh nghiệp của người dùng cuối. Đối tượng này bao gồm CTA, thẻ Dịch vụ, v.v. Mỗi trường bao gồm một "loại" được liên kết với bảng tương ứng bên dưới.

Trường	Mô tả
`business` Loại: FBEBusinessPropertiesConfigData	Bắt buộc. Thông tin về doanh nghiệp của người dùng cuối

FBEBusinessPropertiesConfigData

Sử dụng đối tượng này để đặt cấu hình tên doanh nghiệp.

Trường	Mô tả
`name` Loại: chuỗi	Bắt buộc. Tên doanh nghiệp

2. Lấy ngữ cảnh doanh nghiệp

Sau khi người dùng hoàn tất quy trình tích hợp FBE ở trên, bạn sẽ nhận được ID Trình quản lý kinh doanh của người dùng và mã truy cập từ API Cài đặt FBE hoặc thông báo Webhook.

3. Chọn hoặc tạo thư mục cấp cao nhất

Người dùng có thể tải các tài sản lên thư mục cấp cao nhất hoặc tạo thư mục con trong thư mục cấp cao nhất.

Đầu tiên, hãy kiểm tra những thư mục cấp cao nhất mà người dùng có quyền thực hiện tác vụ CREATE_CONTENT bằng cách gửi yêu cầu đến điểm cuối <business_id>/creative_folders (trong giai đoạn phát triển).

Lấy thư mục cấp cao nhất từ doanh nghiệp của người dùng

Yêu cầu

curl -X GET \
    -F 'access_token={user-access-token}' \
https://graph.facebook.com/<API_VERSION>/<user_business_id>/creative_folders?filtering=[{field:"permitted_tasks", operator: "EQUAL", value:"create_content"}]

Phản hồi

{
 "id": "<folder_id>"
}

Yêu cầu người dùng chọn một thư mục cấp cao nhất hiện có hoặc tạo thư mục cấp cao nhất mới trong Trình quản lý kinh doanh của người dùng. Đối với thư mục cấp cao nhất mới, bạn có thể yêu cầu người dùng đặt tên cho thư mục hoặc sử dụng <YourBusinessName>_<UserBusinessName>_<UserName> theo mặc định. Nếu người dùng chia sẻ thư mục với bạn, thư mục này sẽ hiển thị với cả doanh nghiệp của bạn và doanh nghiệp của người dùng trong thư viện tài sản Facebook.

Lưu ý: Bạn có thể lấy tên doanh nghiệp của người dùng bằng cách gửi yêu cầu GET đến điểm cuối {business-id}, trong đó {business-id} là ID doanh nghiệp của người dùng.

Nhận yêu cầu thông tin doanh nghiệp của người dùng

Yêu cầu

curl -X GET \
    -F 'access_token={user-access-token}' \
    https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>

Phản hồi

{
 "id": {business-id}
 "name": {user-business-name}
}

Tạo yêu cầu thư mục cấp cao nhất

Yêu cầu

curl -X POST \
    -F "name={folder_name}"
    -F "description={description}"
    -F 'access_token={user-access-token}' \
    https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/creative_folders

Phản hồi

{
 "id": {top-level-folder-id}
}

4. Chọn hoặc tạo thư mục con

Nếu bạn muốn hỗ trợ toàn bộ quy trình điều hướng thư mục, hãy yêu cầu người dùng chọn một thư mục con hiện có hoặc tạo thư mục con mới trong thư mục cấp cao nhất bằng các yêu cầu sau:

Lấy thư mục con

Yêu cầu quyền business_creative_management

Yêu cầu

curl -X GET \
    -F 'access_token={user-access-token}' \
    https://graph.facebook.com/<API_VERSION>/<parent_folder_id>/subfolders?fields=name

Phản hồi

{
 "data": [
   {
     "name": "<subfolder_name>",
     "id": "<subfolder_id>"
   }
 ]
}

Tạo thư mục con

Yêu cầu quyền business_creative_management

Yêu cầu

curl -X POST \
    -F "name={folder_name}"
    -F "description={description}"
    -F "parent_folder_id={parent-folder-id}"
    -F 'access_token={user-access-token}' \
 https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/creative_folders

Phản hồi

{
    "id": {sub-folder-id}
}

Bạn có thể xóa thư mục và thư mục con bằng cách gửi yêu cầu DELETE đến điểm cuối <folder_id> hoặc <subfolder_id>.

5. Tải hình ảnh và video lên thư mục con

Tải các tài sản nội dung của người dùng lên thư mục con.

Yêu cầu quyền business_creative_management

Tải hình ảnh lên

Yêu cầu

curl -X POST \
    -F 'bytes={image-content-in-bytes-format}' \
    -F 'name={image-name}' \
    -F 'access_token={user-access-token}' \
    -F 'creative_folder_id={subfolder-id}' \
    https://graph.facebook.com/{version}/{business-id}/images

Phản hồi

{
    "images":{
         "{image-name}":{
             "id":"{business-creative-image-id}",
             "hash":"{hash}",
             "url":"{image-url}"
         }
    }
}

Tải video lên

Tải video lên trong một yêu cầu nếu dung lượng chưa đến vài megabyte hoặc tải từng phần video lên (xem phần tiếp theo ở bên dưới). Thực hiện lệnh gọi API để tải video lên tại graph-video.facebook.com thay cho graph.facebook.com.

Ví dụ - Gửi yêu cầu POST đến {business-id}/video kèm theo tên video, nguồn và ID thư mục con của bạn.

Yêu cầu

curl -X POST \
    -F 'name={video-name}' \
    -F 'source='&#064;&#123;video-path&#125;'' \
    -F 'access_token={user-access-token}' \
    -F 'creative_folder_id={subfolder-id}' \
    https://graph-video.facebook.com/{version}/{business-id}/videos

Phản hồi

{
  "success": true,
  "business_video_id": "<business_video_id>"
}

Tải từng phần video lên

Đối với các video lớn hơn, hãy gửi một yêu cầu bắt đầu, một hoặc nhiều yêu cầu chuyển và một yêu cầu hoàn tất.

Để thực hiện yêu cầu bắt đầu và tạo phiên tải video lên, hãy gửi yêu cầu POST đến /{business-id}/videos, đặt trường upload_phase là bắt đầu và chỉ định file_size (theo byte)

Yêu cầu

curl -X POST \
 -F 'title={video-name}' \
 -F 'creative_folder_id={subfolder-id}' \
 -F 'access_token={user-access-token}' \
 -F 'upload_phase=start' \
 -F 'file_size={video_file_size_in_bytes}' \
 https://graph-video.facebook.com/<API_VERSION>/<BUSINESS_ID>/videos

Phản hồi

{
    "upload_session_id": "{session-id}",
    "video_id": "{video-id}",
    "start_offset": "0",
    "end_offset": "52428800"
}

Để tải [0, 52428800] lên từ video của bạn, hãy chia file thành nhiều phần theo các khoảng bù giữa bắt đầu và kết thúc, rồi gửi các phần này bằng yêu cầu chuyển. Chúng tôi sẽ gửi bạn các khoảng bù mới cho mỗi phần - hãy sử dụng khoảng bù mới này để tải từng phần lên.

Ví dụ: Gửi phần đầu tiên

Yêu cầu

curl -X POST \
    -F 'title={video-name}' \
    -F 'access_token={user-access-token}' \
    -F 'creative_folder_id={subfolder-id}' \
    -F 'upload_phase=transfer' \
    -F 'upload_session_id={session-id}' \
    -F 'start_offset=0' \
    -F 'video_file_chunk=@{binary-chunk-filename}' \
    https://graph-video.facebook.com/<API_VERSION>/<BUSINESS_ID>/videos

Phản hồi

Sau khi thành công, chúng tôi sẽ gửi phản hồi kèm theo khoảng bù cho phần tiếp theo

{
  "start_offset": "52428800", //Start byte position of the next file chunk
  "end_offset": "104857601" //End byte position of the next file chunk
}

Hãy cắt và tải lên phần thứ hai có khoảng [52428800, 104857601] từ file của bạn và gửi:

Yêu cầu

curl -X POST \
    -F 'title={video-name}' \
    -F 'access_token={user-access-token}' \
    -F 'creative_folder_id={subfolder-id}' \
    -F 'upload_phase=transfer' \
    -F 'start_offset=52428801' \
    -F 'upload_session_id={your-upload-sesson-id}' \
    -F 'video_file_chunk={binary-chunk-filename}' \
    https://graph-video.facebook.com/<API_VERSION>/<BUSINESS_ID>/videos

Phản hồi

Gửi tất cả những phần khác cho đến khi start_offset bằng end_offset:

{
 "start_offset": "152043520",
 "end_offset": "152043520"
}

Phản hồi ở trên có nghĩa là bạn đã tải lên toàn bộ file. Bây giờ, bạn cần đăng video này và đóng phiên tải lên.

Yêu cầu

curl -X POST \
    -F 'title={video-name}' \
    -F 'access_token={user-access-token}' \
    -F 'creative_folder_id={business-creative-folder-id}' \
    -F 'upload_phase=finish' \
    -F 'upload_session_id={session-id}' \
    https://graph-video.facebook.com/<API_VERSION>/<BUSINESS_ID>/videos

Nếu xảy ra lỗi trong quá trình tải lên, bạn có thể thử tải lại phần đó lên. Lỗi thường xảy ra do vấn đề phản hồi. Hãy thử tải lại phần không thành công lên. Để biết thêm thông tin về lỗi, hãy xem:

Ứng dụng cần thông báo cho người dùng biết quá trình tải lên đã thành công và hiển thị một liên kết sâu đến nội dung này sau nút kêu gọi hành động "Xem nội dung trong thư viện tài sản Facebook của tôi". Liên kết sâu của thư mục hoặc tài sản là:

https://business.facebook.com/asset_library/business_creatives/?object_id={asset_id or folder id} (trong giai đoạn phát triển)

Liên kết này hướng người dùng đến trang lựa chọn doanh nghiệp nếu người dùng có nhiều Trình quản lý kinh doanh. Để việc lựa chọn doanh nghiệp rõ ràng hơn, bạn có thể cung cấp ngữ cảnh doanh nghiệp trong URL như sau:

https://business.facebook.com/asset_library/business_creatives/?object_id={asset_id or folder id}&business_id={client_business_id}

Bạn có thể lấy url liên kết sâu bằng cách thực hiện yêu cầu GET trên điểm cuối:

curl -X GET \
    /<folder_id or asset_id>
        ?fields=['media_library_url']
        &access_token=<user_access_token>

Liên kết cho phép người dùng chuyển đến thư mục hoặc tài sản ngay trong thư viện tài sản Facebook.

6. Yêu cầu chia sẻ thư mục với bạn (không bắt buộc)

Bạn có thể yêu cầu chia sẻ thư mục cấp cao nhất nếu muốn quản lý thư mục hoặc xem thông tin chi tiết của tài sản. Hãy gửi yêu cầu POST đến: {business-creative-folder-id}/agencies và gán permitted_tasks cho CREATE_CONTENT.

Lưu ý: Bạn cũng có thể chỉ định quyền thực hiện tác vụ VIEW_INSIGHTS nếu người dùng cấp quyền business_creative_insights_share cho ứng dụng của bạn (trong giai đoạn phát triển).

Chia sẻ thư mục

Yêu cầu quyền business_creative_management

Yêu cầu

curl -X POST \
    -F 'permitted_tasks=['CREATE_CONTENT','VIEW_INSIGHTS']' \
    -F 'business={partner-business-id} ' \
    -F 'access_token={user-access-token}' https://graph.facebook.com/<API_VERSION>/<BUSINESS_CREATIVE_FOLDER_ID>/agencies

Tùy theo vai trò của người dùng trong tổ chức kinh doanh, phản hồi sẽ thuộc một trong hai loại sau:

1) Nếu mã truy cập của khách hàng là của một quản trị viên doanh nghiệp:

API sẽ thiết lập một thỏa thuận hợp tác giữa doanh nghiệp của người dùng và doanh nghiệp của khách hàng.

Phản hồi

Nếu thỏa thuận hợp tác giữa doanh nghiệp của người dùng và doanh nghiệp của bạn đã tồn tại (doanh nghiệp của người dùng đã chia sẻ thư mục với bạn và bạn đã chấp nhận yêu cầu chia sẻ trước đó):

{ 
    "success": true
}

Nếu bạn chưa chấp nhận yêu cầu chia sẻ từ doanh nghiệp của người dùng:

{
    "success": true,
    "share_status": "In Progress"
}

Trong tình huống này, doanh nghiệp của bạn cần chấp nhận yêu cầu chia sẻ thì mới có thể truy cập vào tất cả các tính năng được bật thông qua chia sẻ (xem, tạo, v.v.).

Để liệt kê tất cả các thỏa thuận hợp tác đang chờ phê duyệt, hãy gửi yêu cầu đến {business-id}/received_sharing_agreements bằng mã truy cập đối tác của bạn và đặt request_status thành IN_PROGRESS. Bạn cần có quyền business_creative_management và business_management để thực hiện hành động này.

Liệt kê tất cả các thỏa thuận hợp tác

Yêu cầu

curl -i -X GET https://graph.facebook.com/<API_VERSION>/<PARTNER_BUSINESS_ID>/received_sharing_agreements
    ?request_status=IN_PROGRESS
    &access_token={partner-access-token}"

Bạn có thể chấp nhận yêu cầu chia sẻ bằng cách gửi yêu cầu POST đến business_sharing_agreement_request_id và đặt request_status thành APPROVE. Bạn chỉ cần thực hiện thao tác này khi người dùng chia sẻ thư mục với doanh nghiệp của bạn lần đầu. Bạn cần có quyền business_management để thực hiện thao tác này:

Chấp nhận các thỏa thuận hợp tác

Yêu cầu

curl -X POST \
    -F 'request_status=APPROVE' \
    -F 'access_token={partner-access-token}' \
https://graph.facebook.com/<API_VERSION>/<BUSINESS_SHARING_AGREEMENT_REQUEST_ID>

Phản hồi

{ 
    "success": true
}

Hoặc bạn có thể phê duyệt các yêu cầu chia sẻ đang chờ trong giao diện người dùng Trình quản lý kinh doanh. Để xem các yêu cầu đang chờ xử lý trong Trình quản lý kinh doanh, hãy chuyển đến phần Cài đặt > Yêu cầu > Yêu cầu đã nhận, bạn có thể xem thêm thông tin về yêu cầu tại đây.

2) Nếu mã truy cập của khách hàng là của nhân viên doanh nghiệp:

API sẽ kích hoạt quy trình Thông báo để gửi email thông báo đến quản trị viên doanh nghiệp nhằm phê duyệt yêu cầu.

Phản hồi

{
   "success": true,
   "share_status": "Pending"
}

Theo trạng thái này, ứng dụng của bạn cần thông báo cho người dùng biết:

một yêu cầu đã được khởi tạo cho quản trị viên doanh nghiệp qua email để phê duyệt yêu cầu chia sẻ
một email khác liên quan đến yêu cầu đã được gửi cho người dùng

Để liệt kê tất cả các thỏa thuận đang chờ xử lý đã được khởi tạo trong doanh nghiệp của người dùng, hãy gửi yêu cầu đến {business-id}/attempted_sharing_agreements và đặt request_status thành IN_PROGRESS, đặt requesting_business_id thành ID Trình quản lý kinh doanh của người dùng. Bạn cần có quyền business_creative_management và business_management để thực hiện hành động này.

Liệt kê tất cả các thỏa thuận chia sẻ thư mục đang chờ xử lý

Yêu cầu

curl -i -X GET \ https://graph.facebook.com/<API_VERSION>/<PARTNER_BUSINESS_ID>/attempted_sharing_agreements
    ?request_status=IN_PROGRESS
    &requesting_business_id=<user_business_id>
    &access_token={partner-access-token}

Liệt kê mọi thỏa thuận chia sẻ thư mục đang chờ bằng ID yêu cầu

Ngoài ra, nếu có ID yêu cầu, bạn có thể trực tiếp nhận trạng thái bằng cách gửi yêu cầu đến {request_id}.

Yêu cầu quyền business_creative_management

Yêu cầu

curl -i -X GET  \
    https://graph.facebook.com/<API_VERSION>/<REQUEST_ID>?fields=status

Khi quản trị viên doanh nghiệp phê duyệt yêu cầu, trạng thái sẽ chuyển thành APPROVE và thư mục sẽ được chia sẻ với Trình quản lý kinh doanh của bạn nếu doanh nghiệp của người dùng và doanh nghiệp của bạn đã thiết lập mối quan hệ thỏa thuận chia sẻ (doanh nghiệp của người dùng đã chia sẻ thư mục với bạn và bạn đã chấp nhận yêu cầu chia sẻ trước đó). Nếu không, share_status sẽ được cập nhật thành IN_PROGRESS. Bạn có thể liệt kê tất cả các thỏa thuận hợp tác có trạng thái IN_PROGRESS và chấp nhận thỏa thuận thông qua API hoặc trong giao diện người dùng Trình quản lý kinh doanh.

7. Xem thông tin chi tiết về hình ảnh/video (không bắt buộc)

Khi người dùng chia sẻ thư mục với bạn kèm theo quyền thực hiện tác vụ VIEW_INSIGHTS, bạn có thể đọc thông tin chi tiết về hình ảnh và video của doanh nghiệp trong thư mục được chia sẻ bằng cách thực hiện yêu cầu GET trên điểm cuối <business_asset_id>/insights.

Thông tin chi tiết về nội dung của doanh nghiệp

Yêu cầu các quyền business_creative_management và business_creative_insights.

Yêu cầu

curl -i -X GET  \
https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_ID>/insights
    ?breakdowns=["age","gender"]
    &fields=impressions,inline_link_clicks,age,gender,date_start,
    &time_range={"since":"2019-08-01","until":"2019-08-22"}
    &access_token={partner-access-token}"

Phản hồi

{
 "data": [
   {
     "impressions": 99,
     "inline_link_clicks": 1,
     "age": "18-24",
     "gender": "female",
     "date_start": "2019-08-01",
     "date_end": "2019-08-22"    },
   {
     "impressions": 198,
     "inline_link_clicks": 2,
     "age": "18-24",
     "gender": "male",
     "date_start": "2019-08-01",
     "date_end": "2019-08-22"    },
   {
     "impressions": 464,
     "inline_link_clicks": 2,
     "age": "25-34",
     "gender": "female",
     "date_start": "2019-08-01",
     "date_end": "2019-08-22"    },
 ]
}

Có thể chia nhỏ số liệu theo:

gender
age
country
publisher_platform
platform_position
device_platform
ad_id
objective
optimization_goal
time_range (yêu cầu ngày ở định dạng "YYYY-MM-DD", tức là từ rạng sáng của ngày đó.)

Quản lý thư mục được chia sẻ bằng chính mã truy cập đối tác

Đối với đối tác dịch vụ được quản lý, bạn có thể quản lý thư mục cấp cao nhất bằng mã truy cập đối tác nếu họ đã chia sẻ thư mục với bạn kèm theo quyền thực hiện tác vụ thích hợp để cấp cho bạn:

Quyền thực hiện tác vụ CREATE_CONTENT trên thư mục, cho phép ứng dụng tạo thư mục con và tải hình ảnh, video lên thư mục.
(Không bắt buộc với người dùng) Quyền thực hiện tác vụ VIEW_INSIGHTS, cho phép ứng dụng xem thông tin chi tiết về hiệu quả của tài sản nội dung được lưu trữ trong thư mục này.

1. Kiểm tra quyền trên thư mục chính

Gọi điểm cuối <business_id>/creative_folders để lấy tất cả các thư mục chính trong doanh nghiệp của người dùng mà bạn được chia sẻ.

Yêu cầu quyền business_creative_management

Lấy thư mục từ doanh nghiệp của người dùng

Yêu cầu

curl -X GET \
     -F 'access_token={partner-access-token}' \  https://graph.facebook.com/<API_VERSION>/<partner_business_id>/creative_folders?filtering=[{field:"owner_business_id", operator:"EQUAL", value:"user_business_id"}]

Phản hồi

{ 
    "data": [
       { 
            "id": "<shared_folder_id>" 
       }
    ]
}

Lấy các quyền thực hiện tác vụ của bạn trên thư mục

Yêu cầu

curl -X GET \
 -F 'access_token={partner-access-token}' \
 https://graph.facebook.com/<API_VERSION>/<folder_id>/agencies

Phản hồi

{
 "data": [
   {
     "id": "<partner_business_id>",
     "name": "<partner business name>",
     "permitted_tasks": [
       "VIEW_INSIGHTS",
       "VIEW_CONTENT",
       "CREATE_CONTENT",
       "MANAGE_CONTENT",
       "MANAGE_PERMISSIONS"]
   }
 ],
}

Quyền thực hiện tác vụ CREATE_CONTENT là quyền bắt buộc để tải hình ảnh và video lên thư mục được chia sẻ
Quyền thực hiện tác vụ VIEW_INSIGHTS là quyền bắt buộc để truy vấn thông tin chi tiết về nội dung của hình ảnh/video trong thư mục được chia sẻ

2. Tạo thư mục con trong thư mục chính

Với quyền thực hiện tác vụ CREATE_CONTENT trên thư mục chính, bạn có thể tạo một thư mục con trong thư mục được chia sẻ.

Yêu cầu quyền business_creative_management

Tạo thư mục con

Yêu cầu

curl -X POST \
    -F "name={folder_name}"
    -F "description={description}"
    -F "parent_folder_id={parent-folder-id}"
    -F 'access_token={partner-access-token}' \
 https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/creative_folders

Phản hồi

{
 "id": {subfolder-id}
}

3. Tải hình ảnh và video lên thư mục con

Làm theo các bước được liệt kê trong Bước 5. Tải hình ảnh và video lên thư mục con bằng mã truy cập đối tác.

Theo dõi ID tài sản hình ảnh/video trên Facebook

Khi ứng dụng tải hình ảnh hoặc video lên thư viện tài sản Facebook, API của Facebook sẽ trả về một ID cho tài sản đó.

Để đảm bảo tính liên tục, ứng dụng cần theo dõi ID của tài sản dựa trên dự án/không gian làm việc đã tạo ra hình ảnh/video này trong ứng dụng.

Điều này cho phép hỗ trợ các trường hợp sử dụng "chỉnh sửa" và "cập nhật" tinh giản trong tương lai. Ví dụ:

Một người dùng trong ứng dụng của bạn quyết định tiếp tục chỉnh sửa tài sản sau khi đăng lên Facebook và sử dụng tài sản trong quảng cáo. Người dùng sẽ được nhắc thực hiện quy trình "cập nhật" hoặc "chạy thử nghiệm phân tách" tinh giản nếu ứng dụng của bạn gửi ID tài sản gốc khi tải lên một phiên bản cập nhật của hình ảnh/video.
Người dùng trong bảng điều khiển Thông tin chi tiết về quảng cáo trên Facebook có thể "chỉnh sửa" nội dung của mình, bao gồm việc chỉnh sửa hình ảnh/video sẽ chuyển người dùng đến ứng dụng của bạn, chuyển vào ID tài sản. Theo đó, ứng dụng của bạn có thể mở dự án đã tạo tài sản này, cho phép người dùng tiếp tục từ nơi họ dừng lại.

Cung cấp URL liên kết sâu cho tài sản, cũng như tạo các hành động trên quảng cáo và bài viết

URL liên kết sâu cho tài sản

Truy vấn trường media_library_url của tài sản hình ảnh/video được tải lên

Yêu cầu

curl -X GET \
    -F 'access_token={partner-access-token}' \
https://graph.facebook.com/<API_VERSION>/<asset_id>?fields=media_library_url

URL liên kết sâu để tạo quảng cáo hoặc bài viết trên Trang

Thêm &action=CREATE_AD hoặc &action=CREATE_POST vào cuối liên kết sâu trong bước ở trên.

Ví dụ:

https://business.facebook.com/asset_library/business_creatives/?object_id=2838437832929622&action=CREATE_AD

Bước tiếp theo

Nhận thông báo Webhook về quá trình cài đặt và gỡ cài đặt FBE của doanh nghiệp.
Kích hoạt sự kiện pixel cho mọi doanh nghiệp tích hợp FBE trên nền tảng của bạn.
Thêm điểm bắt đầu vào Chế độ quản lý tính năng từ giao diện của bạn.
Cho phép các doanh nghiệp gỡ cài đặt FBE.
Gửi để Xét duyệt tiện ích tích hợp FBE. Sau khi tiện ích tích hợp của mình được phê duyệt, bạn sẽ có thể ra mắt ứng dụng với người dùng công khai.