建立地產廣告受眾

從推廣 API v15.0 發佈起，您將無法再建立特殊廣告受眾。詳情請參閱特殊廣告受眾。

建立地產廣告受眾：

第 1 步：為地產事件設定用戶訊號
第 2 步：為用戶訊號與目錄建立聯繫
第 3 步：建立地產事件來源群組
第 4 步：建立地產廣告受眾

第 1 步：為地產事件設定用戶訊號

這些是您可以從網站或應用程式傳送的預先定義事件名稱，可讓您衡量宣傳活動的成效，同時瞭解廣告受眾的意圖。查看 Facebook 像素設定。

地產廣告需要以下來自網站像素和流動應用程式的標準事件：

像素事件	應用程式事件	需求等級	說明
`Search`	`fb_mobile_search`	◉	有人搜尋樓盤資訊
`ViewContent`	`fb_mobile_content_view`	◉	有人查看特定樓盤
`InitiateCheckout`	`fb_mobile_initiated_ checkout`	◉	有人儲存或讚好某個樓盤或者展現特別興趣
`Purchase`	`fb_mobile_purchase`	◉	有人就某個樓盤聯絡代理

◉必填：如果沒有這些參數，廣告無法正常運作。
◎ 推薦：並非必需，但如提供則可為廣告提供更佳建議，以及更多目標選項。盡可能提供更多。
◯ 非必填：非必填並可略過。

例如，如要使用 Facebook 像素或應用程式事件回報樓盤的 Search 事件，請將這個代碼放置於搜尋結果頁面：

<!-- 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
  }
];

當您決定要觸發哪些事件後，請提供每個事件的參數。

事件參數

下表列出必要參數和建議參數。

像素參數	流動參數	需求等級
`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`	◎

參數詳細資料

參數名稱	資料類型	說明
`availability`	`string`	值必須為 `available_soon`、`for_rent`、`for_sale`、`off_market`、`recently_sold` 或 `sale_pending`。
`city`	`string`	提供用戶感興趣的城市，例如 `'Menlo Park'`
`content_ids`	`string` 或 `string[]`	樓盤目錄中的任何編號。例如，如果是 `ViewContent` 事件，請傳送所瀏覽項目的編號；如果是 `Search` 事件，則傳送一系列熱門結果的編號：`['1234', '2345', '3456', '4567']`
`content_type`	`string` 或 `string[]`	例如： `'home_listing'` `['home_listing', 'product']` `['home_listing', 'hotel']`
`country`	`string`	感興趣的目標國家／地區，例如 `'United States'`
`currency`	`string`	使用 ISO 4217 貨幣格式列明：`'USD'`
`lease_start_date`	`string`	允許我們根據物業的可用日期（使用目錄中的 `available_dates_price_config`）作推薦，並改善用戶在到達網頁上的體驗（使用範本標籤）。使用 ISO 8601 日期格式列明：`'YYYY-MM-DD'`（例如 `2018-01-01`）。
`lease_end_date`	`string`	使用 ISO 8601 日期格式列明：`'YYYY-MM-DD'`（例如 `'2018-02-01'`）。
`listing_type`	`string`	值必須為 `for_rent_by_agent`、`for_rent_by_owner`、`for_sale_by_agent`、`for_sale_by_owner`、`foreclosed`、`new_construction` 或 `new_listing`。
`neighborhood`	`string`	感興趣的社區：`'Menlo Oaks'`
`preferred_baths_range`	`[int`（最少）`, int`（最多）`]`	所選洗手間數量範圍：`[1, 2]`
`preferred_beds_range`	`[int`（最少）`, int`（最多）`]`	所選睡房數量範圍：`[1, 2]`
`preferred_price_range`	`[float`（最少）`, float`（最多）`]`	價格範圍：`[1000.99, 2000.99]`
`property_type`	`string`	必須為 `apartment`、`condo`、`house`、`land`、`manufactured`、`other` 或 `townhouse`。
`region`	`string`	感興趣的州份、區域或地區：`'California'`

第 2 步：將訊號與樓盤目錄建立聯繫

將事件來源與每個樓盤目錄建立聯繫。查看企業管理平台的目錄頁面。如要透過傳送事件的 API 選擇像素及應用程式，請作出 HTTP POST：

curl \
  -F '0=

列明這些參數：

欄位名稱	資料類型	說明
`external_event_sources`（必填）	`int[]`	與目錄建立聯繫的像素及應用程式編號名單。

第 3 步：建立並分享地產事件來源群組

如要建立廣告受眾，企業管理員必須建立事件來源群組。這個群組會收錄所有傳送樓盤興趣訊號的來源。執行 HTTP POST：

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

然後將這個事件來源群組分享至任何廣告帳戶。這些廣告帳戶會向這些事件來源產生的廣告受眾放送廣告。作出 HTTP POST：

curl \
  -F 'accounts=['

第 4 步：建立廣告受眾

此時您已設定像素或應用程式事件的訊號，並與事件來源群組及地產目錄建立聯繫。如要指定對您樓盤有興趣的用戶，請建立用戶動態廣告受眾。加入或排除根據意圖訊號產生的廣告受眾中的用戶。就像網站自訂廣告受眾一樣，您亦可以套用其他基於規則的篩選條件，以自訂廣告受眾。查看自訂廣告受眾。

如要設定新的廣告受眾，請向 /act_<AD_ACCOUNT_ID>/customaudiences 作出 HTTP POST。

必要參數

欄位名稱	資料類型	說明
`name`	`string`	廣告受眾名稱。
`subtype`	`enum {CLAIM}`	自訂廣告受眾類型。必須設為 `CLAIM`。
`claim_objective`	`enum {HOME_LISTING}`	廣告受眾目標。必須設為 `HOME_LISTING`。
`event_source_group`	`id`	建立廣告受眾的事件來源群組。
`inclusions`	`object[]`	JSON 物件陣列。列出讓用戶有資格成為此受眾的每個意圖訊號。
加入：`event`（必填）	`enum { Search, ViewContent, InitiateCheckout, Purchase }`	訊號的事件名稱。用於加入廣告受眾：`{'event': 'Search', …}`。
加入：`retention`（必填）	`object`	自事件接收起算的最短和最長時間。判斷是否考慮加入事件。範例：`{…, 'retention': {'min_seconds': 0, 'max_seconds': 259200}, …}`。留存時間最少須為 4 小時。
加入：`count`	`JSON` 運算子	事件觸發的次數。您可以同時使用相等及數字比較運算子，例如 `{…'count': {'lte': 3}, …}`。

選用參數

欄位名稱	資料類型	說明
`content_type`	`enum {HOME_LISTING}`	用於建立這個廣告受眾的訊號類型。
`description`	`string`	廣告受眾描述。
`exclusions`	`object[]`	JSON 物件陣列，列出用於將某個用戶從廣告受眾中排除的每個意圖訊號。
排除：`event`（必填）	`enum { Search, ViewContent, InitiateCheckout, Purchase }`	用於排除的訊號的事件名稱：`{'event': 'Search', …}`。
排除：`retention`（必填）	`object`	自事件接收起算的最短和最長時間。判斷是否考慮排除事件，例如 `{…, 'retention': {'min_seconds': 0, 'max_seconds': 259200}, …}`。留存時間最少須為 4 小時。
`rule`	`object`	網站自訂廣告受眾的廣告受眾規則。在處理任何 `inclusions` 或 `exclusions` 操作前，請按這些規則篩選事件串流。查看可用的特定欄位名單。您可以將這些欄位與任何標準 `JSON`廣告受眾規則運算子一起使用。
規則：`home_listing_set_id`（必填）	`object`	樓盤組合編號：`{'eq': '1234'}}`

例如，如要建立指定曾在過去 14 天瀏覽或購物之用戶的廣告受眾：

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=