进阶赋能型目录广告

构建房地产受众

从市场营销 API v15.0 开始，您将无法再创建特殊广告受众。详情请参阅特殊广告受众。

如要构建房地产受众，请按照以下步骤操作：

第 1 步：设置房地产事件的用户信号

以下是您可以从自己的网站或应用发送的预定义事件名称，您可通过这些名称衡量营销活动的成效，捕获受众的意向。请参阅 Facebook Pixel 像素代码设置。

房地产广告需要从网站 Pixel 像素代码和移动应用获取以下标准事件：

Pixel 像素代码事件应用事件要求级别描述

Search

fb_mobile_search

◉

有人搜索了房产交易帖

ViewContent

fb_mobile_content_view

◉

有人查看了特定的交易帖

InitiateCheckout

fb_mobile_initiated_ checkout

◉

有人收藏、点赞了交易帖或对交易帖表现出了独特兴趣

Purchase

fb_mobile_purchase

◉

有人就交易帖事项联系过客服人员

  • ◉ 必要：如果没有这些参数，广告将无法发挥作用。
  • ◎ 推荐：并非必要项，但可以为您的广告提供更好的建议和更多定位选项，因此请尽量多提供。
  • ◯ 可选：非必要项，可以忽略。

例如，如需使用 Facebook Pixel 像素代码或应用事件报告交易帖的 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
  }
];

在确定应触发哪些事件后，您应该提供每个事件的参数。

事件参数

下表列出了必要参数和推荐参数。

Pixel 像素代码参数移动参数要求级别

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(min), int(max)]

所选浴室数量范围：[1, 2]

preferred_beds_range

[int(min), int(max)]

所选卧室数量范围：[1, 2]

preferred_price_range

[float(min), float(max)]

价格范围：[1000.99, 2000.99]

property_type

string

必须为 apartment、condo、house、land、manufactured、other 或 townhouse。

region

string

感兴趣的州/省、地区或区域：'California'

第 2 步：将用户信号与目录关联

将您的事件源与每个交易帖目录相关联。请参阅商务管理平台的目录页面。如要通过发送事件的 API 选择 Pixel 像素代码和应用，请执行 HTTP POST：

curl \
  -F '0=

指定以下参数：

字段名称数据类型描述

external_event_sources（必要）

int[]

要与目录相关联的 Pixel 像素代码编号和应用编号的清单。

第 3 步：创建和分享房地产事件源组

如要构建受众，您公司的管理员必须创建事件源组。此组将包括发送交易帖兴趣信号的所有源。执行 HTTP POST：

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

然后，可以将此事件源组分享给将向这些事件源生成的受众投放广告的任何广告帐户。执行 HTTP POST：

curl \
  -F 'accounts=['

第 4 步：创建受众

此时，您已对来自 Pixel 像素代码或应用事件的信号进行设置并将其与事件源组和您的房地产目录相关联。如需定位对您的交易帖感兴趣的用户，请创建用户动态受众。根据意向信号在受众中包含或排除用户。与对网站自定义受众的操作方式相同，您还可以应用其他基于规则的筛选条件来自定义受众。请参阅自定义受众。

如要设置新的受众，请向 /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=