Panduan Migrasi: Instagram (IX) ke Meta Business Extension, v2

Sebagai salah satu mitra kami di Tombol Tindakan Instagram, yang didukung oleh integrasi Instant Experience (IX), Anda harus membuat persyaratan Meta Business Extension (MBE), v2 berikut ini untuk mempertahankan tombol ajakan bertindak Pesan Makanan dan fungsi stiker Cerita Pesanan Makanan:

1. URL Autentikasi: Untuk onboarding ke MBE dari Facebook atau Instagram.
2. Webhooks: Untuk menerima notifikasi segera setiap kali salah satu bisnis Anda menginstal atau menghapus penginstalan MBE.
3. Picu Peristiwa Pixel: Untuk membantu bisnis Anda menargetkan pelanggan baru dengan lebih baik, meningkatkan transaksi di situs web, dan secara langsung mengukur bagaimana integrasi FBE membantu meningkatkan hasil mereka.

Setelah Anda menyelesaikan pengembangan dan pengujian MBE, Meta akan meninjau dan memverifikasi integrasi Anda. Setelah disetujui, aplikasi Anda akan tersedia untuk pengguna publik.

Sebelum Memulai

• Jika belum, daftarlah sebagai Developer Meta untuk mengakses fitur developer kami dan membuat aplikasi Meta.
• Jika belum, buatlah aplikasi Meta.
• Buat aplikasi uji dari aplikasi aktif/produksi dan gunakan untuk melakukan semua pengembangan dan pengujian baru.
• Aplikasi Anda (aktif/produksi dan uji) harus merupakan jenis aplikasi Bisnis dan dimiliki oleh Pengelola Bisnis yang merupakan bisnis terverifikasi. Pelajari selengkapnya tentang cara memverifikasi bisnis Anda dan cara menambahkan aplikasi Anda ke bisnis tersebut.
• Hubungi mitra Meta Anda dan bagikan ID aplikasi Anda, sehingga mereka dapat memberi Anda akses ke kemampuan manage_business_extension MBE, dan setelah disetujui, Anda dapat memulai pekerjaan penerapan.

Menyiapkan Integrasi Melalui Panel Developer

Panel Developer Meta Business Extension adalah produk di Dasbor Aplikasi Developer. Setelah aplikasi Anda diberikan kemampuan MBE, Anda harus menggunakan Panel Developer untuk menyiapkan dan memvalidasi integrasi Anda (termasuk URL Autentikasi dan endpoint Webhook).

Langkah 1: Tambahkan Panel Developer MBE ke Aplikasi Developer Facebook Anda.

Langkah 2: Pada tab Pengaturan, pilih Food and Drink sebagai satu-satunya vertikal Anda, pilih Instagram Call to Action Button dan Page Surface Call To Action Button sebagai fitur, dan sertakan semua domain yang disediakan oleh aplikasi Anda di kartu Domain Wilcard.

Langkah 3: Setelah membuat URL Autentikasi, gunakan permukaan Aplikasi Bisnis di tab Pengaturan untuk memvalidasi URL Anda (jika ada, kesalahan akan tercantum di sana). Setelah mendapatkan centang hijau, Anda dapat membuka Aplikasi Bisnis Meta untuk menguji end-to-end.

Langkah 4: Setelah membuat Webhooks, siapkan di produk Webhooks. Jika penyiapan dilakukan seperti yang diharapkan, Anda akan mendapatkan centang hijau pada tab Ringkasan untuk item yang Divalidasi Webhook.

Langkah 5: Setelah memicu peristiwa pixel yang diperlukan, selesaikan Kuisioner Pixel (termasuk video untuk memvalidasi penerapan pixel Anda).

Langkah 6: Bantu tim kami memverifikasi dan menyetujui integrasi Anda dengan memberikan perincian di kartu Tinjauan Integrasi pada tab Tinjauan Integrasi. Tindakan ini harus menyertakan kredensial login platform Anda untuk login ke URL Autentikasi Anda. Tambahkan tautan screencast yang menunjukkan pengalaman onboarding end-to-end dan fitur yang Anda aktifkan.

Langkah 7: Setelah Anda menyelesaikan penerapan MBE, selesaikan daftar tugas di tab Ringkasan di Panel Developer. Isi formulir untuk detail aplikasi dan tinjauan integrasi di tab Tinjauan Integrasi. Jika tombol kirim diklik, proses tinjauan akan dimulai. Setelah integrasi disetujui, Anda dapat meluncurkan aplikasi Anda ke pengguna publik melalui tab Peluncuran. Pelajari selengkapnya tentang proses Tinjauan Integrasi dan cara mendapat masukan dan status saat ini dari tim kami

Membuat URL Autentikasi

Aplikasi Bisnis, yang tersedia di semua permukaan Meta, adalah tempat bagi bisnis kecil untuk menemukan dan terhubung ke aplikasi bisnis pihak ketiga, agar dapat dengan mudah menyiapkan fitur bisnis berbiaya teknologi yang rendah guna mengembangkan dan mencapai tujuan bisnis mereka.

MBE, v2 menggunakan URL Autentikasi sebagai saluran tepercaya untuk berbagi konfigurasi bisnis pengguna (nama, URL untuk CTA, dll.) antara platform Anda dan Instagram/Facebook.

URL Autentikasi Anda perlu menerima satu redirect_uri parameter kueri GET, dan dengan URL ini, kami sarankan agar Anda:

1. Mengizinkan pengguna Anda untuk login ke platform, dan memberikan opsi untuk mendaftarkan akun baru di platform Anda (yaitu "daftar").
2. Jika Anda mendukung beberapa bisnis per akun di platform Anda, menampilkan UI kepada pengguna untuk memilih bisnis mana di platform Anda yang ingin mereka kaitkan dengan eksistensi Facebook mereka.
3. Mendapatkan parameter kueri redirect_uri yang diterima dan menambahkannya ke objek extras yang dienkode sebagai parameter kueri.
4. Mengalihkan pengguna ke URL yang dihasilkan (hanya jika redirect_uri yang diterima sesuai dengan ekspresi reguler kami).

Contoh — Gunakan objek extras untuk mengonfigurasi bisnis dan mengaktifkan CTA profil Instagram dan CTA Halaman Facebooknya

{
  "setup": {
    "external_business_id": "<YOUR_ID_FOR_THE_BUSINESS>", //e.g. "foo-123"
    "timezone": "<BUSINESS_TIMEZONE>", //e.g. "America/Los_Angeles"
    "currency": "<BUSINESS_CURRENCY>", //e.g. "USD"
    "business_vertical": "FOOD_AND_DRINK"
  },
  "business_config": {
    "business": {
      "name": "<BUSINESS_NAME>"  //e.g. "Foo Business"
    },
    "ig_cta": {
      "enabled": true,
      "cta_button_text": "Order Food",
      "cta_button_url": "<BUSINESS_URL_FOR_CTA>"  //e.g. "https://partner-site.com/foo-business/order"
    },
     "page_cta": {
         "enabled": true,
         "cta_button_text": "Order Food",
         "cta_button_url": "<BUSINESS_URL_FOR_CTA>", // e.g. "https://partner-site.com/foo-business/order"
         "below_button_text": "Powered by <YOU>"
     }
  },
  "repeat": false 
}

Untuk detail tentang penerapan dan pengujian lengkap, lihat Aplikasi Bisnis.

Membuat Webhooks

Setelah pengguna menginstal, memperbarui, atau menghapus penginstalan aplikasi Anda melalui Aplikasi Bisnis, Anda akan mendapatkan detail tentang tindakan tersebut melalui Webhooks.

Untuk menyiapkan Webhooks, Anda harus:

1. Membuat endpoint di server aman yang dapat memproses permintaan POST dari Facebook.
2. Mengonfigurasi produk Webhooks di Dasbor Aplikasi milik aplikasi Anda untuk berlangganan ke kolom fbe_install objek User.

Untuk detail tentang penerapan dan pengujian lengkap, lihat Webhooks.

Memicu Peristiwa Pixel

Meta Pixel adalah bagian integral dari Meta Business Extension, v2. Kami mewajibkan Anda untuk secara akurat memicu pixel peristiwa standar berikut untuk setiap bisnis yang terintegrasi dengan MBE di platform Anda.

Peristiwa Wajib

• Untuk semua halaman yang terlibat dalam proses pemesanan makanan: Picu PageView
• Setelah pemesanan dilakukan: Picu Purchase

Peristiwa Opsional

• Picu AddToCart saat item ditambahkan ke pesanan.

Semua peristiwa standar dapat dipicu dengan memanggil fungsi fbq('track') pixel, dengan nama peristiwa dan (opsional) objek JSON sebagai parameternya. Misalnya, peristiwa pembelian harus menyertakan mata uang dan nilai sebagai parameter:

fbq('track', 'Purchase', {currency: "USD", value: 30.00});

Untuk detail tentang penerapan lengkap, lihat Memicu Peristiwa Pixel.

Pixel Helper

Kami sangat menyarankan agar Anda menginstal ekstensi Chrome kami, Pixel Helper. Pixel Helper memberikan masukan yang sangat berharga yang dapat membantu Anda memverifikasi bahwa pixel Anda berfungsi dengan benar, terutama ketika Anda mulai melacak konversi, tempat Anda dapat dengan mudah menjumpai kesalahan format.

Tinjauan dan Peluncuran Integrasi

Setelah Anda menyelesaikan penerapan MBE, selesaikan daftar tugas di tab Ringkasan di Panel Developer. Isi formulir untuk detail aplikasi dan tinjauan integrasi di tab Tinjauan Integrasi. Jika tombol kirim diklik, proses tinjauan akan dimulai.

Tinjauan Integrasi adalah proses di mana Meta memverifikasi integrasi Meta Business Extension Anda. Setelah integrasi disetujui, Anda dapat meluncurkan aplikasi Anda ke pengguna publik di tab Peluncuran. Pelajari selengkapnya tentang proses ini.

Setelah mengajukan integrasi Anda di tab Tinjauan Integrasi di Panel Developer, Anda dapat melihat status, pembaruan, dan masukan dari peninjau kami di bagian riwayat pengajuan di kartu Tinjauan integrasi.

Peninjau kami akan memberikan masukan yang terperinci. Jika aplikasi Anda ditolak, selesaikan semua langkah yang diperlukan sebelum memulai proses tinjauan baru. Anda dapat melakukan ini dengan mengklik tombol kirim ulang di tab Tinjauan Integrasi.