Otorisasi
Proses otorisasi memverifikasi pengguna dan aplikasi yang akan mengakses Marketing API dan memberikan izin kepada mereka.
Peran Aplikasi
Di dasbor aplikasi, Anda dapat menetapkan peran untuk diri sendiri atau anggota tim jika diperlukan: Admin, Developer, Penguji.
Catatan: Tergantung pada kasus penggunaan yang Anda maksud, Anda mungkin harus mengirimkan aplikasi Anda untuk ditinjau guna mendapatkan akses ke izin khusus yang terkait dengan pengelolaan iklan.
Level Akses, Izin, dan Fitur
Aplikasi bisnis tunduk pada layer tambahan otorisasi Graph API yang disebut sebagai level akses. Selama Tinjauan Aplikasi, aplikasi Anda juga harus meminta izin dan fitur tertentu.
Setiap level memiliki batasan, lihat Level Akses dan Fitur untuk informasi selengkapnya. Semua developer juga harus mengikuti semua Ketentuan Platform dan Kebijakan Developer Meta. Panggilan pada level akses APA PUN bertentangan dengan data produksi.
Level akses fitur
| Level Akses Fitur | Deskripsi |
|---|---|
Aplikasi bisnis secara otomatis disetujui untuk akses standar untuk semua izin dan fitur yang tersedia bagi jenis aplikasi Bisnis. Gunakan opsi ini jika Anda memulai. Anda dapat membangun alur kerja menyeluruh sebelum meminta izin penuh, dan Anda dapat mengakses akun iklan dalam jumlah tak terbatas. Beberapa panggilan API mungkin tidak tersedia dengan akses standar karena mungkin dimiliki oleh beberapa akun atau akun yang terpengaruh tidak dapat diidentifikasi secara terprogram. | |
Akses lanjutan harus disetujui melalui proses Tinjauan Aplikasi berdasarkan izin dan fitur individual.
Setelah Anda mengirimkan informasi, Meta merespons dengan persetujuan atau penolakan serta informasi tambahan jika aplikasi Anda tidak memenuhi syarat untuk akses standar. Jika Anda disetujui untuk akses lanjutan, Anda harus melakukan hal berikut untuk mempertahankan status Anda:
|
Untuk memeriksa level akses saat ini, buka Dasbor Aplikasi > Tinjauan Aplikasi > Izin dan Fitur.
Pemetaan Akses Marketing API vs Akses Standar Pengelolaan Iklan
| Akses Marketing API | Akses Standar Pengelolaan Iklan | Tindakan |
|---|---|---|
Akses pengembangan | Akses standar | Secara default |
Akses standar | Akses lanjutan | Terapkan di Dasbor Aplikasi |
Izin dan fitur
Izin yang harus Anda minta berubah sesuai dengan API yang ingin Anda akses.
Jika aplikasi Anda hanya mengelola akun iklan, akses standar serta izin ads_read dan ads_management sudah cukup. Jika aplikasi Anda mengelola akun iklan orang lain, Anda memerlukan akses lanjutan ads_read dan/atau izin ads_management. Lihat semua izin yang tersedia untuk aplikasi bisnis.
Fitur yang harus Anda minta berubah tergantung pada bagaimana Anda ingin menggunakan API kami. Jika Anda mengelola iklan, fitur umum yang diminta adalah Akses Standar Pengelolaan Iklan. Lihat semua fitur yang tersedia untuk aplikasi bisnis.
Untuk mendapatkan akses lanjutan dari Akses Standar Pengelolaan Iklan, aplikasi Anda harus memenuhi persyaratan ini:
- Berhasil membuat setidaknya 1.500 panggilan Marketing API dalam 15 hari terakhir.
- Sudah membuat panggilan Marketing API dengan tingkat kesalahan kurang dari 10% dalam 15 hari terakhir.
Jika Anda mengelola iklan seseorang, gunakan parameter scope untuk meminta izin ads_management atau ads_read dari mereka. Aplikasi Anda mendapat akses saat mereka mengeklik Izinkan.
https://www.facebook.com/v21.0/dialog/oauth?
client_id=<YOUR_APP_ID>
&redirect_uri=<YOUR_URL>
&scope=ads_management
Catatan: Saat memasukkan kolom YOUR_URL, tambahkan / di belakangnya (contoh, http://www.facebook.com/).
Contoh
| Kasus Penggunaan | Yang Harus Diminta |
|---|---|
Anda ingin membaca dan mengelola iklan untuk akun iklan milik Anda atau yang telah diberi akses oleh pemilik akun iklan. |
|
Anda ingin membaca laporan iklan untuk akun iklan milik Anda atau yang telah diberi akses oleh pemilik akun iklan. |
|
Anda ingin menarik laporan iklan dari set klien, dan membaca serta mengelola iklan dari set klien lainnya. |
|
Level Akses dan Fitur
Tabel di bawah menunjukkan bagaimana level akses standar dan lanjutan memengaruhi fitur Akses Standar Pengelolaan Iklan.
| Akses Standar | Advanced Access | |
|---|---|---|
Batas Akun | Mengelola akun iklan dalam jumlah yang tidak terbatas. Admin atau developer aplikasi dapat melakukan panggilan API atas nama admin akun iklan atau pengiklan. | Mengelola akun iklan dalam jumlah yang tidak terbatas, dengan asumsi Anda mendapatkan izin |
Batas Laju | Memiliki batas laju yang besar per akun iklan. Hanya untuk developer. Bukan untuk aplikasi produksi yang berjalan untuk pengiklan live. | Tarif terbatas ringan per akun iklan. |
Pengelola Bisnis | Akses terbatas ke API Pengelola Bisnis dan Katalog. Tidak ada akses Pengelola Bisnis untuk mengelola akun iklan, izin pengguna, dan Halaman. | Akses ke semua API Pengelola Bisnis dan Katalog. |
Pengguna Sistem | Dapat membuat 1 pengguna sistem dan 1 pengguna sistem admin. | Dapat membuat 10 pengguna sistem dan 1 pengguna sistem admin. |
Pembuatan Halaman | Tidak dapat membuat Halaman melalui API. | Tidak dapat membuat Halaman melalui API. |
Level Akses vs. Akses Standar Pengelolaan Iklan
Izin dan fitur untuk aplikasi memiliki dua level akses yang berbeda: akses standar dan akses lanjutan. Harap perhatikan bahwa penggunaan istilah Akses Standar di sini tidak terkait dengan fitur Akses Standar Pengelolaan Iklan. Akses lanjutan dari Akses Standar Pengelolaan Iklan masih memerlukan aplikasi untuk melewati peninjauan agar dapat mengakses fitur tersebut.
Verifikasi Bisnis
Verifikasi bisnis adalah proses yang memungkinkan kami untuk memverifikasi identitas Anda sebagai entitas bisnis, yang kami wajibkan jika aplikasi Anda akan mengakses data sensitif. Pelajari selengkapnya tentang proses Verifikasi Bisnis.