Meta Business Extension

Katalog

Facebook Business Extension (FBE) menggunakan Katalog untuk memasukkan stok bisnis. Ini digunakan untuk memberdayakan berbagai fitur, seperti iklan dinamis, Toko di Halaman, dan Kartu Layanan Unggulan. Ini adalah bagian opsional dari integrasi, tetapi diperlukan untuk fitur tertentu.

Katalog Facebook memiliki rangkaian API sendiri, tetapi FBE terintegrasi dengan beberapa di antaranya secara langsung sehingga Anda dapat dengan mudah memperbarui stok bisnis di platform kami (tanpa Anda perlu melacak ID Katalog Facebook di pihak Anda).

Untuk memastikan bahwa semua kolom wajib telah diisi dengan benar di katalog Anda untuk iklan dinamis dan kasus penggunaan jual beli (Toko di Halaman, Instagram Shop, Marketplace), lihat Kolom Dukungan.

Memperbarui Stok

Untuk memperbarui stok, ada 2 metode:

  • Dorong: Dorong katalog ke Facebook melalui API (direkomendasikan)
  • Tarik: Agar Facebook secara berkala Menarik katalog dari platform Anda (tidak disarankan karena menyebabkan stok tidak terkini dan beban server yang tidak perlu)

Metode Dorong

Kami sangat merekomendasikan penggunaan salah satu metode Dorong (API Batch atau API Unggah Kabar Satu Kali) karena memungkinkan pembaruan stok langsung dan mengurangi beban server di kedua sisi. access_token yang digunakan di sini sama dengan yang diberikan oleh Login Bisnis dan Webhooks.

Anda harus mengirimkan stok lengkap bisnis kepada kami segera setelah Anda menerima Webhooks penginstalan baru. Anda perlu mengirim pembaruan setiap kali bisnis melakukan perubahan pada stok mereka di situs web Anda.

Batch API

Direkomendasikan untuk sebagian besar bisnis ecommerce. Batch API adalah API Katalog Facebook standar; berguna untuk bisnis dengan stok besar (lebih dari 100 item) dan/atau sering memperbarui item.

API Unggah Kabar Satu Kali

Tersedia untuk bisnis Janji Temu (Layanan). API Unggah Kabar Satu Kali berguna untuk bisnis dengan stok yang lebih kecil (~100 barang atau kurang).

Dengan metode ini, Anda mengirimkan stok lengkap setiap kali pembaruan dilakukan, yang melakukan penggantian stok sepenuhnya di Katalog Facebook.

Langkah 1: Dapatkan ID Kabar yang dibuat selama penginstalan FBE dengan mengirimkan ID Katalog yang terhubung (dari notifikasi Webhooks atau dari endpoint API penginstalan FBE kami):

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

Pelajari selengkapnya tentang API Kabar Produk.

Langkah 2: Lakukan unggahan satu kali ke kabar:

Contoh—File feed di-hosting di lokasi publik.

Graph API Explorer
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 */
      }
    }
);

Contoh—Mengunggah file feed langsung dari mesin lokal. Jalur ke file perlu diubah sesuai dengan kasus penggunaan Anda.

Graph API Explorer
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 */
      }
    }
);

Format yang Didukung

Semua format permintaan dan tanggapan sama seperti yang didokumentasikan untuk endpoint asli.

Vertikal Contoh Kabar CSV Contoh Kabar TSV Contoh Kabar XML

ECOMMERCE

Contoh CSV ECOMMERCE

Contoh TSV ECOMMERCE

Contoh XML ECOMMERCE

APPOINTMENTS

Contoh CSV APPOINTMENTS

Contoh TSV APPOINTMENTS

Contoh XML APPOINTMENTS

Lihat Kolom yang didukung Katalog Janji Temu (Layanan).

Metode Tarik

Kami tidak menyarankan metode ini karena metode ini menyebabkan stok tidak terkini sampai penarikan berikutnya, tetapi berguna untuk bisnis kecil yang di-hosting sendiri dengan file stok yang dapat diakses publik. Jika Anda memilih penggunaan metode ini untuk bisnis, Anda perlu menentukan fitur catalog_feed_scheduled di Konfigurasi Bisnis, yang diteruskan melalui Login Bisnis. Jika ini ditentukan, kami secara teratur mengambil stok bisnis dari URL publik yang ditentukan, terlepas dari pembaruan apa pun.

Pelajari selengkapnya tentang Penarikan Kabar Terjadwal.