API Pelaporan Facebook Login - Meta Audience Network - Dokumen

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.

Setelah onboarding di Pengelola Monetisasi, buka Halaman Developer Facebook dan mulailah membuat aplikasi bisnis baru

Pilih bisnis Anda yang baru dibuat di kolom akun bisnis

Aplikasi Anda sudah masuk ke Audience Network dan dapat menggunakan izin read_audience_network_insights. Jika Anda tidak dapat melihat read_audience_network_insights, pastikan aplikasi telah ditautkan ke Bisnis yang 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
Integrasi API Langsung dengan antarmuka UI

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

Jika Anda telah menggunakan "Marketing API" dalam aplikasi Anda, lewati langkah ini. Jika belum, ikuti petunjuk tentang mendapatkan izin read_audience_network_insights
Buka Graph API Explorer
Pilih aplikasi Anda
Pilih izin `read_audience_network_insights` (dapat ditemukan di bawah Izin > Halaman Grup Peristiwa) dan klik “Buat Token Akses”.

Sekarang Anda bisa mengakses data API Pelaporan Audience Network untuk waktu yang singkat dengan token ini, bukan dengan token dari Pengelola Monetisasi
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

Buka Debugger Token Akses
Masukkan token Anda dan tekan “Debug”
Gulir sampai ke bagian bawah tabel yang berisi semua informasi token, klik tombol “Perpanjang token Akses”

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 Kesalahan	Artinya	Tindakan/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.