Membuat Pemirsa Real Estat

Dimulai dengan rilis Marketing API v15.0, Anda tidak akan bisa lagi membuat Pemirsa Iklan Khusus. Lihat Pemirsa Iklan Khusus untuk informasi selengkapnya.

Buat pemirsa real estat:

Langkah 1: Siapkan Sinyal Pengguna untuk Peristiwa Real Estat
Langkah 2: Kaitkan Sinyal Pengguna dengan Katalog
Langkah 3: Buat Grup Sumber Peristiwa Real Estate
Langkah 4: Buat Pemirsa Real Estat

Langkah 1: Menyiapkan Sinyal Pengguna untuk Peristiwa Real Estat

Ini adalah nama peristiwa yang sudah ditentukan sebelumnya yang dapat dikirim dari situs web atau aplikasi yang memungkinkan Anda untuk mengukur kinerja kampanye dan menangkap maksud dari pemirsa Anda. Lihat Penyiapan Facebook Pixel.

Iklan real estat memerlukan peristiwa standar berikut dari pixel situs web dan aplikasi seluler:

Peristiwa Pixel	Peristiwa Aplikasi	Level Persyaratan	Deskripsi
`Search`	`fb_mobile_search`	◉	Seseorang mencari daftar rumah
`ViewContent`	`fb_mobile_content_view`	◉	Seseorang melihat daftar tertentu
`InitiateCheckout`	`fb_mobile_initiated_ checkout`	◉	Seseorang menyimpan, menyukai, atau menunjukkan minat khusus dalam daftar
`Purchase`	`fb_mobile_purchase`	◉	Seseorang menghubungi agen perihal daftar

◉ Wajib: Iklan tidak akan berfungsi tanpa parameter ini.
◎ Direkomendasikan: Tidak benar-benar wajib namun memungkinkan rekomendasi yang lebih baik dan opsi penargetan lebih banyak bagi iklan Anda. Sediakan sebanyak mungkin.
◯ Tidak Diperlukan: Tidak diperlukan dan mungkin diabaikan.

Contoh: untuk melaporkan peristiwa Pencarian daftar menggunakan Facebook pixel atau peristiwa aplikasi, masukkan kode ini pada halaman hasil-pencarian Anda:

<!-- Facebook Pixel Code -->

Bundle parameters = new Bundle();
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "home_listing");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "[\"1234\", \"2345\", \"3456\", \"4567\"]"); // top search results

// we must prefix all travel-specific parameters with fb_
parameters.putString("fb_city", "New York City"); // Required for Search event
parameters.putString("fb_region", "New York"); // region is the state for the US. Required for Search event
parameters.putString("fb_country", "US"); // Required for Search event

logger.logEvent(
  AppEventsConstants.EVENT_NAME_SEARCHED,
  parameters
);

[FBSDKAppEvents logEvent:FBSDKAppEventNameSearched
  parameters:@{
    FBSDKAppEventParameterNameContentType : @"home_listing",
    FBSDKAppEventParameterNameContentID : @"[\"1234\", \"2345\", \"3456\", \"4567\"]", // top search results
		// we must prefix all travel-specific parameters with fb_
		@"fb_city" : @"New York City", //Required for Search event
	  @"fb_region" : @"New York", // region is the state for the US. Required for Search event
	  @"fb_country" : @"US", // Required for Search event
  }
];

Setelah Anda menentukan peristiwa mana yang harus dipicu, Anda harus memberikan parameter untuk setiap peristiwa.

Parameter Peristiwa

Tabel di bawah ini berisi daftar parameter yang wajib dan yang direkomendasikan.

Parameter Pixel	Parameter Seluler	Level Persyaratan
`content_ids`	`fb_content_id`	◉
`content_type`	`fb_content_type`	◯
`lease_start_date`		◎
`lease_end_date`		◎
`preferred_baths_range`		◎
`preferred_beds_range`		◎
`preferred_price_range`		◎
`currency`	`fb_currency`	◎
`property_type`		◎
`listing_type`		◎
`availability`		◎
`city`	`fb_city`	◎
`neighborhood`		◎
`region`	`fb_region`	◎
`country`	`fb_country`	◎

Detail Parameter

Nama Parameter	Jenis Data	Deskripsi
`availability`	`string`	Nilai harus berupa `available_soon`, `for_rent`, `for_sale`, `off_market`, `recently_sold`, atau `sale_pending`.
`city`	`string`	Sediakan kota yang diminati pengguna tersebut, misalnya: `'Menlo Park'`
`content_ids`	`string` atau `string[]`	ID dalam katalog daftar Anda. Contoh: untuk peristiwa `ViewContent`, kirimkan ID item yang dilihat, atau untuk `Search`, kirimkan array ID untuk mendapatkan hasil teratas: `['1234', '2345', '3456', '4567']`
`content_type`	`string` atau `string[]`	mis. `'home_listing'` `['home_listing', 'product']` `['home_listing', 'hotel']`
`country`	`string`	Targetkan negara yang diminati, seperti `'United States'`
`currency`	`string`	Ditentukan menggunakan format mata uang ISO 4217: `'USD'`
`lease_start_date`	`string`	Mengizinkan kita untuk merekomendasikan properti berdasarkan ketersediaan tanggal mereka (menggunakan `available_dates_price_config` di katalog), dan meningkatkan pengalaman penyambutan pengguna (menggunakan tanda template). Ditentukan menggunakan format tanggal ISO 8601: `'YYYY-MM-DD'` (misalnya: `2018-01-01`).
`lease_end_date`	`string`	Ditentukan menggunakan format tanggal ISO 8601: `'YYYY-MM-DD'` (misalnya: `'2018-02-01'`).
`listing_type`	`string`	Nilai harus berupa `for_rent_by_agent`, `for_rent_by_owner`, `for_sale_by_agent`, `for_sale_by_owner`, `foreclosed`, `new_construction` atau `new_listing`.
`neighborhood`	`string`	Lingkungan yang diminati: `'Menlo Oaks'`
`preferred_baths_range`	`[int`(min)`, int`(maks)`]`	Jumlah kamar mandi yang dipilih berdasarkan kisaran: `[1, 2]`
`preferred_beds_range`	`[int`(min)`, int`(maks)`]`	Jumlah kamar tidur yang dipilih berdasarkan kisaran: `[1, 2]`
`preferred_price_range`	`[float`(min)`, float`(maks)`]`	Kisaran harga: `[1000.99, 2000.99]`
`property_type`	`string`	Harus berupa `apartment`, `condo`, `house`, `land`, `manufactured`, `other`, atau `townhouse`.
`region`	`string`	Negara bagian, distrik, atau daerah yang diminati: `'California'`

Langkah 2: Kaitkan Sinyal ke Katalog Daftar

Kaitkan sumber peristiwa Anda pada setiap katalog daftar. Lihat Halaman Katalog Pengelola Bisnis Untuk memilih pixel dan aplikasi melalui API yang mengirimkan peristiwa, buat HTTP POST:

curl \
  -F '0=

Tentukan parameter ini:

Nama Kolom	Jenis Data	Deskripsi
`external_event_sources` (wajib)	`int[]`	Daftar Pixel dan ID Aplikasi untuk dikaitkan dengan katalog.

Langkah 3: Buat dan Bagikan Grup Sumber Peristiwa Real Estat

Untuk membuat pemirsa, admin bisnis Anda harus membuat grup sumber peristiwa. Tindakan ini mengelompokkan semua sumber Anda yang mengirimkan sinyal minat daftar. Membuat HTTP POST:

curl \
  -F 'name=My Real Estate Company Events' \
  -F 'event_sources=['

Lalu bagikan grup sumber peristiwa ini ke akun iklan yang akan menjalankan iklan kepada pemirsa yang dibuat dari sumber peristiwa ini. Membuat HTTP POST:

curl \
  -F 'accounts=['

Langkah 4: Buat Pemirsa

Pada titik ini Anda memiliki sinyal dari pixel atau peristiwa aplikasi yang disiapkan dan dikaitkan dengan grup sumber peristiwa dan katalog real estat Anda. Untuk menargetkan orang yang tertarik dengan daftar Anda, buat pemirsa dinamis dari orang tersebut. Sertakan atau kecualikan orang dari pemirsa berdasarkan sinyal niat. Anda juga dapat menerapkan filter berdasarkan aturan tambahan untuk menyesuaikan pemirsa seperti yang Anda terapkan pada Pemirsa Khusus Situs Web. Lihat Pemirsa Khusus.

Untuk menyiapkan pemirsa baru, buat HTTP POST untuk /act_<AD_ACCOUNT_ID>/customaudiences.

Parameter Wajib

Nama Kolom	Jenis Data	Deskripsi
`name`	`string`	Nama pemirsa.
`subtype`	`enum {CLAIM}`	Jenis pemirsa khusus. Harus diatur ke `CLAIM`.
`claim_objective`	`enum {HOME_LISTING}`	Tujuan pemirsa. Harus diatur ke `HOME_LISTING`.
`event_source_group`	`id`	Grup sumber peristiwa untuk membuat pemirsa.
`inclusions`	`object[]`	Array objek JSON. Mencantumkan setiap sinyal maksud yang menjadikan seseorang memenuhi syarat untuk pemirsa ini.
inklusi: `event` (wajib)	`enum { Search, ViewContent, InitiateCheckout, Purchase }`	Nama peristiwa sinyal. Digunakan untuk inklusi dalam pemirsa: `{'event': 'Search', …}`.
inklusi: `retention` (wajib)	`object`	Jumlah frekuensi minimum dan maksimum sejak peristiwa diterima. Tentukan apakah peristiwa dipertimbangkan untuk inklusi. Contoh: `{…, 'retention': {'min_seconds': 0, 'max_seconds': 259200}, …}`. Retensi minimal harus 4 jam.
inklusi: `count`	operator `JSON`	Jumlah frekuensi pengaktifan peristiwa. Anda dapat menggunakan operator perbandingan kesetaraan dan numerik seperti `{…'count': {'lte': 3}, …}`.

Parameter Opsional

Nama Kolom	Jenis Data	Deskripsi
`content_type`	`enum {HOME_LISTING}`	Jenis sinyal yang digunakan untuk membuat pemirsa ini.
`description`	`string`	Deskripsi pemirsa.
`exclusions`	`object[]`	Array daftar objek JSON setiap sinyal niat yang mengecualikan seseorang dari pemirsa ini.
pengecualian: `event` (wajib)	`enum { Search, ViewContent, InitiateCheckout, Purchase }`	Nama peristiwa sinyal yang digunakan untuk pengecualian: `{'event': 'Search', …}`.
pengecualian: `retention` (wajib)	`object`	Jumlah frekuensi minimum dan maksimum sejak peristiwa diterima. Menentukan apakah peristiwa dipertimbangkan untuk pengecualian, contoh: `{…, 'retention': {'min_seconds': 0, 'max_seconds': 259200}, …}`. Retensi minimal harus 4 jam.
`rule`	`object`	Aturan Pemirsa dari Pemirsa Khusus Situs Web. Filter aliran peristiwa dengan aturan ini sebelum `inclusions` dan `exclusions` diproses. Lihat daftar kolom spesifik yang tersedia. Anda dapat menggunakan ini dengan `JSON` standar Operator untuk Aturan Pemirsa.
aturan: `home_listing_set_id` (wajib)	`object`	ID set daftar: `{'eq': '1234'}}`

Contoh: untuk membuat pemirsa yang menargetkan orang yang melihat atau membeli dalam 14 hari terakhir:

curl \
  -F 'name=Viewed or Purchased Last 14 days' \
  -F 'subtype=CLAIM' \
  -F 'claim_objective=HOME_LISTING' \
  -F 'content_type=HOME_LISTING' \
  -F 'event_source_group=