Meta Audience Network

Integrasi Facebook Login dengan API Pelaporan Audience Network V2

Facebook Login adalah cara baru untuk mengizinkan akses ke data API Pelaporan Audience Network. Pendekatan ini akan menggantikan token pengguna sistem lama salin-tempel dari antarmuka Pengelola Monetisasi. Pendekatan ini adalah cara yang lebih aman untuk memberikan akses ke data Anda, agar terhindar dari risiko tereksposnya token Pengelola Monetisasi di luar bisnis.

Dokumen ini berfokus pada pemberian panduan untuk integrasi API Pelaporan langsung, Pengukuran Seluler, Mediasi, dan partner Facebook lainnya yang bekerja untuk mengakses data API Pelaporan atas nama penerbit.

Saya menggunakan pihak ketiga untuk mendapatkan data API Pelaporan

Jika Anda menggunakan partner yang ada (Partner Pengukuran Seluler atau Partner Mediasi), Anda tidak perlu melakukan coding lagi. Pastikan partner Anda mengintegrasikan alur Facebook Login. Anda harus mengeklik opsi “Login dengan Facebook” dan pilih properti yang ingin diberikan akses dengan token yang akan Anda buat.

Jika Anda memilih SEMUA properti, token akan memberikan akses ke semua properti di bawah Bisnis selama pengguna yang membuat token memiliki akses ke properti tersebut di Pengelola Bisnis.

Izin

Jika Anda perlu menggunakan API Pelaporan secara langsung, pertama-tama Anda harus membuat aplikasi Facebook dan mendapatkan izin yang diperlukan. Aplikasi Anda memerlukan izin read_audience_network_insights untuk mengakses data API Pelaporan Audience Network. Untuk mendapatkan izin ini untuk aplikasi Anda, bisnis harus sudah onboarding di Audience Network.

  • Pilih bisnis Anda yang baru dibuat di kolom akun bisnis

Setelah membuat aplikasi, Anda perlu menautkannya ke akun Pengelola Monetisasi dengan Memilih "Audience Network" dan mengeklik 'tombol Siapkan'. Anda harus memilih akun Pengelola Monetisasi apa yang ingin Anda tautkan.

Anda juga dapat melakukannya dengan membuka developers.facebook.com/apps dan memilih aplikasi yang baru Anda buat.

Aplikasi Anda sekarang masuk ke Audience Network dan dapat menggunakan izin read_audience_network_insights. Jika Anda tidak dapat melihat read_audience_network_insights, pastikan bahwa aplikasi memiliki akses ke akun Bisnis Pengelola Monetisasi Anda.

Jika sebelumnya Anda telah mendapatkan read_insights permission dengan Facebook Login, izin ini memang masih bisa digunakan. Namun, kami sarankan Anda beralih ke izin read_audience_network_insights.

Cara pendekatan Anda mengakses API Pelaporan akan bervariasi, tergantung jenis integrasi yang dimiliki. Silakan ikuti petunjuk yang berlaku untuk kasus Anda:

Integrasi API Langsung tanpa antarmuka UI

Jika Anda memiliki integrasi API Pelaporan khusus (langsung) tanpa antarmuka front-end/UI dan Anda menggunakannya untuk kueri data hanya untuk bisnis Anda, Anda dapat menggunakan petunjuk berikut untuk mendapatkan akses ke API Pelaporan.

Membuat token pengguna melalui Graph API Explorer

  1. Jika Anda telah menggunakan "Marketing API" dalam aplikasi Anda, lewati langkah ini. Jika belum, ikuti petunjuk tentang mendapatkan izin read_audience_network_insights
  2. Buka Graph API Explorer
  3. Pilih aplikasi Anda
  4. Pilih izin `read_audience_network_insights` (dapat ditemukan di bawah Izin > Halaman Grup Peristiwa) dan klik “Buat Token Akses”.
    1. Sekarang Anda bisa mengakses data API Pelaporan Audience Network untuk waktu yang singkat dengan token ini, bukan dengan token dari Pengelola Monetisasi
    2. Penafian: token ini akan kedaluwarsa dalam 2 jam, Anda harus mengubahnya menjadi token akses Berdurasi Lama menggunakan petunjuk di bawah ini.

Mengubah token ini menjadi token akses Berdurasi Lama

  1. Buka Debugger Token Akses
  2. Masukkan token Anda dan tekan “Debug”
  3. Gulir sampai ke bagian bawah tabel yang berisi semua informasi token, klik tombol “Perpanjang token Akses”
  4. Salin token yang dihasilkan

Sekarang Anda bisa mengakses data API Pelaporan Audience Network dengan token ini.

Integrasi API Langsung dengan antarmuka UI

Panduan berikut berguna bagi penerbit dan partner dengan antarmuka UI mereka sendiri yang bisa diberi tombol Facebook Login. Panduan ini akan berguna bagi penerbit yang ingin mengakses data mereka sendiri, serta partner yang ingin mengakses data monetisasi penerbit lain dengan izin mereka.

Anda juga dapat memeriksa video demo end-to-end dari panduan berikut termasuk langkah izin dari atas:

Ada Masalah
Kami mengalami masalah saat memutar video ini.
Selengkapnya
  • Di portal Developer, pilih aplikasi bisnis yang baru Anda buat dari langkah-langkah sebelumnya
  • Tambahkan produk "Facebook Login" baru ke aplikasi ini
  • Pilih opsi “Web” dan ikuti langkah-langkah integrasi
  • Masukkan URL situs web tempat Anda akan menampilkan pengalaman Facebook Login Anda. Pastikan URL tersebut mendukung protokol HTTPS
  • Di akhir langkah integrasi, Anda akan diberikan contoh kode untuk mengintegrasikan Facebook Login di situs Anda. Anda dapat menyalin kode ini menggunakan izin "read_audience_network_insights" yang baru diakses, dan bukan izin "public_profile,email". Dengan izin yang diperbarui, kode tombol Anda harus terlihat seperti ini: 
<fb:login-button 
  scope="read_audience_network_insights"
  onlogin="checkLoginState();">
</fb:login-button>
  • Pastikan Anda mengaktifkan JavaScript SDK di Facebook Login pada halaman pengaturan produk untuk aplikasi Anda
  • Sekarang, pengguna dapat melalui alur Facebook Login di halaman Anda untuk membuat token akses
  • Token akses akan diberikan sebagai bagian dari argumen yang diteruskan ke metode JavaScript statusChangeCallback dari langkah-langkah sebelumnya.
  • Secara default, token ini akan kedaluwarsa dalam waktu sekitar 2 jam
  • Developer dapat meminta untuk memperpanjang token ini ke token akses berdurasi lama tanpa interaksi pengguna tambahan.
    • Token Berdurasi Lama dimuat ulang sekali per hari, ketika permintaan API Pelaporan dibuat ke server Facebook. Jika tidak ada permintaan, token akan kedaluwarsa setelah sekitar 60 hari dan orang tersebut harus membuat token baru.
  • Perlu diingat bahwa data yang tersedia melalui token ini sangat bergantung pada siapa yang melewati alur Facebook Login ini dan data apa yang mereka setujui untuk dibagikan. Jadi, jika karyawan bisnis melewati alur ini, maka token akses yang dihasilkan akan memiliki izin yang sama dengan karyawan ini.

Pemecahan Masalah

Pesan KesalahanArtinyaTindakan/cara mengatasi

Membaca insight Halaman, bisnis, aplikasi, domain, atau grup sumber peristiwa yang tidak dimiliki oleh pengguna atau aplikasi yang melakukan kueri

Untuk token Facebook Login, hal itu berarti bahwa aplikasi yang mengeluarkan token tidak memiliki izin (read_audience_network_insights) yang mencukupi atau pengguna sendiri tidak memiliki izin untuk melihat properti tertentu. Hal ini dapat terjadi karena: *Pengguna yang membuat token belum diberi akses ke Pengelola Bisnis. * Pengguna yang telah membuat token belum diberi akses ke semua properti yang dikueri.

Admin Bisnis perlu memberikan akses ke semua properti kepada pengguna yang ingin atau telah membuat token.

Data Hilang atau Kosong

Hal ini biasanya berarti bahwa semua atau sebagian data telah difilter menggunakan agregasi privasi kami. Hal ini juga dapat divalidasi dengan data MoMa.

Periksa apakah ada array omitted_results, yang berarti data sedang diagregasi. Silakan coba permintaan yang lebih besar. Untuk informasi selengkapnya, silakan baca bagian agregasi.

read_audience_network_insights tidak terlihat untuk Token

Aplikasi yang dibuat untuk menghasilkan token tidak dibuat sebagai jenis Bisnis dan aplikasi tersebut telah ditautkan dengan Pengelola Monetisasi Audience Network Anda.

Pastikan Anda membuat Aplikasi untuk menghasilkan token sebagai Bisnis. Cobalah untuk membuat aplikasi baru dan pastikan Anda mengikuti petunjuk di bagian Izin. Buka developers.facebook.com/apps dan pilih aplikasi yang tidak dapat Anda lihat read_audience_network_insights serta pilih "Audience Network" dan klik pada 'tombol Siapkan'.

Error validating access token: Session has expired on ...

Token telah kedaluwarsa

Harap pastikan token tersebut diubah menjadi token Berdurasi Lama. Ikuti petunjuk di bagian "Ubah token ini menjadi token akses Berdurasi Lama". Token Berdurasi Lama dimuat ulang sekali per hari, ketika permintaan API Pelaporan dibuat ke server Facebook. Jika tidak ada permintaan yang dibuat, token akan kedaluwarsa setelah sekitar 60 hari dan orang tersebut harus membuat token baru.

Dua Aplikasi dengan nama yang sama ditampilkan

Periksa apakah salah satu aplikasi memiliki izin read_audience_network_insights

Gunakan aplikasi yang memiliki izin read_audience_network_insights yang benar

(#200) Cara untuk mengakses API Pelaporan v2.0 telah berubah. Anda kini perlu menerapkan Facebook Login untuk aplikasi Anda agar bisa mengakses API ini.

Anda tidak menggunakan kredensial untuk mengakses API dengan cara baru.

Pastikan Anda membuat aplikasi baru dari awal (hanya untuk digunakan untuk membuat token) dan Anda membuatnya sebagai jenis Bisnis.