Otorisasi

Untuk mengakses endpoint Marketing API, aplikasi Anda harus menghapus beberapa lapisan otorisasi Graph API.

Layer 1: Jenis Aplikasi

Saat Anda membuat aplikasi Facebook, Anda akan ditanya bagaimana aplikasi itu akan digunakan. Pilihan Anda akan menentukan jenis aplikasi: Bisnis, Gaming, atau Tidak Ada. Lihat Jenis Aplikasi.

Untuk mengakses endpoint Marketing API, Anda perlu membuat aplikasi Bisnis. Lihat Produk yang Tersedia untuk Aplikasi Bisnis.

Setelah Anda mendaftarkan aplikasi, Anda dapat menetapkan peran kepada seseorang dengan akun developer yang akan membantu Anda terkait pengembangan.

Layer 2: 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 khusus.

Level Akses

Level Akses	Deskripsi
Akses Standar	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 membuat alur kerja ujung ke ujung sebelum meminta izin penuh. Anda dapat mengakses akun iklan dalam jumlah yang tidak terbatas. Beberapa panggilan API mungkin tidak tersedia dengan Akses Standar karena mungkin dimiliki oleh beberapa akun, atau akun yang terkena dampak tidak dapat diidentifikasi secara terprogram.
Advanced Access	Advanced Access harus disetujui melalui proses Tinjauan Aplikasi berdasarkan Izin dan Fitur individual. Untuk meminta Advanced Access, buka Dasbor aplikasi Anda dan klik Tinjauan Aplikasi > Izin dan Fitur. Temukan izin dan fitur yang ingin Anda akses, dan di bawah Tindakan, klik Meminta advanced access. Anda dapat memilih satu atau beberapa fitur. Setelah memilih opsi Anda, klik Lanjutkan Permintaan dan Anda dibawa ke layar yang memandu Anda melalui proses pengajuan. Setelah Anda mengirimkan informasi Anda, Facebook akan menyetujui atau menolaknya, dan memberikan informasi jika aplikasi Anda tidak memenuhi syarat untuk akses standar. Jika Anda disetujui untuk Advanced Access, Anda harus menyelesaikan hal berikut untuk mempertahankan status Anda: Berhasil membuat setidaknya 1500 panggilan Marketing API dalam 15 hari terakhir. Sudah membuat panggilan Marketing API dengan rasio kesalahan kurang dari 10% dalam 15 hari terakhir.

Deskripsi

Akses Standar

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 membuat alur kerja ujung ke ujung sebelum meminta izin penuh. Anda dapat mengakses akun iklan dalam jumlah yang tidak terbatas.

Beberapa panggilan API mungkin tidak tersedia dengan Akses Standar karena mungkin dimiliki oleh beberapa akun, atau akun yang terkena dampak tidak dapat diidentifikasi secara terprogram.

Advanced Access

Advanced Access harus disetujui melalui proses Tinjauan Aplikasi berdasarkan Izin dan Fitur individual.

Untuk meminta Advanced Access, buka Dasbor aplikasi Anda dan klik Tinjauan Aplikasi > Izin dan Fitur.

Temukan izin dan fitur yang ingin Anda akses, dan di bawah Tindakan, klik Meminta advanced access. Anda dapat memilih satu atau beberapa fitur. Setelah memilih opsi Anda, klik Lanjutkan Permintaan dan Anda dibawa ke layar yang memandu Anda melalui proses pengajuan.

Setelah Anda mengirimkan informasi Anda, Facebook akan menyetujui atau menolaknya, dan memberikan informasi jika aplikasi Anda tidak memenuhi syarat untuk akses standar.

Jika Anda disetujui untuk Advanced Access, Anda harus menyelesaikan hal berikut untuk mempertahankan status Anda:

Berhasil membuat setidaknya 1500 panggilan Marketing API dalam 15 hari terakhir.
Sudah membuat panggilan Marketing API dengan rasio kesalahan kurang dari 10% dalam 15 hari terakhir.

Setiap level memiliki batasan, lihat Level Akses dan Fitur. Semua developer juga harus mengikuti semua Ketentuan Platform Facebook dan Kebijakan Developer. Panggilan pada level akses APA PUN melanggar data produksi.

Untuk memeriksa level akses saat ini, buka Dasbor Aplikasi > Tinjauan Aplikasi > Izin dan Fitur.

Izin dan Fitur

Izin yang harus Anda minta berubah sesuai API yang ingin Anda akses.

Jika aplikasi Anda hanya mengelola akun iklan, Akses Standar serta izin ads_read dan ads_management mencukupi. Jika aplikasi Anda mengelola akun iklan orang lain, Anda memerlukan Advanced Access ads_read dan/atau izin ads_management. Lihat semua izin yang tersedia untuk aplikasi bisnis.

Fitur yang harus Anda minta berubah tergantung bagaimana Anda ingin menggunakan API kami. Jika Anda mengelola iklan, fitur umum yang harus diminta adalah Ads Management Standard Access. Lihat semua fitur yang tersedia untuk aplikasi bisnis.

Untuk mendapatkan Advanced Access dari Akses Standar Pengelolaan Iklan, aplikasi Anda harus memenuhi persyaratan:

Berhasil membuat setidaknya 1.500 panggilan Marketing API dalam 15 hari terakhir.
Sudah membuat panggilan Marketing API dengan rasio 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 seseorang. Aplikasi Anda mendapat akses saat seseorang mengeklik Izinkan:

https://www.facebook.com/v19.0/dialog/oauth?
  client_id=<YOUR_APP_ID>
  &redirect_uri=<YOUR_URL>
  &scope=ads_management

Saat memasukkan kolom YOUR_URL, beri / tambahan. 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.	Izin: `ads_management` Fitur: `Ads Management Standard Access`
Anda ingin membaca laporan iklan untuk akun iklan yang Anda miliki atau telah diberi akses oleh pemilik akun iklan.	Izin: `ads_read` Fitur: `Ads Management Standard Access`
Anda ingin menarik laporan iklan dari set klien, dan membaca serta mengelola iklan dari set klien lainnya.	Izin: `ads_management` dan `ads_read` Fitur: `Ads Management Standard Access`

Level Akses dan Fitur

Tabel di bawah menunjukkan bagaimana level akses Standar dan Advanced Access 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 `ads_read` atau `ads_management` dari akun iklan.
Batas Laju	Memiliki batas laju yang besar per akun iklan. Hanya untuk developer. Bukan untuk aplikasi produksi yang berjalan untuk pengiklan tayang.	Berbatas laju kategori ringan per akun iklan.
Pengelola Bisnis	Akses dibatasi ke API Pengelola Bisnis dan Katalog Produk. Tidak ada akses Pengelola Bisnis untuk mengelola akun iklan, izin pengguna, dan Halaman.	Akses ke semua API Pengelola Bisnis dan Katalog Produk.
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 Advanced Access. Harap diperhatikan bahwa penggunaan istilah "Akses Standar" di sini tidak terkait dengan fitur Akses Standar Manajemen Iklan. Advanced Access dari Akses Standar Pengelolaan Iklan masih membutuhkan aplikasi untuk melewati peninjauan agar dapat mengakses fitur tersebut.

Layer 3: Verifikasi Bisnis

Verifikasi bisnis adalah proses yang memungkinkan kami memverifikasi identitas Anda sebagai entitas bisnis, yang kami wajibkan jika aplikasi Anda akan mengakses data sensitif. Pelajari selengkapnya tentang proses Verifikasi Bisnis.