Panduan menghubungkan akun iklan Meta
Cara membuat Meta App, System User, dan token milik Anda sendiri, lalu menempelkannya ke ProfitScope. Sekali jalan biasanya 30 sampai 60 menit.
Sebelum mulai
- Pakai akun Facebook yang menjadi admin di business portfolio (dulu disebut Business Manager) yang memegang akun iklan Anda.
- Akun iklan yang mau dihubungkan harus berada di portfolio itu. Kalau belum, lihat pertanyaan tentang akun iklan pribadi di bagian bawah.
- Daftar dulu sebagai developer di developers.facebook.com kalau belum pernah.
- Tidak mau membuat app? ProfitScope tetap bisa dipakai dengan mengunggah CSV dari Ads Manager. Aksi iklan dan sync otomatis hanya tersedia lewat koneksi ini.
Nama menu di Meta bisa sedikit berbeda, apalagi kalau tampilan Anda berbahasa Indonesia, dan Meta sesekali mengubahnya.
Tahap 1: Buat Meta App
- Buka halaman pembuatan app, atau klik Create app di daftar app Anda.
- App details: isi nama app, misalnya "ProfitScope Saya", dan email kontak Anda, lalu klik Next. Hindari kata "Meta", "Facebook", atau "Instagram" pada nama.
- Use cases: pilih Create & manage ads with Marketing API, lalu klik Next. Periksa dulu sebelum lanjut, karena use case tidak bisa dihapus setelah app dibuat.
- Pada Business: pilih portfolio yang memegang akun iklan Anda, lalu klik Next. Jangan pilih "I don't want to connect a business portfolio yet", karena System User harus berada di bisnis yang sama dengan app.
- Requirements: baca saja, lalu klik Next. Jangan mengajukan App Review.
- Overview: periksa isinya, lalu klik Go to dashboard atau Create app. Meta mungkin meminta password Facebook Anda.
Tahap 2: Buat System User
System User adalah akun khusus untuk mesin, jadi akses tidak tergantung akun pribadi Anda.
- Buka Pengaturan Bisnis, lalu pilih portfolio yang sama dengan Tahap 1.
- Buka Users → System Users, lalu klik Add.
- Isi nama, misalnya "profitscope", dan pilih peran Employee, bukan Admin.
- Pilih System User itu, lalu klik Assign assets atau Add assets.
- Ad accounts: pilih akun iklan yang mau dihubungkan saja, lalu aktifkan Manage campaigns. Jangan beri Manage ad account, karena itu ikut membuka pengaturan keuangan akun.
- Apps: pilih app dari Tahap 1, lalu aktifkan Manage app (di beberapa tampilan tertulis Develop app).
Tahap 3: Buat token
- Masih di System User itu, klik Generate new token.
- Pilih app Anda.
- Pilih masa berlaku Never.
- Centang ads_read. Tambah ads_management hanya kalau ingin menjalankan aksi iklan dari sini, seperti mematikan iklan atau mengubah budget. Izin lain tidak dibutuhkan.
- Klik Generate token, lalu salin. Token hanya tampil sekali.
Tahap 4: Tempel di ProfitScope
- Masuk ke ProfitScope, lalu buka Pengaturan → Koneksi Meta.
- Tempel token di kotak Token System User, lalu klik Periksa token. Di tahap ini token belum disimpan.
- Pilih akun iklan yang muncul, lalu pilih tingkat koneksi: Laporan saja, atau Laporan + aksi kalau token punya izin ads_management.
- Klik Hubungkan.
- Hapus salinan token dari catatan Anda. Kalau nanti perlu, buat token baru saja.
Kalau ada masalah
"Meta menolak token ini"
Biasanya token tidak tersalin utuh, atau sudah dicabut. Salin ulang tanpa spasi di awal dan akhir. Kalau tetap ditolak, buat token baru.
"Token belum punya izin ads_read"
Buat ulang token di Tahap 3, dan pastikan ads_read tercentang.
Pilihan Laporan + aksi tidak tersedia
Token Anda tidak punya izin ads_management. Buat ulang token dan centang izin itu, kalau memang ingin menjalankan aksi iklan. Tanpa izin itu, laporan tetap berjalan.
Akun iklan tidak muncul
Buka lagi System User di Tahap 2, dan pastikan akun iklan sudah ditambahkan pada Ad accounts dengan Manage campaigns aktif.
Pastikan akun iklan, app, dan System User berada di portfolio yang sama. Setelah itu klik Periksa token lagi, tanpa perlu membuat token baru.
Akun iklan saya akun pribadi, tidak ada di business portfolio
System User hanya bisa memakai akun iklan yang berada di portfolio, jadi akun pribadi belum bisa dihubungkan seperti ini.
Pilihan paling aman: buat akun iklan baru di dalam portfolio, atau tetap pakai unggah CSV. Sumber yang kami temukan berbeda-beda tentang apakah akun pribadi bisa dipindahkan ke portfolio, dan pemindahan seperti itu umumnya tidak bisa dibatalkan. Baca Pusat Bantuan Bisnis Meta dulu sebelum mencobanya.
Diminta verifikasi saat memilih portfolio
Itu bukan error. Meta ingin memastikan Anda yang memegang portfolio tersebut. Buka business.facebook.com dengan akun Facebook yang sama, pilih portfolionya, dan ikuti verifikasinya, misalnya password atau 2FA. Setelah itu kembali, lalu pilih portfolio yang sama lagi.
Tombol Generate new token tidak muncul, atau izin tidak bisa dicentang
Periksa apakah app sudah ditambahkan ke System User dengan Manage app, dan app berada di portfolio yang sama.
Jangan langsung mengajukan App Review. Pada percobaan kami, membaca akun iklan di portfolio sendiri berjalan tanpa App Review. Kalau Meta meminta syarat lain, hubungi kami dulu dan kirim screenshot tanpa token.
Akun iklan ditolak karena sudah terhubung
Satu akun iklan hanya bisa terhubung ke satu ruang kerja, supaya datanya tidak terlihat orang lain. Kalau ingin bekerja bersama, minta pemilik ruang kerja itu mengundang Anda sebagai anggota.
Koneksi tertulis Bermasalah
Biasanya token sudah dicabut, atau akses System User ke akun iklan berubah. Buat token baru, lalu klik Ganti token di Koneksi Meta. Sementara itu laporan lama tetap ada, tapi data baru tidak masuk.
Cara mencabut token
Di ProfitScope: Pengaturan → Koneksi Meta → Putuskan. Token langsung dihapus dari sistem kami, dan data laporan yang sudah masuk tetap ada.
Di Meta: Pengaturan Bisnis → Users → System Users, pilih System User, lalu hapus tokennya. Cara ini bekerja tanpa perlu masuk ke sini.
Apakah token saya aman?
Token disimpan terenkripsi di brankas rahasia, dan setelah ditempel hanya 4 karakter terakhirnya yang tampil. Token tidak dikirim kembali ke browser, ke asisten AI, atau ke log.
Dengan peran Employee, Manage campaigns, dan satu akun iklan saja, token tidak bisa membuka pengaturan keuangan atau akun iklan lain Anda.