Ringkasan

Kami mendorong Anda untuk membaca panduan ini secara menyeluruh dan untuk berintegrasi dengan elemen API Perdagangan kami sebanyak mungkin; idealnya dengan semua elemen yang relevan untuk kasus penggunaan Anda.

Lingkup Peran Developer

Sebagai developer, kemungkinan besar Anda masuk ke dalam salah satu kategori ini:

Penjual: Anda adalah bagian dari perusahaan ecommerce yang memiliki stack teknis khusus sendiri, dan ingin berintegrasi dengan API Perdagangan Meta untuk mengaktifkan satu (atau beberapa) Toko agar beroperasi pada teknologi Meta.
Partner/Penyedia Teknologi: Anda adalah bagian dari perusahaan platform ecommerce, atau perusahaan yang menyediakan layanan perangkat lunak untuk bisnis ecommerce yang ada, tetapi tidak memiliki Toko sendiri (secara kolektif disebut sebagai partner atau penyedia teknologi perdagangan), dan Anda ingin berintegrasi dengan API Perdagangan Meta atas nama beberapa toko yang didukung oleh platform Anda.

Dalam kedua kategori, kualitas integrasi Anda akan memiliki dampak yang berarti ketika pelanggan Anda berinteraksi dengan produk dan Toko yang dikelola dengan API Perdagangan kami. Panduan ini secara khusus berfokus untuk membantu developer partner yang ingin:

Berintegrasi dengan API Perdagangan kami.
Mendapatkan ringkasan dan "gambaran besar" dari semua elemen yang digunakan untuk membangun integrasi berkualitas tinggi dengan API Perdagangan Meta.
Mempelajari bagaimana integrasi dapat menghasilkan hasil bisnis yang positif: menemukan pelanggan baru, menutup lebih banyak penjualan, dan berhasil memanfaatkan iklan Meta untuk mendorong hasil yang sama.

Pertimbangan Peran Pembeli

Pembeli memiliki standar yang sangat tinggi dalam hal membuat keputusan pembelian. Mereka mencari informasi yang kaya tentang produk yang dipertimbangkan akan dibeli. Mereka menginginkan promo yang bagus, dan berharap untuk menemukan diskon dan promosi yang sama di Toko seperti yang mereka temukan di situs web penjual sendiri. Mereka memerlukan info terkini tepat waktu tentang pesanan mereka dengan informasi pengiriman, pelacakan, dan retur yang akurat.

Menyediakan semua elemen ini ke Meta adalah kunci untuk meningkatkan tingkat konversi pembeli dengan Toko.

Alur Developer Level Tinggi

Di Meta, kami mengizinkan developer pihak ketiga untuk membangun sistem yang terintegrasi dengan platform Instagram dan Facebook kami melalui koleksi endpoint API Perdagangan, yang secara kolektif merupakan bagian dari Graph API. Di sini kami menjelaskan alur developer level tinggi dan komponen yang terlibat dalam membangun integrasi API Perdagangan berkualitas tinggi.

Prasyarat

Bisnis Anda harus sudah didirikan dan terverifikasi di Meta
Kontrak dagang yang diperlukan harus ditandatangani, termasuk Amandemen Penyedia Layanan Teknologi dan Ketentuan Tambahan
Anda harus familier dengan konsep Graph API, yang merupakan cara utama untuk membaca dari dan menulis data ke platform Meta commerce

Langkah 1: Buat Aplikasi Developer

Untuk membuat permintaan ke endpoint Graph API ini, Anda harus terlebih dahulu membuat aplikasi di portal Meta untuk Developer. Dalam konteks ini, aplikasi mewakili koleksi kemampuan yang aksesnya diberikan ke perangkat lunak pihak ketiga Anda di sistem Meta. Setiap panggilan API yang Anda lakukan ke sistem Meta dikaitkan dengan aplikasi ini dan kemampuan Anda menentukan panggilan API mana yang dapat diakses oleh perangkat lunak Anda. Aplikasi ini dikaitkan dengan entitas bisnis Anda di Meta. Model data Meta dirancang sedemikian rupa sehingga semua aset yang Anda buat untuk menjalankan bisnis Anda di Meta dimiliki oleh objek entitas bisnis ini. Objek entitas bisnis yang sama yang memiliki aplikasi Anda juga dapat memiliki Halaman Facebook, akun Instagram, akun iklan, dan katalog produk Anda.

Langkah 2: Buat Token Akses (Menggunakan Akun Tes)

Sebagai bagian dari proses persetujuan pra-aplikasi, Anda perlu menyediakan token akses dengan setiap panggilan saat melakukan panggilan API. Token akses ini memungkinkan aplikasi Anda mengakses platform Meta atas nama pengguna. Token akses setara dengan kode digital yang membuat pengguna tetap login ke Facebook sehingga mereka tidak perlu memasukkan kembali kata sandi setiap kali perangkat lunak pihak ketiga Anda perlu mengakses platform Meta atas nama pengguna tersebut.

Sebagai partner developer yang ingin membangun integrasi dagang tempat Anda akan mengelola beberapa toko, Anda akan diminta untuk menyimpan beberapa token akses—satu untuk setiap toko yang Anda dukung yang akan berjualan di saluran Facebook dan Instagram.

Untuk memulai, buat akun dagang tes, mengaitkan aset dan membuat token akses yang sesuai untuk digunakan dalam mengembangkan integrasi API Perdagangan.

Kami merekomendasikan penggunaan token akses yang didukung oleh pengguna sistem untuk mengakses API Perdagangan karena token akses yang diperoleh dari pengguna biasa dapat dibatalkan setelah periode tertentu, atau jika pengguna tersebut mengubah kata sandi Facebook mereka. Pengguna sistem mewakili server atau perangkat lunak yang melakukan panggilan API ke aset yang dimiliki atau dikelola oleh Pengelola Bisnis. Untuk petunjuk langkah demi langkah, lihat pengaturan integrasi API.

Langkah 3: Bangun Integrasi API Perdagangan (Menggunakan Akun Tes)

Mulai berintegrasi dengan API katalog, pengelolaan pesanan, dan promosi (promo) secara paralel menggunakan akun dagang tes yang dibuat di langkah 2: Integrasikan dengan API katalog untuk menyiapkan dan mengoperasikan katalog berkualitas tinggi dan terkini yang mendukung pengalaman pembelian dan memengaruhi keputusan pembelian. Integrasikan dengan API pengelolaan pesanan untuk mengelola siklus pesanan yang dilakukan oleh pembeli di saluran Facebook dan Instagram. Integrasikan dengan API promosi untuk menyinkronkan berbagai jenis promosi dan menangani pembelian dan pengembalian dana dengan kehadiran promosi.

Pelajari cara berintegrasi dengan API ini untuk memenuhi standar kualitas Toko kami.

Langkah 4: Ajukan Aplikasi untuk Ditinjau

Tinjauan Aplikasi merupakan bagian integral dari proses Pengembangan Aplikasi. Anda memulai tinjauan aplikasi dengan meminta izin individu dan menjelaskan bagaimana izin yang diminta akan digunakan oleh aplikasi Anda untuk memberdayakan bisnis yang Anda dukung. Proses ini memungkinkan kami untuk memverifikasi bahwa aplikasi Anda menggunakan produk dan API kami dengan cara yang disetujui. Pelajari selengkapnya tentang proses proses Tinjauan Aplikasi.

Langkah 5: Terapkan Alur untuk Onboarding Penjual ke Meta Commerce

Terapkan jalur terbaik untuk onboarding penjual Anda ke Meta Commerce. Di akhir alur ini, token akses dibuat untuk setiap penjual yang Anda dukung. Anda perlu menyimpan dan menggunakannya saat melakukan panggilan API atas nama penjual tersebut.

Pelajari petunjuk mendetail tentang cara membuat integrasi onboarding yang ideal yang memenuhi standar kualitas Toko kami.

Langkah 6: Pertajam Integrasi API Perdagangan (Menggunakan Akun Produksi)

Pertajam integrasi Anda untuk menangani berbagai skenario kasus edge dan untuk menangani kegagalan dengan baik. Pahami dan adopsi praktik terbaik integrasi yang direkomendasikan seperti yang diuraikan dalam panduan praktik terbaik. Akhirnya, uji integrasi Anda dengan pesanan sungguhan.

Standar Kualitas Integrasi

Tabel di bawah ini mencantumkan Jobs To be Done (JTBD) penjual yang dikelompokkan berdasarkan kategori yang berbeda, prioritasnya (0 adalah yang tertinggi), apakah itu spesifik Meta atau berlaku untuk saluran lain, persyaratan standar kualitas integrasi Meta Commerce yang terkait, dan potensi peningkatan.

Kategori	Jobs To Be Done (JTBD) Penjual	Prioritas	Multisaluran / Spesifik Meta	Standar Kualitas: Persyaratan Minimal	Standar Kualitas: Penyempurnaan
Onboarding dan Kelola Toko	Onboarding ke Toko	0	Spesifik Meta	Pihak ketiga harus menggunakan FBE.
	Melihat dan menyelesaikan masalah dengan Toko (termasuk masalah BI)	0
	Melihat insight dan rekomendasi untuk Toko	1	Spesifik Meta	Tidak Ada
	Menyesuaikan tampilan dan nuansa Toko	2	Spesifik Meta	Tidak Ada
	Menanggapi/berkomunikasi dengan pembeli di Meta	0	Keduanya (banyak penjual lebih suka menggunakan Messenger/DM Instagram/WhatsApp untuk menanggapi pelanggan, sementara yang lain akan bergantung pada fitur pihak ketiga untuk komunikasi pelanggan)	Tidak Ada
Mengelola Katalog	Menambahkan / menghapus / mengedit produk untuk mempertahankan katalog yang kaya dan terbaru	0	Multisaluran	Pihak ketiga harus menyinkronkan katalog produk ke Meta dan menangani kesalahan. Gunakan mekanisme sinkronisasi yang dapat diskalakan untuk kolom yang tidak berubah-ubah (sinkronisasi katalog lengkap setiap 24 jam dan sinkronisasi delta setiap 1 jam). Sinkronisasi pembaruan kolom volatilitas tinggi (stok dan harga) hampir secara realtime (minimal setiap 15 menit)	Pihak ketiga harus menyinkronkan koleksi set produk ke Meta
	Melihat dan menyelesaikan masalah produk khusus untuk Meta (misalnya: bendera BI)	0	Multisaluran (meskipun resolusi masalah sebenarnya bisa di permukaan Meta, seperti banding BI)	Pihak ketiga harus membuat diagnosis permukaan dengan Ajakan Bertindak (CTA) yang jelas untuk penjual
	Meninjau dan menggunakan Konten Komunitas (UGC)	1	Spesifik Meta	Tidak Ada
Merchandise / Menjalankan Iklan Toko	Menjalankan Iklan Toko	0	Spesifik Meta	Pihak ketiga harus menyiapkan penjual dan mengirim kembali sinyal iklan melalui Pixel	Pihak ketiga harus menyiapkan penjual dan mengirim kembali sinyal iklan melalui CAPI
	Melihat kinerja dan analitik (iklan)	0	Multisaluran	Tidak Ada
	Melihat kinerja dan analitik (penjualan organik)	1	Keduanya (sementara ada fitur yang dapat menggabungkan metrik level tinggi, metrik penjualan organik yang lebih dalam kami sediakan melalui CM hari ini)	Tidak Ada
	Menjalankan promosi (promo)	0	Multisaluran	Pihak ketiga harus memproses pesanan (pemenuhan, pembatalan, pengembalian dana) dengan diskon terkait yang didanai Meta dan diskon standar yang didanai Penjual berikut ini: Diskon yang dialokasikan untuk masing-masing item dalam pesanan Diskon yang dialokasikan di seluruh item dalam pesanan (mungkin dengan sisanya) Diskon pengiriman gratis, diskon gaya Beli X Dapat Y Jika (If): Pihak ketiga adalah sumber kebenaran untuk diskon: pihak ketiga harus menyinkronkan diskon standar ke Meta menggunakan API Promo (saat ini merupakan kemampuan gate) Lainnya (Else): Pihak ketiga harus memunculkan tautan pengalihan Commerce Manager ke penjual untuk menyinkronkan semua diskon standar ke Meta
	Menjalankan Peluncuran Produk Instagram	2	Spesifik Meta	Tidak Ada
	Menjalankan acara Belanja Siaran Langsung Instagram	2	Spesifik Meta	Tidak Ada
	Membuat postingan organik yang ditandai produk	2	Spesifik Meta	Tidak Ada
Pembayaran Terkelola	Mengelola detail pembayaran untuk proses pembayaran di tempat	0	Spesifik Meta	Pihak ketiga harus menggunakan FBE.
	Mendapatkan bayaran/memproses pembayaran pengembalian dana	0	Multisaluran		Pihak ketiga harus mengekspos laporan keuangan yang diperoleh dari Meta
	Mendapatkan bayaran/memproses pembayaran pengembalian dana	0	Multisaluran
	Menangani pengembalian uang	0	Keduanya
	Membuat laporan pajak dan rekonsiliasi penjualan	0	Multisaluran
Memproses dan Memenuhi Pesanan	Mengelola pesanan saat pesanan masuk	0	Multisaluran	Pihak ketiga harus menerima dan menanggapi pesanan dari Meta ke OMS
	Memenuhi pesanan	0	Multisaluran	Pihak ketiga harus menyinkronkan status pesanan (memenuhi, membatalkan, mengembalikan uang) dari OMS ke Meta
	Menangani retur dan pengembalian dana yang diinisiasi oleh pembeli dan penjual	0	Multisaluran	Pihak ketiga harus menyinkronkan status pesanan (memenuhi, membatalkan, mengembalikan uang) dari OMS ke Meta	Pihak ketiga harus memproses retur yang diinisiasi oleh pembeli melalui Meta