Membagikan ke Messenger untuk iOS dan Android

Saat Anda mengembangkan dengan Facebook SDK untuk iOS atau Android versi 4.29.0 atau yang lebih baru, Anda dapat mengizinkan orang untuk membagikan tautan dan media dari aplikasi Anda ke Messenger. Ketika pengguna membagikan ke Messenger, Anda dapat memicu ekstensi obrolan melalui tautan atribusi. Ekstensi obrolan muncul di bagian Lainnya di antarmuka bagikan.

Untuk informasi selengkapnya, lihat bagian berikut:

Untuk menerapkan membagikan ke Messenger untuk web, lihat Membagikan ke Messenger untuk Web.

Jenis Membagikan

Facebook SDK menyediakan jenis bagikan berikut:

  • Membagikan Tautan (Sama seperti membagikan tautan yang ada tetapi dengan pageID untuk atribusi)
  • Foto (Tanpa atribusi)

Tabel berikut berisi daftar semua jenis bagikan yang didukung dalam membagikan ke Messenger, seiring apakah ID Halaman atau Aplikasi diperlukan.

Jenis Bagikan Perlu ID Halaman? Aplikasi

Membagikan Tautan

Opsional

  • Tautan tanpa atribusi
  • Tautan dengan atribusi

Foto

Tidak didukung

  • Foto
  • Foto dari galeri

Menautkan Aplikasi dan ID Halaman

Developer dapat menentukan ID Halaman di dalam alur bagikan, dan ketika orang membagikan konten dari sebuah aplikasi ke messenger dengan bantuan SDK Bagikan, konten tersebut diatribusikan ke Halaman. Administrator halaman, pada akhirnya, dapat mencegah atribusi palsu dengan mengontrol aplikasi mana yang dapat menggunakan atribusi bagikan untuk Halaman mereka. Untuk memberikan atribusi bagikan di aplikasi, admin menautkan ID aplikasi dengan ID Halaman.

Untuk menautkan ID aplikasi dan ID Halaman:

  1. Buka Pengaturan untuk Halaman.
  2. Klik bagian Platform Messenger.
  3. Buka bagian Tautkan Aplikasi di Pengaturan Umum.
  4. Masukkan ID aplikasi dan klik tombol Tautkan.
  5. Jika aplikasi ini TIDAK ada di dalam tabel Aplikasi Langganan, maka aplikasi tersebut akan muncul di tabel dengan peran “atribusi bagikan” yang terkait dengannya. Jika aplikasi sudah ada dalam tabel, peran "atribusi bagikan" baru akan ditambahkan untuk aplikasi itu.

Administrator halaman juga dapat menghapus izin menggunakan atribusi bagikan untuk aplikasi.

Untuk menghapus peran “atribusi bagikan” untuk aplikasi tertentu:

  1. Di tabel Aplikasi Langganan, klik menu pilihan di kolom “peran” untuk aplikasi.
  2. Klik “atribusi bagikan” untuk membatalkan pilihan peran.
  3. Jika “atribusi bagikan” adalah satu-satunya peran untuk aplikasi, maka baris untuk aplikasi dihapus dari tabel. Jika tidak, baris tetap ada tetapi baris “atribusi bagikan” tidak dipilih.

Mendaftarkan Domain

Jika Anda menggunakan tombol URL di SDK Bagikan dan ingin mengaktifkan Ekstensi Messenger untuk URL Anda saat dibuka di Messenger, Anda harus mendaftarkan domain URL agar bagikan berfungsi dengan benar.

Untuk mendaftarkan domain:

  1. Lihat Halaman.
  2. Buka Pengaturan > Berkirim Pesan Lanjutan.
  3. Tambahkan domain ke kolom Domain dalam Daftar Putih.

Untuk informasi selengkapnya, lihat SDK Ekstensi Messenger - Memasukkan Domain ke Daftar Putih yang Diwajibkan.

iOS

Prasyarat

Sebelum Anda menambahkan "Bagikan ke Messenger" ke aplikasi Anda, selesaikan langkah-langkah berikut:

  • Menambahkan Facebook SDK untuk iOS ke lingkungan pengembangan seluler Anda
  • Konfigurasikan dan tautkan ID aplikasi Facebook Anda ke ID Halaman Anda dengan fitur Platform Messenger.
  • Menambahkan ID aplikasi Anda, nama tampilan, dan alasan yang mudah dibaca manusia untuk akses foto ke file .plist aplikasi Anda.
  • Menautkan FBSDKShareKit.framework ke proyek Anda.

Untuk informasi selengkapnya, lihat Memulai Facebook SDK untuk iOS

Pastikan juga aplikasi Anda memanggil canShow atau validate pada instance MessageDialog untuk menentukan apakah orang telah menginstal versi Messenger yang kompatibel pada perangkat mereka.

Batasan

Properti kutip tidak didukung.

Contoh Membagikan Tautan

guard let url = URL(string: "https://newsroom.fb.com/") else {
    preconditionFailure("URL is invalid")
}

let content = ShareLinkContent()
content.contentURL = url

let dialog = MessageDialog(content: content, delegate: self)

do {
    try dialog.validate()
} catch {
    print(error)
}

dialog.show()

Contoh Membagikan Foto

// Assumes your assets contain an image named "puppy"
guard let image = UIImage(named: "puppy") else {
    return
}

let photo = SharePhoto(image: image, userGenerated: true)
let content = SharePhotoContent()
        content.photos = [photo]

let dialog = MessageDialog(content: content, delegate: self)

// Recommended to validate before trying to display the dialog
do {
    try dialog.validate()
} catch {
    print(error)
}

dialog.show()

Contoh Membagikan Video

// Assuming you have a URL for a PHAsset
let video = ShareVideo(videoURL: assetURL)
let content = ShareVideoContent()
content.video = video

let dialog = MessageDialog(content: content, delegate: self)

// Recommended to validate before trying to display the dialog
do {
    try dialog.validate()
} catch {
    print(error)
}

dialog.show()

Android

Prasyarat

Ikuti petunjuk di Membagikan di Android yang rangkumannya ada di bawah ini:

Pastikan juga aplikasi Anda memanggil MessageDialog.canshow({template}) untuk menentukan apakah orang-orang telah menginstal versi Messenger yang kompatibel pada perangkat mereka.