Menyiapkan Pengelola Bisnis Turunan Baru

Solusi Pengelola Bisnis 2 tingkat awalnya dirancang agar setiap token akses pengguna hanya dapat membuat satu Pengelola Bisnis turunan. Namun, sekarang pengguna dapat membuat beberapa Pengelola Bisnis turunan selama ada halaman utama yang diatur pada setiap Pengelola Bisnis turunan.

Catatan: Bergantung pada apakah appsecret_proof diaktifkan di pengaturan aplikasi Anda, appsecret_proof mungkin diperlukan sebagai parameter untuk setiap panggilan yang Anda buat. Lihat dokumen Mengamankan Permintaan Graph API untuk mengetahui cara mengatur opsi ini dan cara membuat appsecret_proof.

Memulai

Sebelum memulai, kami sarankan Anda untuk meninjau persyaratan dan informasi ini:

Izin Aplikasi

  • business_management
  • ads_management

ID

  • PARENT_BM_ID: ID Pengelola Bisnis dari mitra yang memiliki aplikasi.
  • CHILD_BM_ID: ID Pengelola Bisnis yang dibuat oleh PB Induk untuk klien.

Token Akses

  • USER_Personal_Access_Token: Token akses dari orang yang memberikan kredensial untuk membuat PB Turunan.
    • Token ini dibuat menggunakan Login Facebook.
    • Mitra harus meminta cakupan business_management global pada bisnis dan Halaman pengguna, bukan cakupan granular.
    • Orang ini harus memiliki hak akses Admin pada Halaman yang dibagikan ke PB Turunan.
    • Jika Halaman dimiliki oleh PB lain, orang tersebut harus memiliki hak akses Admin pada PB yang memiliki Halaman tersebut.
    • Token ini digunakan untuk mengesahkan pembuatan PB Turunan dan membagikan Halaman ke dalam PB Turunan untuk pengiklanan.
  • PARENT_BM_ADMIN_SYSTEM_USER_ACCESS_TOKEN: Token akses Pengguna Sistem Admin di Pengelola Bisnis Induk.
    • Token ini digunakan untuk membuat dan mengelola PB Turunan.
  • CHILD_BM_SYSTEM_USER_ACCESS_TOKEN: Token akses Pengguna Sistem Admin yang dibuat di PB Turunan.
    • Token ini digunakan untuk membuat dan mengelola Kampanye dan aktivitas lainnya di PB Turunan.

Membuat Pengelola Bisnis Turunan

Dengan menggunakan USER_Personal_Access_Token, buatlah Pengelola Bisnis Turunan.

Contoh — Mengembalikan ID Pengelola Bisnis Turunan

curl \
  -F 'id=<Parent_Business_Manager_ID>' \
  -F 'name=Advertisers child BM (recommend naming similar to page)' \
  -F 'vertical=OTHER' \ // Specify the Business vertical
  -F 'shared_page_id=<PAGE_ID_FROM_USER>' \  //Optional parameter but needed if you want to publish ads promoting this page
                                             //Note: the user must be an admin of the BM that owns this page if this page is owned
  -F 'page_permitted_tasks=["ADVERTISE", "ANALYZE"]' \
  -F 'timezone_id=1' \
  -F 'access_token=<USER_Personal_Access_Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<PARENT_BM_Id>/owned_businesses

Tanggapan:

{
    “ID” : “12312812123132”  //store this child business manager ID and associate to user
}

Membuat Beberapa Pengelola Bisnis Turunan per Pengguna

Jika pengguna ingin membuat beberapa Pengelola Bisnis Turunan menggunakan kredensial pengguna yang sama, primary_page harus ditetapkan pada Pengelola Bisnis Turunan yang sudah ada yang dibuat untuk pengguna tersebut. Buat panggilan POST lain untuk mengatur primary_page pada Pengelola Bisnis Turunan yang sudah ada:

curl \
  -F 'primary_page=<PAGE_ID>' \
  -F 'access_token=<USER_Personal_Access_Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<BM_ID>

Saat membuat Pengelola Bisnis turunan lain:

  • Semua Pengelola Bisnis Turunan yang ada harus memiliki primary_page yang unik.
  • shared_page_id harus ditetapkan pada Pengelola Bisnis Turunan yang baru.
  • Jika shared_page_id digunakan untuk membuat Pengelola Bisnis Turunan baru, maka tidak dapat menjadi primary_page pada Pengelola Bisnis Turunan yang sudah ada.

Menyiapkan Metode Pembayaran

Untuk membayar iklan PB Turunan, Anda harus membagikan lini kredit Anda kepada setiap PB Turunan.


Langkah 1. Buka lini kredit. Hubungi perwakilan Facebook Anda dan buka LOC di dalam Pengelola Bisnis tersebut jika belum ada. Lini kredit akan ditampilkan sebagai metode pembayaran di Pengelola Bisnis Induk Anda.

Langkah 2. Terima Ketentuan Hukum Lini Kredit.

  1. Buka Pengelola Bisnis > Pengaturan Bisnis > Metode Pembayaran.
  2. Klik Pengaturan Kredit dan klik Ketentuan Hukum. Setujui ketentuan hukum tersebut.

Langkah 3. Ambil ID lini kredit dan bagikan dengan Pengelola Bisnis turunan

  1. Buka Pengelola Bisnis Induk dan Pengaturan Bisnis > Metode Pembayaran. klik Metode pembayaran. Simpan PARENT_BM_Line_Of_Credit_ID dari URL. URL tersebut seperti berikut ini:
    https://business.facebook.com/settings/payment-methods/<PARENT_BM_Line_Of_Credit_ID>?business_id=<BUSINESS_ID>
  2. Gunakan ID lini kredit Pengelola Bisnis Induk ini dalam panggilan API di bawah ini untuk membagikan ID lini kredit dari Induk ke Pengelola Bisnis Turunan. amount bersifat opsional.
    curl \
      -F 'receiving_business_id=<CHILD_BUSINESS_MANAGER_ID>' \
      -F 'amount=<OPTIONAL_PARAMETER>' \  
      -F 'access_token=<Parent_BM_Admin_System_User_Access_Token>' \
      -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
      https://graph.facebook.com/<API_VERSION>/<PARENT_BM_Line_Of_Credit_ID>/owning_credit_allocation_configs

Jika Anda tidak menentukan jumlah, lini kredit Anda dibagi secara merata di antara semua Pengelola Bisnis Turunan Anda.

Jika Anda hanya menentukan jumlah, bagian tersebut dari lini kredit Anda akan ditetapkan ke Pengelola Bisnis Turunan.


Mendapatkan Token Pengguna Sistem Turunan

Di bawah Pengelola Bisnis Turunan, gunakan panggilan API ini untuk membuat pengguna sistem dan mengambil token akses. Token ini digunakan untuk semua panggilan berikutnya ke Pengelola Bisnis Turunan untuk pembuatan atau pengelolaan iklan pengguna ini.

curl \
  -F 'id=<CHILD_BUSINESS_MANAGER>' \
  -F 'app_id=<App_ID>' \
  -F 'scope=ads_management,business_management' \
  -F 'access_token=<Parent BM Admin System User Access Token>' \
  -F 'appsecret_proof=<APP_SECRET>' \
  https://graph.facebook.com/<API_VERSION>/<CHILD_BUSINESS_MANAGER_ID>/access_token

Mengambil ID Pengguna Sistem

Setelah mendapatkan token akses, Anda dapat menggunakannya untuk mencari tahu ID pengguna lingkup aplikasi. Ini harus dicatat untuk penyimpanan nanti.

curl -G \
  -d 'access_token=<Child BM System User Access Token>' \
  -d 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<CHILD_BM_ID>/system_users

Mendapatkan ID Sumber Dana (LOC)

  1. Ambil sumber dana baru di Pengelola Bisnis Turunan. Untuk contoh ini, gunakan sumber dana ini nanti saat membuat akun iklan.
  2. curl -G \
      -d 'fields=id,max_balance' \
      -d 'access_token=<Child BM Admin System User Access Token>' \
      -d 'appsecret_proof=<APP_SECRET_PROOF>' \   // Optional, depending on your app's security settings
      https://graph.facebook.com/<API_VERSION>/<CHILD_BUSINESS_MANAGER_ID>/extendedcredits
    Atau, Anda dapat mengambil sumber dana dengan membuka Pengelola Bisnis Turunan dan memilih Pembayaran > klik metode Pembayaran Lini Kredit. Ini akan mengisi URL dengan parameter pembayaran sebagai berikut:
    payment-methods/<CHILD_PAYMENT_METHOD_ID>?business_id=
  3. Simpan ID metode pembayaran ini untuk digunakan nanti.

Membuat Akun Iklan Baru dengan Sumber Dana Default

Gunakan ID metode pembayaran dari Pengelola Bisnis Turunan sebagai parameter funding_id.

funding_id tidak dapat diperbarui setelah akun iklan dibuat.

curl \
  -F 'name=Advertisers Ad Account' \
  -F 'currency=USD' \
  -F 'timezone_id=1' \
  -F 'end_advertiser=<PAGE_ID>' \
  -F 'media_agency=NONE' \
  -F 'partner=NONE' \
  -F 'funding_id=<PAYMENT_METHOD_ID(from above)>' \
  -F 'access_token=<Child BM Admin System User Access Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/CHILD_BM_ID/adaccount

Menambahkan Pengguna Sistem sebagai Admin ke Akun Iklan Baru

Tambahkan pengguna sistem sebagai admin ke akun iklan baru di bawah Pengelola Bisnis Turunan:

curl \
  -F 'user=<SYSTEM_USER_ID(from above)>' \
  -F 'tasks=MANAGE,ADVERTISE,ANALYZE' \
  -F 'business=<CHILD_BM_ID>' \
  -F 'access_token=<Child BM Admin System User Access Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \   // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<act_ACCOUNT_ID>/assigned_users

Selamat! Ini adalah langkah terakhir dalam menyiapkan Pengelola Bisnis Turunan untuk membuat dan mengelola kampanye klien Anda.

Mencari Pengelola Bisnis Turunan

Untuk mencari semua ID Pengelola Bisnis Turunan, jalankan perintah berikut untuk memfilter berdasarkan ID pengguna lingkup aplikasi klien:

curl -i -X GET \
  -F 'access_token=<PARENT_BM_ADMIN_SYSTEM_USER_ACCESS_TOKEN>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
"https://graph.facebook.com/<API_VERSION>/<parent_bm_id>/owned_businesses?client_user_id=<Client’s app scoped user ID>

Cari ID pengguna lingkup aplikasi dengan /me?fields=ids_for_apps (token akses pengguna klien).

Langkah Berikutnya

Topik berikutnya mencakup fitur/tindakan tambahan yang dapat digunakan untuk meningkatkan pengalaman Pengelola Bisnis Anda.

Selain itu, buka panduan membagikan aset untuk mengakses aset klien ke Pengelola Bisnis turunan: