Otorisasi

Untuk mengakses endpoint Marketing API, aplikasi Anda harus menghapus beberapa layer 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 mendaftarkan aplikasi, Anda dapat menetapkan peran kepada siapa pun dengan akun developer yang akan membantu Anda dalam pengembangan.

Layer 2: Level Akses, Izin, dan Fitur

Aplikasi bisnis tunduk pada layer tambahan otorisasi Graph API yang disebut level akses. Selama Tinjauan Aplikasi, aplikasi Anda juga harus meminta izin dan fitur tertentu.

Tingkat Akses Fitur

Tingkat Akses Fitur	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.
Akses Lanjutan	Akses Lanjutan harus disetujui melalui proses Tinjauan Aplikasi berdasarkan Izin dan Fitur individual. Untuk meminta Akses Lanjutan, 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 akses lanjutan. Anda dapat memilih satu atau beberapa fitur. Setelah memilih opsi Anda, klik Lanjutkan Permintaan dan Anda akan dibawa ke layar yang memandu Anda melalui proses pengajuan. Setelah Anda mengirimkan informasi, Facebook akan menanggapi dengan persetujuan atau penolakan dan memberikan informasi jika aplikasi Anda tidak memenuhi syarat untuk akses standar. Jika Anda disetujui untuk Akses Lanjutan, 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.

Akses Lanjutan

Akses Lanjutan harus disetujui melalui proses Tinjauan Aplikasi berdasarkan Izin dan Fitur individual.

Untuk meminta Akses Lanjutan, 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 akses lanjutan. Anda dapat memilih satu atau beberapa fitur. Setelah memilih opsi Anda, klik Lanjutkan Permintaan dan Anda akan dibawa ke layar yang memandu Anda melalui proses pengajuan.

Setelah Anda mengirimkan informasi, Facebook akan menanggapi dengan persetujuan atau penolakan dan memberikan informasi jika aplikasi Anda tidak memenuhi syarat untuk akses standar.

Jika Anda disetujui untuk Akses Lanjutan, 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 akan berdampak data produksi.

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

Pemetaan Akses Ads API vs Akses Standar Pengelolaan Iklan

Akses Marketing API	Akses Standar Pengelolaan Iklan	Tindakan
Akses pengembangan	Akses standar	Secara Default
Akses standar	Akses lanjutan	Perlu mengajukan di Dasbor Aplikasi

Izin dan Fitur

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

Jika aplikasi Anda hanya mengelola akun iklan, izin Akses Standar serta ads_read dan ads_management sudah cukup. Jika aplikasi Anda mengelola akun iklan orang lain, Anda memerlukan izin Akses Lanjutan ads_read dan/atau 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 Akses Lanjutan dari Akses Standar Pengelolaan Iklan, aplikasi Anda harus memenuhi persyaratan:

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.

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/v21.0/dialog/oauth?
  client_id=<YOUR_APP_ID>
  &redirect_uri=<YOUR_URL>
  &scope=ads_management

Saat mengisi 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 diberikan aksesnya oleh pemilik akun iklan.	Izin: `ads_management` Fitur: `Ads Management Standard Access`
Anda ingin membaca laporan iklan untuk akun iklan yang Anda miliki atau yang telah diberikan aksesnya 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 akses Lanjutan memengaruhi fitur Akses Standar Pengelolaan Iklan.

	Akses Standar	Akses Lanjutan
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 pembatasan laju yang ketat per akun iklan. Hanya untuk developer. Bukan untuk aplikasi produksi yang berjalan untuk pengiklan yang aktif.	Memiliki pembatasan laju yang longgar per akun iklan.
Pengelola Bisnis	Akses terbatas 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 Akses Lanjutan. Harap diperhatikan bahwa penggunaan istilah "Akses Standar" di sini tidak terkait dengan fitur Akses Standar Pengelolaan Iklan. Akses Lanjutan dari Akses Standar Pengelolaan Iklan masih mewajibkan aplikasi untuk melewati peninjauan agar dapat mengakses fitur tersebut.

Lapisan 3: 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 proses Verifikasi Bisnis selengkapnya.