Memetakan Pengguna di Aplikasi dan Halaman

Jika Anda ingin menggunakan ID Pengguna Lingkup yang sama di versi uji, pengembangan, staging, atau QA aplikasi, gunakan Aplikasi Tes.

Facebook mengeluarkan ID pengguna lingkup aplikasi untuk orang yang pertama kali masuk ke instance aplikasi dan untuk orang yang masuk dengan Login Terbatas. Untuk orang yang pertama kali menggunakan bot Messenger, Facebook mengeluarkan ID pengguna dengan lingkup halaman. Menurut definisi, ini artinya ID untuk orang yang sama mungkin berbeda di aplikasi dan bot ini.

Bisnis dapat mengoperasikan beberapa Aplikasi Facebook atau bot - umumnya di studio game, sebagai contoh, untuk mendukung kasus penggunaan seperti promosi silang atau deteksi penipuan, atau di bot yang digunakan untuk berkomunikasi dengan pengguna. Dalam situasi ini, Anda mungkin perlu memetakan ID orang yang sama di aplikasi dan bot tersebut.

Ada 3 metode untuk memetakan pengguna yang sama di beberapa aplikasi:

Kolom token_for_business di node Pengguna
Properti token_for_business di objek signed_request diteruskan ke aplikasi yang di-render di dalam bingkai Facebook Canvas
Edge ids_for_business di node Pengguna

Agar dapat menggunakan salah satu mekanisme ini, terlebih dahulu Anda harus memberi tahu Facebook bahwa aplikasi dimiliki dan dioperasikan oleh entitas bisnis yang sama. Untuk melakukan ini, Anda harus menggunakan Pengelola Bisnis Facebook untuk:

Kolom `token_for_business` di node Pengguna

Setelah aplikasi dikaitkan dengan Pengelola Bisnis, Anda dapat meminta kolom token_for_business di node Pengguna, menggunakan ID lingkup aplikasi yang diperoleh dari Login Terbatas atau login pertama ke instance aplikasi. Panggilan ini menghasilkan sebuah string yang sama untuk orang ini di semua aplikasi yang dikelola oleh Pengelola Bisnis yang sama.

GET /me?fields=token_for_business

akan memberikan hasil:

{
  "id": "1234567890"
  "token_for_business": "weg23ro87gfewblwjef"
}

Catatan penggunaan:

Orang yang di-kueri harus telah masuk ke aplikasi ini.
Kolom ini dapat dipanggil dengan token akses aplikasi, atau token akses pengguna. Jika menggunakan token pengguna, orang yang di-kueri haruslah orang yang sama dengan yang menerima token.
Jika Anda menggunakan ID lingkup aplikasi yang diperoleh dari Login Terbatas, Anda harus menggunakan ID aplikasi Anda untuk melakukan panggilan karena Anda tidak memiliki token Pengguna yang valid untuk panggilan Graph API. Ketahuilah bahwa pengamanan Login Terbatas tidak didukung dalam konteks ini.
Jika bisnis yang memiliki berubah, nilai token_for_business juga akan berubah.
Jika Anda meminta kolom token_for_business dan aplikasi tidak terkait dengan Pengelola Bisnis, panggilan akan menampilkan kesalahan.
Nilai yang diberikan oleh token_for_business adalah token, bukan ID - tidak dapat digunakan secara langsung terhadap Graph API untuk mengakses informasi seseorang. Anda akan tetap menyimpan ID di database, dan menggunakannya untuk memanggil Graph API untuk mendapatkan informasi orang tersebut.

Untuk memudahkan, kolom token_for_business tersedia di semua versi API

Properti `token_for_business` di objek `signed_request` Canvas

Untuk mempermudah aplikasi dengan Canvas untuk memetakan pengguna di beberapa aplikasi, jika aplikasi tersebut terkait dengan Pengelola Bisnis, dan pengguna telah masuk ke aplikasi, kolom token_for_business akan ditambahkan dan diteruskan ke aplikasi melalui signed_request diteruskan ke aplikasi Canvas saat dimuat. Contoh:

{
  "algorithm": "HMAC-SHA256",
  "expires": 1414263600,
  "issued_at": 1414257389,
  "oauth_token": "CAAGEkq9GMZAkBAFnvvQ3M6msZBKITLa1gVZBVdnLTdJue2QeV6fMKRXn4G6fcEZB5ZAJyg3z6HdaKOJCCMJ1l9YFWmN4hq6nNnx77f9O7SYhsnPcJ6iH79xjFwqhrALgieDp7GiziMy5Y3Mol6RzHvCM5ceqQe9ZAijvrWZB5hEIwphbMQKEwZA4ZBozXP3NJgEZA3nZCMTTtvleWpxfmqIqO5XwxneCZBsZC4",
  "token_for_business": "AbwoGqummPbF3zp_",
  "user_id": "10154418713995634"
}

Nilai kolom token_for_business akan sama jika di-kueri di node Pengguna langsung, misalnya melalui /me?fields=token_for_business. Ini juga mengikuti aturan yang sama, yaitu jika bisnis yang memiliki berubah, nilai token_for_business juga akan berubah.

Jika aplikasi tidak terkait dengan Pengelola Bisnis, atau pengguna belum masuk ke aplikasi, properti token_for_business tidak akan ada di objek signed_request .

Edge `ids_for_business` di node Pengguna

Dapatkan ID bisnis yang dipetakan dengan memanggil edge ids_for_business di node Pengguna. Tanggapan berupa sebuah array objek, masing-masing mewakili aplikasi yang terkait dengan bisnis yang sama dengan aplikasi pemanggil (dengan catatan pengguna sudah login ke aplikasi-aplikasi itu).

GET /me/ids_for_business

Contoh Tanggapan:

{
  "data": [
    {
      "id": "10153949089790582", 
      "app": {
        "name": "Business's App 1", 
        "namespace": "business_app_1", 
        "id": "647733625268125"
      }
    }, 
    {
      "id": "605665581", 
      "app": {
        "name": "Business's App 2", 
        "namespace": "business_app_2", 
        "id": "370612223054807"
      }
    }, 
    {
      "id": "10154053730190582", 
      "app": {
        "name": "Business's App 3", 
        "namespace": "business_app_3", 
        "id": "194890427204075"
      }
    }
  ]
}

Agar data dihasilkan oleh API, pengguna harus sudah masuk ke satu atau beberapa aplikasi yang terkait dengan bisnis yang sama dengan aplikasi yang Anda gunakan untuk melakukan panggilan API. Contoh: jika seseorang telah masuk ke 3 dari 5 aplikasi yang dikaitkan dengan bisnis yang sama, API akan memberikan 3 objek.

Pertanyaan Umum

Apakah saya perlu menggunakan Business Mapping API?

Tidak. Business Mapping API hanya berguna untuk bisnis yang mengoperasikan beberapa Aplikasi Facebook, dan yang perlu memetakan ID pengguna yang sama di semua aplikasi. Jika Anda memiliki satu aplikasi utama, kecil kemungkinan Anda perlu menggunakan Business Mapping API sehingga tidak perlu menyiapkan bisnis atau mengaitkan aplikasi dengan bisnis.

Apa itu Pengelola Bisnis?

Pengelola Bisnis adalah cara untuk membantu bisnis dan agensi mengelola Halaman Facebook, akun iklan, aplikasi, dan metode pembayaran dalam satu tempat. Baca selengkapnya tentang Pengelola Bisnis.

Menurut saya, saya tidak perlu menggunakan Business Mapping API, tetapi haruskah saya mengaitkan aplikasi dengan bisnis?

Jika Anda tidak perlu menggunakan Business Mapping API, kami tidak merekomendasikan penyiapan bisnis untuk saat ini. Karena bisnis harus ditautkan dengan Halaman Facebook utama untuk bisnis, orang yang paling tepat untuk menyiapkan bisnis di Facebook adalah orang yang biasanya mengelola akun iklan Facebook dan izin Halaman untuk perusahaan Anda. Jika orang tersebut telah menyiapkan bisnis dalam Pengelola Bisnis, Anda dapat mengaitkan aplikasi dengan bisnis tersebut.

Bisakah saya mengaitkan aplikasi dengan beberapa bisnis?

Tidak. Satu aplikasi hanya dapat dikaitkan dengan satu bisnis.

Bisakah saya mentransfer aplikasi ke bisnis lain?

Ya. Pertama-tama, Anda harus menghapus aplikasi dari bisnis yang saat ini terkait. Anda dapat melakukannya dalam Pengelola Bisnis. Cukup buka tab Aplikasi dalam pengaturan bisnis, pilih aplikasi, dan klik "Hapus". Anda kemudian dapat mengaitkan aplikasi dengan bisnis baru.