Danh mục

Tiện ích Facebook Business (FBE) sử dụng Danh mục để lấy danh sách cung ứng của doanh nghiệp. Danh mục này được dùng để hỗ trợ nhiều tính năng khác nhau, chẳng hạn như quảng cáo động, Cửa hàng trên Trang và Thẻ dịch vụ đáng chú ý. Đây là phần không bắt buộc của tiện ích tích hợp nhưng cần thiết cho một số tính năng.

Danh mục trên Facebook có riêng bộ API. Tuy nhiên, FBE tích hợp trực tiếp với một số API này để bạn có thể dễ dàng cập nhật danh sách cung ứng của một doanh nghiệp trên nền tảng của chúng tôi (mà không cần phải tự mình theo dõi các ID Danh mục trên Facebook).

Để đảm bảo điền chính xác tất cả những trường bắt buộc trong danh mục cho quảng cáo động và các trường hợp sử dụng thương mại (Cửa hàng trên Trang, Mua sắm trên Instagram, Marketplace), hãy xem phần Trường được hỗ trợ.

Cập nhật danh sách cung ứng

Dưới đây là 2 phương thức cập nhật danh sách cung ứng:

  • Đẩy: Đẩy danh mục lên Facebook qua API (khuyên dùng)
  • Kéo: Yêu cầu Facebook định kỳ Kéo danh mục từ nền tảng của bạn (không khuyến khích dùng vì dẫn đến tình trạng danh sách cung ứng bị cũ và dung lượng không cần thiết trên máy chủ)

Phương thức Đẩy

Bạn nên sử dụng một trong các phương thức Đẩy (API Hàng loạt hoặc API Tải lên nguồn cấp dữ liệu một lần) vì phương thức này cho phép cập nhật danh sách cung ứng tức thì và giảm dung lượng trên máy chủ ở cả hai phía. access_token dùng ở đây giống với mã mà phương thức Đăng nhập cho doanh nghiệpWebhook trả về.

Bạn phải gửi cho chúng tôi danh sách cung ứng đầy đủ của doanh nghiệp ngay khi nhận được một Webhook cài đặt mới. Bạn cần gửi phần cập nhật mỗi khi doanh nghiệp thay đổi danh sách cung ứng của họ trên trang web của bạn.

API Hàng loạt

Khuyên dùng cho hầu hết doanh nghiệp thương mại điện tử. API Hàng loạt là API Danh mục tiêu chuẩn trên Facebook, hữu ích cho các doanh nghiệp có danh sách cung ứng lớn (hơn 100 mặt hàng) và/hoặc thường xuyên cập nhật các mặt hàng.

API Tải lên nguồn cấp dữ liệu một lần

Dành cho các doanh nghiệp cung cấp (Dịch vụ) Cuộc hẹn.API Tải lên nguồn cấp dữ liệu một lần là API Danh mục tiêu chuẩn trên Facebook, hữu ích cho các doanh nghiệp có danh sách cung ứng nhỏ hơn (khoảng 100 mặt hàng trở xuống).

Với phương thức này, bạn sẽ gửi một danh sách cung ứng đầy đủ bất cứ khi nào có cập nhật, nghĩa là thay thế hoàn toàn danh sách cung ứng trong Danh mục trên Facebook.

Bước 1: Lấy ID nguồn cấp dữ liệu được tạo trong quá trình cài đặt FBE bằng cách gửi ID danh mục được kết nối (từ thông báo Webhook hoặc từ điểm cuối API cài đặt FBE của chúng tôi):

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

Tìm hiểu thêm về API Nguồn cấp dữ liệu sản phẩm.

Bước 2: Tải một lần lên nguồn cấp dữ liệu:

Ví dụ - Các file nguồn cấp dữ liệu được lưu trữ ở một vị trí công khai.

Trình khám phá API Đồ thị
curl -X POST \
  -F 'url="http://www.example.com/sample_feed.xml"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/{FEED_ID}/uploads
POST /{FEED_ID}/uploads HTTP/1.1
Host: graph.facebook.com

url=http%3A%2F%2Fwww.example.com%2Fsample_feed.xml
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/{FEED_ID}/uploads',
    array (
      'url' => 'http://www.example.com/sample_feed.xml',
    ),
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/{FEED_ID}/uploads",
    "POST",
    {
        "url": "http:\/\/www.example.com\/sample_feed.xml"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

Ví dụ - Tải trực tiếp các file nguồn cấp dữ liệu lên từ máy cục bộ. Đường dẫn đến file này cần thay đổi theo trường hợp sử dụng của bạn.

Trình khám phá API Đồ thị
curl -X POST \
  -F 'file=@catalog.csv;type=text/csv' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/{FEED_ID}/uploads
POST /{FEED_ID}/uploads HTTP/1.1
Host: graph.facebook.com

file=%40catalog.csv%3Btype%3Dtext%2Fcsv
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/{FEED_ID}/uploads',
    array (
      'file' => '@catalog.csv;type=text/csv',
    ),
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/{FEED_ID}/uploads",
    "POST",
    {
        "file": "@catalog.csv;type=text\/csv"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

Định dạng được hỗ trợ

Tất cả định dạng yêu cầu và phản hồi đều giống như trong tài liệu dành cho điểm cuối gốc.

Xem các trường được hỗ trợ cho Danh mục (Dịch vụ) Cuộc hẹn.

Phương thức Kéo

Bạn không nên sử dụng phương thức này vì danh sách cung ứng không được cập nhật cho đến lần kéo tiếp theo. Tuy nhiên, phương thức này hữu ích cho các doanh nghiệp nhỏ, tự lưu trữ dữ liệu và có file danh sách cung ứng có thể truy cập công khai. Nếu chọn dùng phương thức này cho doanh nghiệp, bạn cần chỉ định tính năng catalog_feed_scheduled trong Cấu hình doanh nghiệp, được chuyển vào qua phương thức Đăng nhập cho doanh nghiệp. Khi đó, chúng tôi sẽ thường xuyên tìm nạp danh sách cung ứng của doanh nghiệp từ URL công khai đã chỉ định, bất kể danh sách cung ứng này có cập nhật hay không.

Tìm hiểu thêm về phương thức Kéo nguồn cấp dữ liệu theo lịch.