建置房地產廣告受眾

從行銷 API 15.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`	◉	有人針對商品資訊聯絡代理商

◉ 必填：若缺少這些參數，廣告將無法運作。
◎ 建議：非嚴格要求，但可為廣告提供更好的建議，以及更多的目標設定選項。請盡可能提供更多資訊。
◯ 非必填：非必填且可略過。

例如，若要使用 FB 像素或應用程式事件回報商品資訊的 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=