Untuk perdagangan, guna menerbitkan tawaran Real Estate, bisnis Anda perlu terverifikasi.
Langkah 1: Buat katalog Tawaran Rumah.
Langkah 2: Siapkan tawaran dan harga.
Langkah 3: Perbarui opsi.
Langkah 4: Filter katalog tawaran ke set tawaran.
Langkah 5: Kirim Konversi Offline (Opsional)
Langkah 6: Bangun Pemirsa untuk Real Estate Anda. Berbeda dengan tawaran real estate yang diterbitkan oleh pengguna, untuk integrasi mitra, prospek dikirim ke mitra melalui formulir prospek, bukan melalui obrolan Messenger. Pelajari selengkapnya tentang Mengambil Prospek untuk perdagangan.
Langkah 7: Buat dan tayangkan iklan untuk tawaran rumah Anda.
Langkah 8: Dapatkan informasi penayangan untuk melihat cara orang di Facebook berinteraksi dalam iklan Anda. Lihat Insight Iklan.
Langkah 9: Gunakan fitur debug untuk mendiagnosis dan menyelesaikan masalah. Lihat Fitur Debug Iklan Katalog Advantage+.
Katalog Anda harus berisi daftar properti yang ingin Anda iklankan. Lihat Referensi Katalog.
Untuk membuat katalog tawaran rumah untuk iklan katalog Advantage+, tetapkan vertical
ke home_listings
:
curl \
-F 'name=Home Listing Catalog Name' \
-F 'vertical=home_listings' \
-F 'access_token=<ACCESS TOKEN>' \
https://graph.facebook.com/<API_VERSION>
Untuk membuat API katalog, Anda memerlukan Level Akses API Marketing dan menerima Ketentuan Layanan dengan membuat katalog pertama Anda melalui Pengelola Bisnis.
Untuk petunjuk tentang cara membuat katalog perdagangan, kunjungi dokumentasi Platform Marketplace.
Penawaran Anda berisi informasi properti, seperti ID tawaran, nama, ketersediaan, deskripsi, alamat, kamar tidur, kamar mandi, dan sebagainya. Anda dapat memiliki satu set tawaran yang diunggah atau diambil dari bisnis Anda. Item tawaran adalah properti tunggal yang disajikan di situs web atau aplikasi Anda.
Anda dapat memiliki satu kabar untuk semua properti di katalog Anda, atau Anda dapat memiliki beberapa feed dengan satu feed mewakili properti di satu negara, untuk satu agen real estate, atau untuk satu broker.
Untuk iklan katalog Advantage+, Anda harus menyediakan kabar tawaran dalam salah satu format berikut:
Format File | Deskripsi | Contoh File |
---|---|---|
XML | Biasanya dibuat oleh sistem penyedia kabar otomatis. Node XML | |
CSV, TSV | Baris pertama harus mencantumkan nama kolom pilihan sesuai urutan nilai yang akan diberikan. Lalu, baris berikutnya berisi nilai yang sesuai untuk setiap tawaran rumah. Kolom bertingkat atau multinilai seperti gambar dapat diwakili menggunakan nilai berkode JSON atau dengan set kolom teks biasa “diratakan” yang dilabeli menggunakan sintaksis berjalur JSON, seperti | Unduh (CSV) |
Untuk perdagangan, Anda harus menyediakan kabar tawaran dalam format XML:
Format File | Deskripsi |
---|---|
XML | Biasanya dibuat oleh sistem penyedia kabar otomatis. Node XML |
CSV, TSV, JSON | Format ini saat ini tidak didukung. |
Parser kabar kami secara otomatis mendeteksi pengodean teks UTF8
, UTF16
, atau UTF32
, kembali ke LATIN1
jika urutan bita yang tidak terduga muncul.
<?xml version="1.0" encoding="UTF-8"?> <listings> <title>example.com Feed</title> <link rel="self" href="http://www.example.com"/> <listing> <home_listing_id>12345678</home_listing_id> <name>1 Hacker Way, Menlo Park, CA 94025</name> <availability>for_rent</availability> <description>An amazing listing</description> <address format="simple"> <component name="addr1">1 Hacker Way</component> <component name="city">Menlo Park</component> <component name="region">California</component> <component name="country">United States</component> <component name="postal_code">94025</component> </address> <latitude>1.11414</latitude> <longitude>-1.835003</longitude> <neighborhood>Menlo Oaks</neighborhood> <image> <url>http://example.com/12345678-1.jpg</url> </image> <image> <url>http://example.com/12345678-2.jpg</url> </image> <image> <url>http://example.com/12345678-3.jpg</url> </image> <listing_type>for_rent_by_agent</listing_type> <num_baths>6</num_baths> <num_beds>5</num_beds> <num_units>1</num_units> <price>110000 USD</price> <property_type>house</property_type> <url>http://www.example.com/link_to_listing</url> <year_built>2007</year_built> </listing> </listings>
Kolom yang didukung berikut ini dirancang untuk item yang Anda tambahkan ke katalog produk Anda.
Untuk katalog yang dilokalkan, lihat kolom yang didukung untuk tawaran rumah.
Parser kabar kami secara otomatis mendeteksi pengodean teks UTF8
, UTF16
, atau UTF32
, kembali ke LATIN1
jika urutan bita yang tidak terduga muncul. Meskipun teks di kolom nilai dapat diberikan dalam berbagai bahasa, nama kolom harus diberikan seperti di bawah ini, dalam bahasa Inggris.
Nama dan Jenis Kolom | Deskripsi |
---|---|
jenis: string | Wajib untuk iklan katalog Advantage+ dan perdagangan. ID tawaran rumah (apartemen/kondominium) unik; ID yang sedetail mungkin. Contoh: |
jenis: string | Tidak berlaku untuk iklan katalog Advantage+. Opsional untuk perdagangan. ID unik gedung atau apartemen. Harus unik per grup. |
jenis: string | Wajib untuk iklan katalog Advantage+ dan perdagangan. Judul tawaran rumah. Contoh: |
jenis: string | Wajib untuk iklan katalog Advantage+ dan perdagangan. Ketersediaan saat ini untuk tawaran rumah. Nilai yang didukung adalah: |
jenis: string | Wajib untuk iklan katalog Advantage+ dan perdagangan. Alamat jalan untuk properti yang harus dapat ditentukan lokasinya. Lihat Parameter Objek Alamat. Contoh: |
jenis: string | Wajib untuk iklan katalog Advantage+ dan perdagangan. Kota tempat properti berada. Lihat Parameter Objek Alamat. Contoh: |
jenis: string | Wajib untuk iklan katalog Advantage+ dan perdagangan. Negara bagian, distrik, daerah, atau provinsi properti. Lihat Parameter Objek Alamat. Contoh: |
jenis: objek | Wajib untuk iklan katalog Advantage+ dan perdagangan. Negara tempat properti berada. Lihat Parameter Objek Alamat. Contoh: |
jenis: string | Wajib untuk iklan katalog Advantage+ dan perdagangan. Negara tempat properti berada. Lihat Parameter Objek Alamat. Contoh: |
jenis: float | Wajib untuk iklan katalog Advantage+ dan perdagangan. Garis lintang lokasi tawaran. Contoh: |
jenis: float | Wajib untuk iklan katalog Advantage+ dan perdagangan. Garis bujur lokasi tawaran. Contoh: |
jenis: string | Wajib untuk iklan katalog Advantage+. Opsional, tetapi sangat direkomendasikan untuk perdagangan. Lingkungan maksimal yang diizinkan: 20 Lingkungan tawaran untuk properti. Dapat memiliki beberapa lingkungan. Jika Anda memiliki lebih dari satu lingkungan, tambahkan kolom tambahan untuk setiap jenis lingkungan dan gunakan sintaksis berjalur JSON di setiap nama kolom untuk menunjukkan jumlah lingkungan. Contoh: |
jenis: string | Wajib untuk iklan katalog Advantage+ dan perdagangan. Harga jual atau sewa properti. Format harga sebagai biaya, diikuti dengan [kode mata uang ISO 3 digit] (https://en.wikipedia.org/wiki/ISO_4217?fbclid=IwAR0_xYfUmL3kIUA6sMeEaFAzbJa4MLeMiPDPrftFSX6wkKiTXxPinC-5j70 ">, dengan ruang antara biaya dan mata uang. Contoh: |
jenis: objek | Wajib untuk iklan katalog Advantage+ dan perdagangan. Gambar Maksimal: 20 Ukuran maksimal: 4 MB URL untuk gambar yang digunakan dalam iklan Anda.
Contoh: Lihat Parameter Objek Gambar. |
jenis: string | Wajib untuk iklan katalog Advantage+ dan perdagangan. Tautkan ke halaman tawaran properti. URL harus valid. Lihat Parameter Objek Gambar. Contoh: |
jenis: string | Opsional untuk iklan katalog Advantage+. Wajib untuk perdagangan. Maks 5.000 karakter Deskripsi properti. Contoh: |
jenis: float | Opsional untuk iklan katalog Advantage+. Wajib untuk perdagangan. Total jumlah kamar tidur. Dapat berupa Contoh: |
jenis: float | Opsional untuk iklan katalog Advantage+. Total jumlah kamar mandi. Untuk perdagangan, minimal harus |
jenis: float | Tidak berlaku untuk iklan katalog Advantage+. Wajib untuk perdagangan. Total jumlah ruangan di properti. |
jenis: string | Opsional untuk iklan katalog Advantage+. Tipe properti. Nilai yang didukung untuk iklan katalog Advantage+: |
jenis: string | Opsional untuk iklan katalog Advantage+. Tipe tawaran properti. Nilai yang didukung untuk iklan katalog Advantage+: |
jenis: int | Tidak berlaku untuk iklan katalog Advantage+. Wajib untuk perdagangan. Area atau ruang dari tawaran denah lantai. |
jenis: string | Tidak berlaku untuk iklan katalog Advantage+. Wajib untuk perdagangan. Unit (kaki persegi atau meter persegi) dari nilai luas lantai. Nilai yang didukung: |
jenis: string | Tidak berlaku untuk iklan katalog Advantage+. Opsional untuk perdagangan. Jenis pendingin udara. Nilai yang didukung: |
jenis: string | Tidak berlaku untuk iklan katalog Advantage+. Opsional untuk perdagangan. Jenis furnitur yang tersedia di properti. Nilai yang didukung: |
jenis: string | Tidak berlaku untuk iklan katalog Advantage+. Opsional untuk perdagangan. Jenis pemanas yang dipasang di properti. Nilai yang didukung: |
jenis: string | Tidak berlaku untuk iklan katalog Advantage+. Opsional untuk perdagangan. Jenis pencucian pakaian yang tersedia. Nilai yang didukung: |
jenis: int | Opsional untuk iklan katalog Advantage+ dan perdagangan. Total jumlah unit (apartemen, kondominium) yang tersedia untuk disewakan. Contoh: |
jenis: string | Tidak berlaku untuk iklan katalog Advantage+. Opsional untuk perdagangan. Jenis parkir yang tersedia di properti. Nilai yang didukung: |
jenis: string | Tidak berlaku untuk iklan katalog Advantage+. Opsional untuk perdagangan. Apakah perusahaan mitra telah memverifikasi tawaran tersebut. Nilai yang didukung: |
jenis: string | Tahun pembangunan properti, menggunakan format TTTT, tahun dengan 4 digit angka. Contoh: 1994. |
jenis: string | Tidak berlaku untuk iklan katalog Advantage+. Opsional untuk perdagangan. Menunjukkan bahwa binatang peliharaan diizinkan di properti: |
jenis: objek | Daftar tanggal dan harga dari tawaran yang tersedia. Saat Anda memberikan nilai, Facebook dapat merekomendasikan tawaran berdasarkan tanggal yang tersedia dan secara dinamis menampilkan harga terkait dalam iklan Anda. |
jenis: objek | Tautan aplikasi ke tawaran. |
Jenis: string | Mengontrol apakah barang aktif atau diarsipkan di katalog Anda. Hanya barang aktif yang bisa dilihat oleh orang di iklan, toko, atau saluran Anda lainnya. Nilai yang didukung: Contoh: Catatan: Beberapa platform partner seperti Shopify dapat menyinkronkan barang ke katalog Anda dengan status yang disebut staging, yang berperilaku sama seperti Kolom ini sebelumnya disebut |
Kunjungi dokumentasi Platform Marketplace untuk kolom perdagangan yang wajib diisi khusus negara.
Nama dan Jenis Kolom | Deskripsi |
---|---|
jenis: string | Wajib untuk iklan katalog Advantage+ dan perdagangan. URL sumber gambar. Ikuti spesifikasi gambar berikut:
|
jenis: string | Opsional untuk iklan katalog Advantage+ dan perdagangan. Tanda yang ditambahkan ke gambar yang menunjukkan apa yang ada di gambar. Mungkin ada beberapa tanda yang dikaitkan dengan sebuah gambar. Contoh:
|
Nama dan Jenis Kolom | Deskripsi |
---|---|
jenis: string | Wajib diisi. Alamat jalan hotel. Contoh: |
jenis: string | Wajib diisi. Kota tempat hotel berada. Contoh: |
jenis: string | Wajib diisi. Negara bagian, distrik, daerah, atau provinsi hotel. Contoh: |
jenis: string | Wajib diisi. Negara dari hotel tersebut. Contoh: |
jenis: string | Kode pos properti. Wajib diisi, kecuali jika negara tidak memiliki sistem kode pos. Contoh: |
Dengan available_dates_price_config
, Anda dapat memberikan ketersediaan dan harga setiap properti untuk rentang tanggal tertentu. Ketika Anda memasukkan rentang tanggal di kolom ini, Facebook memfaktor ketersediaan ini ke dalam rekomendasi produk kami dan mencoba untuk menampilkan tawaran yang tersedia untuk tanggal yang dicari seseorang di situs Anda. Opsional, jika Anda mencantumkan harga, kami juga dapat menampilkan harga spesifik tanggal dalam materi iklan Anda. Untuk mengaktifkan fitur ini, Anda juga harus mengirimkan lease_start_date
dan lease_end_date
dalam peristiwa piksel Anda kepada Facebook.
Nama dan Jenis Kolom | Deskripsi |
---|---|
jenis: string | Opsional jika Mulai rentang tanggal yang tersedia dalam format ISO-8601, termasuk tanggal mulai. Jika Anda hanya memberikan Contoh: |
jenis: string | Opsional jika Akhir rentang tanggal yang tersedia dalam format ISO-8601, tidak termasuk tanggal berakhir. Jika Anda hanya memberikan Contoh: |
jenis: string | Harga dalam bilangan bulat dari tawaran selama rentang waktu ini. Contoh: |
jenis: string | Wajib diisi jika Anda memberikan Kode mata uang ISO-4217. Contoh: |
jenis: string | Lama menginap untuk tarif yang ditentukan. Nilai yang diizinkan adalah: |
Ini adalah contoh ketersediaan tawaran dan tampilannya di JSON:
"available_dates_price_config": [ { // available until 11/01 at $150/night "end_date": "2018-11-01", "rate": "15000", "currency": "USD", "interval": "nightly", }, { // available from 11/01 - 12/01 at $200/night "start_date": "2018-11-01", "end_date": "2018-12-01", "rate": "20000", "currency": "USD", "interval": "nightly", }, { // available from 11/01 onward at $500/week "start_date": "2018-11-01", "rate": "50000", "currency": "USD", "interval": "weekly", }, ]
Sediakan tautan dalam di kabar mengikuti spesifikasi Tautan Aplikasi. Informasi tautan dalam di kabar lebih diutamakan daripada informasi apa pun yang dikumpulkan Facebook dengan metadata Tautan Aplikasi dengan crawler web kami.
Jika Anda sudah memiliki informasi tautan dalam dari Tautan Aplikasi, Anda tidak perlu menentukan data ini. Facebook menggunakan informasi dari Tautan Aplikasi untuk menampilkan tautan dalam yang benar. Untuk menampilkan tautan dalam di iklan Anda, lihat Iklan Katalog Advantage+, Template Iklan.
Untuk iklan katalog Advantage+, Anda dapat memuat ulang info dalam katalog melalui cara berikut dengan unggahan langsung. Lihat Referensi Kabar Unggahan Langsung
Contoh — Anda dapat melakukan unggahan satu kali secara manual:
curl \
-F "url=http://www.example.com/sample_feed.xml" \
-F "access_token=
Untuk perdagangan, Anda dapat memuat ulang info tawaran rumah di katalog dengan menyiapkan unggahan kabar berulang (terjadwal) dan memperbarui kabar Anda. Di Marketplace, kami sangat merekomendasikan untuk menggunakan opsi Atur Jadwal.
Perdagangan mendukung pengalaman multibahasa. Ketika Anda menambahkan kabar bahasa sekunder ke dalam katalog, Anda dapat membuat kabar lain dengan bahasa kedua dari katalog tunggal tersebut. Informasi pada kabar sekunder menggantikan bahasa default Anda ketika pemirsa yang relevan melihat tawaran Anda.
Fitur ini hanya berlaku untuk mitra negara tertentu. Silakan hubungi perwakilan Facebook Anda untuk mengetahui kemungkinan di pasar Anda.
Ini adalah grup item dalam katalog yang Anda iklankan di iklan katalog Advantage+. Setiap katalog tawaran dapat memiliki banyak set tawaran.
curl \
-F "name=test set" \
-F 'filter={"availability":{"eq":"for_sale"}}' \
-F "access_token=" \
https://graph.facebook.com/
filter
di atas terdiri dari operator dan data berikut:
Operator | Jenis filter |
---|---|
| Berisi substring (tidak sensitif huruf besar/kecil) |
| Tidak berisi substring (tidak sensitif huruf besar/kecil) |
| Berisi substring (sensitif huruf besar/kecil) |
| Tidak berisi substring (sensitif huruf besar/kecil) |
| Sama dengan (sensitif huruf besar/kecil) |
| Tidak sama dengan (tidak sensitif huruf besar/kecil) |
| Kurang dari (kolom numerik saja) |
| Kurang dari atau sama dengan (kolom numerik saja) |
| Lebih besar dari (kolom numerik saja) |
| Lebih besar atau sama dengan (kolom numerik saja) |
Data | Data yang akan difilter |
---|---|
| Ketersediaan tawaran. Contoh: |
| Tipe tawaran. Contoh: |
| Jenis properti. Contoh: |
| Harga tawaran |
| Nama |
| Kota |
| Negara |
| Wilayah atau negara bagian |
| Kode pos |
| Jumlah tempat tidur |
| Jumlah kamar mandi |
Anda dapat mengirim peristiwa konversi offline dan memeriksa banyaknya pelanggan yang melihat atau mengeklik iklan dan tawaran perdagangan Facebook sebelum mengonversi; gunakan Conversions API Offline dan tambahkan kolom berikut di langkah 4. Unggah Peristiwa Offline.
Kode pencocokan membandingkan konversi dengan pengguna.
Kode | Deskripsi |
---|---|
| Alamat email Hash |
| Nomor telepon Hash |
| Nama depan Hash |
| Nama belakang Hash |
| ID iklan Apple atau Android Hash |
| Kode pos Hash |
| Kota Hash |
| Negara Bagian Hash |
| Negara Hash |
| Tanggal lahir (format HH) Hash |
| Tanggal lahir (format TTTT) Hash |
| Jenis Kelamin Hash |
| Usia Hash |
| ID Prospek dari prospek Marketplace |
Data khusus membandingkan konversi dengan dealer.
Kolom | Deskripsi |
---|---|
|
|
| Atur ke |
Detail peristiwa mendeskripsikan peristiwa konversi offline yang terjadi. Frekuensi unggahan harian, dalam waktu 48 jam sejak peristiwa.
Kolom | Deskripsi |
---|---|
| Wajib diisi Enum jenis peristiwa:
|
| Wajib Waktu peristiwa |
| Wajib Nilai sewa. Atur ke |
| Wajib Kode mata uang |