Onboarding MBE Pixel dan Conversions API

Alur Pixel dan Conversions API untuk Meta Business Extension (MBE) memungkinkan pengguna membuat atau memilih Pengelola Bisnis, Halaman, dan Meta Pixel mereka. Alur ini direkomendasikan untuk partner dengan kemampuan hosting situs web. Menggunakan pixel yang dikembalikan setelah menyelesaikan alur ini, partner dapat mengirim peristiwa ke Facebook atas nama klien mereka melalui browser atau Conversions API. Alur ini tidak memiliki kapabilitas Katalog.

Sebelum Memulai

Aplikasi Anda harus dimiliki oleh Pengelola Bisnis yang merupakan bisnis terverifikasi. Pelajari selengkapnya tentang cara memverifikasi bisnis Anda.
Aplikasi Facebook diperlukan dengan level akses, fitur, dan izin berikut:
- Level Akses: Akses Lanjutan
- Fitur: Akses Standar Pengelolaan Iklan
- Izin Publik: ads_management, pages_read_engagement, dan ads_read
- Izin Pribadi: manage_business_extension — Ini adalah izin pribadi yang mengharuskan perwakilan Facebook Anda untuk menambahkan aplikasi Anda ke daftar diizinkan.
- Token Akses Pengguna Sistem: Mengirim peristiwa ke Conversions API memerlukan Token Akses. Untuk membuat Token Akses atas nama klien, gunakan Token Akses yang dikembalikan melalui FBE dan ubah menjadi Token Akses Pengguna Sistem dengan membuat panggilan API tambahan.

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

Gunakan objek ini untuk menentukan pengaturan kehadiran Facebook pengguna akhir

Kolom	Deskripsi
`external_business_id` 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` string	Opsional Zona waktu di lokasi bisnis. Lihat kemungkinan nilai zona waktu.
`currency` string	Opsional Tiga huruf kode mata uang ISO dari mata uang default yang digunakan oleh item katalog bisnis. Lihat kode mata uang yang didukung.
`business_vertical` enum	Wajib Vertikal yang terkait dengan bisnis Nilai:`ECOMMERCE`
`merchant_settings_id` string	Opsional Digunakan saat meningkatkan dari Facebook Business Extension, v1. Hubungi perwakilan Facebook Anda jika Anda memigrasi dari v1 ke v2.
`domain` string	Wajib untuk saluran COMMERCE dan COMMERCE_OFFSITE Domain digunakan untuk persetujuan manual Instagram. Contoh: `https://exampleshop.partnersite.com`.
`channel` enum	Wajib Menyediakan cara bagi partner untuk mengonfigurasi alur Conversions API dari MBE. Untuk alur Conversions API, nilai ini seharusnya `CONVERSIONS_API`. `CONVERSIONS_API`— Alur yang memungkinkan pengguna akhir membuat atau memilih Pengelola Bisnis, Akun Iklan, dan objek Meta Pixel. Membuat objek ini memungkinkan pengguna akhir mengirimkan peristiwa dari situs web mereka ke Facebook melalui Conversions API atau Pixel browser.
`business_manager_id` string	Opsional ID Pengelola Bisnis untuk Pengelola Bisnis pengguna yang sudah ada yang dapat dimasukkan partner untuk dipilih sebelumnya bagi pengguna dalam alur pengaturan.
`ad_account_id` string	Opsional ID Akun Iklan untuk akun iklan pengguna yang sudah ada yang dapat dimasukkan partner untuk dipilih sebelumnya bagi pengguna dalam alur pengaturan.
`page_id` string	Opsional ID Halaman untuk Halaman Facebook pengguna yang sudah ada yang dapat dimasukkan partner untuk dipilih sebelumnya bagi pengguna dalam alur pengaturan.
`ig_profile_id` string	Opsional ID Profil Instagram Business untuk Profil Instagram Business pengguna yang sudah ada yang dapat dimasukkan partner untuk dipilih sebelumnya bagi pengguna dalam alur pengaturan.
`pixel_id` string	Opsional ID Pixel untuk Pixel pengguna yang sudah ada yang dapat dimasukkan partner untuk dipilih sebelumnya bagi pengguna dalam alur pengaturan.
`catalog_id` string	Opsional ID Katalog untuk katalog 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 CTA dan lainnya. Setiap kolom menyertakan "jenis" yang ditautkan ke tabel masing-masing di bawah ini.

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