Onboarding Marketplace FBE

Facebook Business Extension (FBE) memungkinkan penjual Anda untuk dengan mudah menjalankan iklan di seluruh jajaran aplikasi Facebook dengan menghubungkan aset Facebook yang ada seperti Halaman Facebook atau Pengelola Bisnis atau dengan membuat aset yang sama sekali baru. FBE dapat digunakan untuk membantu onbboarding penjual di marketplace ke solusi Meta dengan lancar.

Di bawah ini adalah langkah-langkah utama yang khusus untuk alur marketplace. Kami rekomendasikan langkah-langkah ini seiring dengan dokumen developer utama.

Alur Marketplace FBE

Partner = Marketplace

FBE = Facebook Business Extension (UI milik Facebook)

Sebelum Memulai

Aplikasi Anda harus dimiliki oleh Pengelola Bisnis yang merupakan bisnis terverifikasi. Pelajari selengkapnya tentang cara memverifikasi bisnis Anda.
Aplikasi Facebook diperlukan dengan izin berikut yang disetujui melalui Tinjauan Aplikasi:

Izin pribadi
1. manage_business_extension—Ini adalah izin pribadi yang mengharuskan perwakilan Meta Anda untuk menambahkan aplikasi Anda ke daftar diizinkan.
Izin publik (marketplace perlu memintanya melalui Tinjauan Aplikasi).
1. business_management—diperlukan untuk mendapatkan kembali ID Pengelola Bisnis yang dibuat melalui FBE dan menggunakan API Pengelola Bisnis untuk mengelola aset bisnis.
2. ads_management—diperlukan untuk mengelola iklan penjual atas nama klien.

Langkah Kunci untuk FBE dan API Iklan Kolaboratif

Penjual (merek) meluncurkan layar pop-up pengaturan FBE melalui situs web marketplace
Penjual mengikuti alur onboarding FBE dan menyelesaikan pengaturan aset inti (Pengelola Bisnis, Halaman, dan sebagainya)
FBE menampilkan bahwa penjual berhasil menyiapkan ID aset (melalui API atau Webhooks). Setelah marketplace menerima ID, segmen katalog dapat dibuat/dibagikan melalui API atau UI (menggunakan fitur Pusat Kolaborasi dalam Pengelola Bisnis).
Penjual meluncurkan Tampilan Pengelolaan FBE, tempat mereka dapat melihat status segmen katalog yang dibuat, dan menerima Ketentuan Layanan, jika ini adalah pertama kalinya penjual menerima permintaan segmen katalog dari marketplace.
Marketplace mengarahkan penjual ke alur pembuatan iklan (alur produser yang ada - Pengelola Iklan, dsb.)

Konfigurasi Wajib

Ekstra

Kolom Jenis Deskripsi

Kolom	Jenis	Deskripsi
`setup`	pengaturan	Wajib Pengaturan Facebook penjual, seperti pengidentifikasi unik mereka (`external_business_id`) atau mata uang untuk katalog mereka (`currency`). Lihat detail objek pengaturan.
`business_config`	business_config	Wajib Objek konfigurasi yang digunakan Ekstensi Bisnis Facebook untuk mengonfigurasi alur kerja Facebook Business Extension. Lihat detail objek `business_config`.
`repeat`	boolean	Wajib Atur nilai ini ke `false`.

setup

pengaturan

Wajib

Pengaturan Facebook penjual, seperti pengidentifikasi unik mereka (external_business_id) atau mata uang untuk katalog mereka (currency). Lihat detail objek pengaturan.

business_config

business_config

Wajib

Objek konfigurasi yang digunakan Ekstensi Bisnis Facebook untuk mengonfigurasi alur kerja Facebook Business Extension. Lihat detail objek business_config.

repeat

boolean

Wajib

Atur nilai ini ke false.

Pengaturan

Kolom	Deskripsi
`external_business_id` Jenis: string	Wajib. ID bisnis unik untuk mewakili bisnis klien Anda. Kami menggunakan ini sebagai pengidentifikasi unik. Contoh: jika perusahaan penjual namanya "Fubar", maka "fubar-123" bisa menjadi `external_business_id` mereka.
`timezone` Jenis: string	Wajib. Zona waktu di lokasi bisnis. Lihat kemungkinan nilai zona waktu.
`currency` Jenis: string	Wajib. Tiga huruf kode mata uang ISO dari mata uang default yang digunakan oleh item katalog bisnis. Lihat kode mata uang yang didukung.
`business_vertical` Jenis: enum	Wajib. Vertikal yang terkait dengan bisnis untuk Marketplace adalah `ECOMMERCE`
`merchant_settings_id` Jenis: string	Opsional. Digunakan saat meningkatkan dari Facebook Business Extension, v1. Hubungi perwakilan Facebook Anda jika Anda memigrasi dari v1 ke v2.
`channel` Jenis: enum	Wajib. Menyediakan cara bagi partner untuk mengungkapkan maksud bagi pengguna terkait fitur yang memerlukan langkah atau batasan tambahan: Catatan:`channel` untuk alur FBE khusus Marketplace adalah `MARKETPLACE`. Harap pastikan bahwa Anda meneruskan ini di kolom `channel`.
`business_manager_id` Jenis: string	Opsional. ID Pengelola Bisnis untuk Pengelola Bisnis pengguna yang sudah ada yang dapat dimasukkan partner untuk dipilih sebelumnya bagi pengguna dalam alur pengaturan.
`page_id` Jenis: string	Opsional. ID Halaman untuk Halaman Facebook pengguna yang sudah ada yang dapat dimasukkan partner untuk dipilih sebelumnya bagi pengguna dalam alur pengaturan.

Konfigurasi Bisnis

Gunakan objek ini untuk mengonfigurasi pengaturan bisnis untuk pengguna akhir; ini termasuk Messenger dan banyak lagi. Setiap kolom menyertakan "jenis" yang ditautkan ke tabel masing-masing di bawah ini.

Kolom	Deskripsi
`business` FBEBusinessPropertiesConfigData	Wajib. Informasi untuk bisnis pengguna akhir.
`messenger_chat` FBEMessengerChatConfigData	Opsional. Fitur obrolan Messenger di halaman Facebook pengguna akhir, seperti `enabled` dan `domains`.
`catalog_feed_scheduled` FBECatalogFeedConfigData	Opsional. Menentukan apakah Facebook Business Extension harus menggunakan pendekatan kabar, yang mengambil item katalog dari `feed_url`
`page_cta` FBEPageCtaConfigData	Opsional. Tombol ajakan bertindak (CTA) di halaman pengguna akhir, seperti `cta_button_text`, `cta_button_url`, dsb.
`ig_cta` FBEIGCtaConfigData	Opsional. Fitur untuk fitur ajakan bertindak Instagram, seperti `enabled`, `cta_button_text`, `cta_button_url`, dsb.
`messenger_menu` FBEMessengerMenuConfigData	Opsional. Fitur untuk fitur menu persisten Messenger, seperti `cta_button-text` dan `cta_button_url`

Setelah Penginstalan

Dapatkan ID aset, verifikasi notifikasi Webhooks, dan peristiwa Pixel.
Setelah ID aset diterima, buat/bagikan segmen katalog melalui API atau UI (menggunakan alat Pusat Kolaborasi dalam Pengelola Bisnis).
Setelah panggilan API pembuatan segmen katalog berhasil, periksa di sini untuk detail tentang meluncurkan pop-up Tampilan Pengelolaan FBE agar penjual menerima segmen katalog bersama dan menyelesaikan onboarding.

Luncurkan Tampilan Pengelolaan FBE setelah pengaturan FBE selesai dan ID aset berhasil diberikan melalui Webhooks / API.