Mengonfigurasi Fitur Bisnis

Pelajari opsi yang tersedia untuk mengaktifkan dan mengonfigurasi fitur bisnis untuk Facebook Business Extension.

Opsi Konfigurasi

Untuk mengaktifkan dan mengonfigurasi fitur bisnis bagi pengguna, gunakan salah satu dari opsi yang tersedia ini:

OpsiDeskripsiRekomendasi

Pengaturan Fitur melalui Login Bisnis

Masuk ke Login Bisnis untuk mengaktifkan dan menonaktifkan fitur Facebook Business Extension.

Aktifkan opsi fitur ini untuk partner melalui Panel Developer FBE. Saat fitur ini digunakan, partner harus memberi tahu pengguna bahwa fitur ini secara otomatis diaktifkan untuk mereka.

Direkomendasikan jika Anda memiliki set fitur default yang disiapkan bagi pengguna.

Tampilan Pengelolaan Fitur

UI layanan mandiri dari Facebook agar pengguna bisa mengaktifkan dan menonaktifkan fitur FBE.

Direkomendasikan jika Anda tidak ingin membuat UI dan menggunakan UI layanan mandiri milik Facebook, atau fitur-fitur Facebook dan Instagram.

API Konfigurasi Fitur

Membuat tampilan pengelolaan fitur khusus untuk mengaktifkan dan menonaktifkan fitur FBE.

Direkomendasikan untuk membuat tampilan pengelolaan fitur Anda sendiri agar sesuai dengan tampilan dan nuansa pengguna Anda.

Fitur yang Didukung

Facebook Business Extension menawarkan banyak fitur yang dapat Anda aktifkan untuk bisnis Anda.

Fitur berikut dikelompokkan berdasarkan vertikal yang paling sesuai dengan fitur:

Fitur Standar

FiturParameterDeskripsi

Ajakan Bertindak di Halaman Facebook

page_cta(s)

Jenis: FBEPageCtaConfigData

Tombol Ajakan Bertindak (CTA) di Halaman Facebook bisnis tersebut.

Ajakan Bertindak di Instagram

ig_cta(s)

Jenis: FBEIGCtaConfigData

Tombol Ajakan Bertindak (CTA) di Profil Instagram bisnis tersebut.

Ajakan Bertindak di Messenger

messenger_menu

Jenis: FBEMessengerMenuConfigData

Tombol Ajakan Bertindak (CTA) di Messenger ketika pengguna berkirim pesan ke bisnis.

Obrolan Messenger

messenger_chat

Jenis: FBEMessengerChatConfigData

Mengaktifkan integrasi Messenger langsung ke situs web Anda, memungkinkan pelanggan untuk berinteraksi dengan bisnis Anda kapan saja.

Fitur Spesifik APPOINTMENTS

FiturParameterDeskripsi

Kartu Halaman Layanan Unggulan

page_card

Jenis: FBEPageCardConfigData

Memerlukan Katalog.

Kartu dengan layanan unggulan bisnis di Halaman Facebook mereka.

Niat Utas Kirim Ketersediaan di Messenger

thread_intent

Jenis: FBEThreadIntentConfigData

Saran Messenger untuk admin bisnis agar mudah mengirimkan status ketersediaan mereka ke pengguna dalam obrolan.

Tidak Diperlukan Penerapan Tambahan

FiturParameterDeskripsi

Ajakan Bertindak di Halaman Facebook

page_cta

Jenis: FBEPageCtaConfigData

Tombol Ajakan Bertindak (CTA) di Halaman Facebook bisnis tersebut.

Ajakan Bertindak di Instagram

ig_cta

Jenis: FBEIGCtaConfigData

Tombol Ajakan Bertindak (CTA) di Profil Instagram bisnis tersebut.

Ajakan Bertindak di Messenger

messenger_menu

Jenis: FBEMessengerMenuConfigData

Tombol Ajakan Bertindak (CTA) di Messenger ketika pengguna berkirim pesan ke bisnis.

Niat Utas Kirim Ketersediaan di Messenger

thread_intent

Jenis: FBEThreadIntentConfigData

Saran Messenger untuk admin bisnis agar mudah mengirimkan status ketersediaan mereka ke pengguna dalam obrolan.

Diperlukan Penerapan Tambahan

FiturParameterDeskripsi

Kartu Halaman Layanan Unggulan

page_card

Jenis: FBEPageCardConfigData

Hanya tersedia untuk vertikal APPOINTMENTS.

Memerlukan penerapan Katalog.

Mengaktifkan kartu dengan layanan unggulan bisnis di Halaman Facebook mereka. Lihat Katalog FBE untuk kolom dan format wajib bagi vertikal SERVICES.

Obrolan Messenger

messenger_chat

Jenis: FBEMessengerChatConfigData

Mengaktifkan integrasi Messenger langsung ke situs web Anda. Fitur ini memungkinkan pelanggan Anda berinteraksi dengan bisnis Anda kapan saja dengan pengalaman media yang kaya, dipersonalisasikan, dan sama seperti yang mereka dapatkan di Messenger.

Jika messenger_chat memberikan enabled: true dari API Konfigurasi Fitur:

<div class="fb-customerchat"
            page_id="<PAGE_ID>">
        </div>
  • page_id bisa didapatkan melalui Webhooks atau panduan endpoint penginstalan FBE.
  • Facebook secara otomatis mengambil penyesuaian berdasarkan page_id yang diteruskan; oleh karena itu, tidak memerlukan penyesuaian apa pun untuk diteruskan secara eksplisit.

Untuk panduan penerapan lengkap, lihat Plugin Obrolan Pelanggan.

Pengaturan Fitur Awal melalui Login Bisnis

Anda dapat mengonfigurasi sejumlah fitur untuk bisnis Anda dengan menentukannya di properti business_config, yang diteruskan melalui parameter extras baik di Login Bisnis maupun App Store. Di sinilah Anda harus menentukan semua fitur yang ingin Anda aktifkan untuk bisnis Anda segera setelah penginstalan FBE selesai.

business_config adalah objek JSON yang berisi subkolom untuk menjelaskan cara mengonfigurasi berbagai fitur. Pelajari selengkapnya tentang subkolom untuk menentukan dan business_config. Contoh: untuk mengonfigurasi hanya CTA Halaman Facebook dan CTA Instagram milik bisnis, objek business_config Anda akan terlihat seperti berikut ini:

{
  "business": {
    "name": "Foo Business"
  },
  "page_cta": {
    "enabled": true,
    "cta_button_text": "Book Now",
    "cta_button_url": "https://partner-site.com/foo-business",
    "below_button_text": "Powered by FBE Partner"
  },
  "ig_cta": {
    "enabled": true,
    "cta_button_text": "Book Now",
    "cta_button_url": "https://partner-site.com/foo-business"
  },
}

Tampilan Pengelolaan Fitur FBE

Agar bisnis Anda dapat mengonfigurasi fitur lebih lanjut (di luar yang Anda tentukan di business_config selama penginstalan), Anda dapat mengarahkan bisnis ke Tampilan Pengelolaan FBE dari platform Anda.

Anda dapat menambahkan poin entri untuk meluncurkan Tampilan Pengelolaan FBE dengan menambahkan metode berikut (JavaScript SDK atau URL). Kedua contoh menampilkan tombol untuk diklik, yang akan meluncurkan jendela Mode Pengelolaan FBE. Kami merekomendasikan untuk menyembunyikan tombol luncurkan FBE sampai klien menyelesaikan pengaturan FBE. Pastikan bahwa Anda melewati fbe_external_business_id untuk external_business_id.

Anda dapat menentukan tab yang dipilih untuk Tampilan Pengelolaan FBE dengan melewati parameter opsional tab dengan nama tab yang diinginkan. Contoh: ini dapat diatur ke 'Rumah' atau 'Jual Beli'. Parameter ini dapat digunakan dalam Facebook SDK untuk JavaScript atau dengan metode URL.

Facebook SDK untuk JavaScript

<script>
  function launchFBEManagementView() {
    FB.ui({
      display: 'popup',
      method: 'facebook_business_extension',
      external_business_id: '<fbe_external_business_id>',
      tab: '<selected_tab_name>', // optional
      }, function(response){
        // implement
      });
  }
</script>

<a href="javascript:void(0);"> <button onclick="launchFBEManagementView()">Launch Management View<button></a>;

Metode URL

<a href="https://www.facebook.com/facebook_business_extension?app_id=<app_id>&external_business_id=<fbe_external_business_id>&tab=<selected_tab_name>"><button>Launch Management View</button></a>

API Konfigurasi Fitur FBE

Untuk mengonfigurasi dan memperbarui fitur bisnis dari bagian Anda setelah penginstalan awalnya, Anda dapat menggunakan API Konfigurasi Fitur FBE.

Untuk fitur yang tidak dapat disesuaikan, hanya ID instance fitur dan bendera aktif yang ditampilkan. Hanya fitur yang dapat disesuaikan yang dapat diperbarui dengan permintaan POST.

API Konfigurasi Fitur berbeda dari API Penginstalan FBE karena menyediakan informasi fitur tambahan di luar aset yang terhubung, termasuk status yang diaktifkan dan penyesuaian fitur tertentu. Setelah memanggil API Penginstalan FBE, gunakan API Konfigurasi Fitur jika perlu informasi selengkapnya tentang status atau konfigurasi fitur yang diaktifkan.

Endpoint API berikut memungkinkan Anda untuk mengaktifkan, menonaktifkan, dan mengonfigurasi fitur untuk bisnis tertentu di platform Anda yang telah menginstal FBE. access_token yang digunakan untuk endpoint ini adalah yang diberikan kepada Anda melalui Login Bisnis atau Webhooks.

Kami merekomendasikan untuk tidak menyimpan konfigurasi bisnis di server Anda. Konfigurasi tersebut harus selalu di-kueri, kemudian dimodifikasi melalui API yang ditentukan di bawah ini. Pengguna berpotensi dapat mengubah fitur tersebut di platform Facebook atau melalui Tampilan Pengelolaan FBE dan platform Anda mungkin tidak memiliki konfigurasi terbaru.

Membaca

Anda dapat membaca status konfigurasi fitur saat ini dari bisnis apa pun dengan mengeluarkan permintaan berikut:

CURL -X GET 'https://graph.facebook.com/<API_VERSION>/fbe_business/?fbe_external_business_id=<fbe_external_business_id>&access_token=<access_token>'

Tanggapan

Lihat objek business_config.

Memperbarui

Untuk memperbarui setiap dan semua fitur, sediakan permintaan POST berikut:

CURL -i -X POST \ 
  -F 'fbe_external_business_id=<fbe_external_business_id>' \
  -F 'business_config={business_config object}' \
  -F 'access_token=<access_token>' \

  "https://graph.facebook.com/<API_VERSION>/fbe_business"

Tanggapan

Contoh tanggapan.

    {
  "page_cta": {
     "feature_instance_id": id1,
     "enabled": true,
     "cta_button_text": "Book Now",
     "cta_button_url": "https://partner-site.com/foo-business1",
     "below_button_text": "Powered by FBE Partner"
  },
  "page_ctas": [
    {
        "feature_instance_id": id1,
        "enabled": true,
        "cta_button_text": "Book Now",
        "cta_button_url": "https://partner-site.com/foo-business1",
        "below_button_text": "Powered by FBE Partner"
    },
    {
        "feature_instance_id": id2,
        "enabled": true,
        "cta_button_text": "Book Now",
        "cta_button_url": "https://partner-site.com/foo-business2",
        "below_button_text": "Powered by FBE Partner"
    }
  ],
  "ig_ctas": [{...}, {...}],
  “ads”: [
    {
      "feature_instance_id": id3,
      “enabled”: true,
    },
    {
      "feature_instance_id": id4,
      “enabled”: true,
    },
  ],
  ...
}

Aktifkan dan konfigurasikan tombol Ajakan Bertindak di halaman milik pengguna akhir dan kirim permintaan POST:

CURL -i -X POST \ 
  -F 'fbe_external_business_id=<fbe_external_business_id>' \
  -F 'business_config= {
       "business":{
       "name":"example_business"
        },
        "page_cta":{
          "enabled":true,
          "cta_button_text":"Buy Now",
          "cta_button_url":"https://examplebusiness.com",
          "below_button_text":"Powered by a partner"
        }
      }' \
  -F 'access_token=<access_token>' \
  "https://graph.facebook.com/<API_VERSION>/fbe_business"

Pelajari Selengkapnya

Katalog

Langkah Berikutnya

Picu Peristiwa Pixel