房地产广告 - 入门指南

要发布房地产的电商信息,您的企业需要通过验证

步骤 1:创建房源目录

步骤 2:设置房源定价

步骤 3:更新选项

步骤 4:将房源目录筛选为房源集

步骤 5:发送线下转化(可选)

步骤 6:构建房地产受众。不同于用户发布的房源,对于合作伙伴集成,潜客信息通过潜客信息表单而不是通过 Messenger 聊天发送给合作伙伴。详细了解如何获取商业潜在客户信息

步骤 7:为房源创建并投放广告

步骤 8:获取投放信息,了解 Facebook 用户与广告互动的情况。请参阅广告成效分析

步骤 9:使用调试工具诊断和解决问题。请参阅进阶赋能型目录广告调试工具

步骤 1:创建房源目录

对于进阶赋能型目录广告

您的目录应该包含您想要推广的物业清单。请参阅目录参考文档

如需为进阶赋能型目录广告创建房源目录,请将 vertical 设置为 home_listings

curl \
  -F 'name=Home Listing Catalog Name' \
  -F 'vertical=home_listings' \
  -F 'access_token=<ACCESS TOKEN>' \
  https://graph.facebook.com/<API_VERSION>

如需使用目录 API,您需要市场营销 API 访问级别并通过使用商务管理平台创建第一个目录来接受服务条款

对于电商

有关如何创建电商目录的说明,请访问 Marketplace 平台文档

步骤 2:设置房源和价格

房源包含物业的信息,如房源编号、名称、可订状态、描述、地址、卧室数、卫生间数等。您可以通过您的公司上传或获取一组房源。房源项是在您的网站或应用中展示的一套物业。

支持的信息库格式

您的目录中可以包含用于所有物业的单个信息库,也可以包含多个信息库,其中一个信息库表示一个国家/地区的物业、一个房地产代理机构或一个房地产经纪人。

对于进阶赋能型目录广告,您必须以下面的格式提供房源信息库:

文件格式描述示例文件

XML

通常由自动信息库提供程序系统生成。根 <listings> XML 节点包含一组 <listing> 节点,每个节点都表示一个房源。文件必须以有效的 <?xml 声明标签开头。

下载

CSV、TSV

第一行必须按照赋值顺序列出选定的字段名称。然后,后面的每行为每个房源提供相应的值。嵌套字段或多值字段(如 image)可使用 JSON 编码值表示,也可以通过由 JSON 路径语法标记的一组“平展”纯文本列表示,例如:image[0].urlimage[0].tag[0]image[0].tag[1]

下载 (CSV)

对于电商,您必须以 XML 格式提供房源信息库:

文件格式描述

XML

通常由自动信息库提供程序系统生成。根 <listings> XML 节点包含一组 <listing> 节点,每个节点都表示一个房源。文件必须以有效的 <?xml 声明标签开头。

CSV、TSV、JSON

目前不支持这些格式。

我们的信息库分析程序可以自动检测 UTF8UTF16UTF32 文本编码,并且在出现意外字节顺序的情况下,会回到 LATIN1

信息库 XML 示例

<?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>

支持的字段 - 房源

以下支持的字段可用于要添加到商品目录中的商品。

有关本地化目录,请参阅房源支持的字段

我们的信息库分析程序可以自动检测 UTF8UTF16UTF32 文本编码,并且在出现意外字节顺序的情况下,会回到 LATIN1。虽然能够以任何语言提供字段值中的文本,但字段名称必须完全按下方所示以英语提供。

字段名称和类型描述

home_listing_id

类型:字符串

对于进阶赋能型目录广告和电商为必需参数

唯一的房源(公寓/产权公寓)编号;可能的最精细编号。

示例:FB_home_1234

home_listing_group_id

类型:字符串

不适用于进阶赋能型目录广告。对于商是可选项

建筑或公寓的独特 ID。必须在组内是独特的。

name

类型:字符串

对于进阶赋能型目录广告和电商为必需参数

房源标题。示例:Modern Eichler in Green Oaks

availability

类型:字符串

对于进阶赋能型目录广告和电商为必需参数

房源目前的可订状态。支持的值为:for_salefor_rentsale_pendingrecently_soldoff_marketavailable_soon。对于电商,唯一支持的值是 'for_rent'。

address

类型:字符串

对于进阶赋能型目录广告和电商为必需参数

物业的街道地址,必须可解析为相应位置。

请参阅地址对象参数

示例:1 Hacker Way

address.city

类型:字符串

对于进阶赋能型目录广告和电商为必需参数

物业所在的城市。

请参阅地址对象参数

示例:Menlo Park

address.region

类型:字符串

对于进阶赋能型目录广告和电商为必需参数

物业所在的州/省、县、区。

请参阅地址对象参数

示例:Menlo Park

address.country

类型:对象

对于进阶赋能型目录广告和电商为必需参数

物业所在的国家/地区。

请参阅地址对象参数

示例:United States

address.postal_code

类型:字符串

对于进阶赋能型目录广告和电商为必需参数

物业所在的国家/地区。

请参阅地址对象参数

示例:United States

latitude

类型:浮点数

对于进阶赋能型目录广告和电商为必需参数

房源的纬度。

示例:37.484100

longitude

类型:浮点数

对于进阶赋能型目录广告和电商为必需参数

房源的经度。

示例:-122.148252

neighborhood

类型:字符串

进阶赋能型目录广告的必要参数。可选,但强烈推荐用于电商

允许的社区上限:20

物业的房源社区。可以有多个社区。如果不止一个社区,则应为各个类型添加额外的栏,并在各个栏名称中使用 JSON 路径语法标明社区编号。

示例:neighborhood[0]; neighborhood[1]

price

类型:字符串

对于进阶赋能型目录广告和电商为必需参数

物业的出售或出租价格。价格由费用和[三位数 ISO 货币代码](https://en.wikipedia.org/wiki/ISO_4217?fbclid=IwAR0_xYfUmL3kIUA6sMeEaFAzbJa4MLeMiPDPrftFSX6wkKiTXxPinC-5j70">组成,并在这二者之间加上一个空格。

示例:13,999 USD

image

类型:对象

对于进阶赋能型目录广告和电商为必需参数

最大图片数:20

最大尺寸:4 MB

广告中使用的图片网址。

  • 轮播广告中宽高比为 1:1 的正方形图片像素应为 600x600。
  • 单图片广告的图片像素至少应达到 1200x630 像素。
  • 对于电商,第一张照片会作为封面图片显示在电商信息库中。

示例:image[0].urlimage[0].tag[0]

请参阅图片对象参数

url

类型:字符串

对于进阶赋能型目录广告和电商为必需参数

链接到房源页面。必须是有效网址。

请参阅图片对象参数

示例:http://www.realestate.com

description

类型:字符串

进阶赋能型目录广告的可选参数。电商为必需

字符数上限:5000

物业的描述。

示例:Beautiful 3BD home available in Belmont

num_beds

类型:浮点数

进阶赋能型目录广告的可选参数。电商为必需

卧室总数。如果是单间,可以为 0

示例:2

num_baths

类型:浮点数

进阶赋能型目录广告的可选参数

卫生间数量。对于电商,至少必须是 1

num_rooms

类型:浮点数

不适用于进阶赋能型目录广告。对于电商为必需参数。

物业的房间总数。

property_type

类型:字符串

进阶赋能型目录广告的可选参数

物业类型。对于进阶赋能型目录广告,支持的值包括:apartmentcondohouselandmanufacturedtownhouseother。对于电商,支持的值包括:apartmentbuilder_floorcondohousehouse_in_condominiumhouse_in_villaloftpenthousestudiotownhouseother

listing_type

类型:字符串

进阶赋能型目录广告的可选参数

房源类型。对于进阶赋能型目录广告,支持的值包括:for_rent_by_agentfor_rent_by_ownerfor_sale_by_agentfor_sale_by_ownerforeclosednew_constructionnew_listing。对于电商,支持的值包括:for_rent_by_agentfor_rent_by_owner

area_size

类型:整数

不适用于进阶赋能型目录广告。对于电商为必需参数。

房源平面图的面积或空间。

area_unit

类型:字符串

不适用于进阶赋能型目录广告。对于电商为必需参数。

楼层面积值的单位(平方英尺或平方米)。支持的值:sq_ftsq_m

ac_type

类型:字符串

不适用于进阶赋能型目录广告。对于电商为可选参数。

空调的类型。支持的值:centralothernone

furnish_type

类型:字符串

不适用于进阶赋能型目录广告。对于电商为可选参数。

物业中可用的家具类型。支持的值:furnishedsemi-furnishedunfurnished

heating_type

类型:字符串

不适用于进阶赋能型目录广告。对于电商为可选参数。

物业中安装的暖气类型。支持的值:centralgaselectricradiatorothernone

laundry_type

类型:字符串

不适用于进阶赋能型目录广告。对于电商为可选参数。

洗衣设施的类型。支持的值:in_unitin_buildingothernone

num_units

类型:整数

对于进阶赋能型目录广告和电商为可选参数

可出租的单元(公寓、产权公寓)总数。

示例:0

parking_type

类型:字符串

不适用于进阶赋能型目录广告。对于电商为可选参数。

物业中可用的停车场类型。支持的值:garagestreetoff-streetothernone

partner_verification

类型:字符串

不适用于进阶赋能型目录广告。对于电商为可选参数。

合作伙伴公司是否已核实房源。支持的值:verifiednone

year_built

类型:字符串

物业建造年份,使用YYYY 格式的 4 位数年份。

示例:1994。

pet_policy

类型:字符串

不适用于进阶赋能型目录广告。对于商是可选项

显示物业中允许的宠物:catdogallnone

available_dates_price_config

类型:对象

房源可订日期和价格的列表。提供价值时,Facebook 可以根据可订日期推荐房源,并在您的广告中动态显示相关价格。

请参阅可订日期对象参数

applink

类型:对象

房源的应用链接。

status

类型:字符串

控制目录中的商品是在展示中还是已归档。仅展示中的商品可对您的广告受众以及店铺或其他任何渠道的用户显示。支持的值:activearchived。默认情况下,商品处于“在售”状态。详细了解如何归档商品


示例:active


注意:部分合作伙伴平台(如 Shopify)将商品同步到您的目录时可能附带 staging 状态,其作用与 archived 相同。

此字段之前被称为 visibility。虽然之前的字段名称仍受支持,但建议您使用新名称。

特定国家/地区的必需字段 — 仅适用于电商

请访问 Marketplace 平台文档,了解电商的特定国家/地区的必需字段

图片对象参数


字段名称和类型描述

url

类型:字符串

对于进阶赋能型目录广告和电商为必需参数

图片源网址。请遵循以下图片规格:

  • 所有图片必须为 JPG、GIF 或 PNG 格式。

  • 对于轮播广告和精品栏广告:以正方形 (1:1) 格式显示图片。图片大小不得低于 500 x 500 像素。我们推荐使用 1024 x 1024 像素,以展现最佳效果。

  • 对于单张图片广告:以 1.91:1 宽高比格式显示图片。图片大小不得低于 500 x 500 像素。我们推荐使用 1200 x 628 像素,以展现最佳效果。

tag

类型:字符串

对于进阶赋能型目录广告和电商为可选参数

附加到图片上的标签,用于说明图片内容。一张图片可以与多个标签相关联。

示例:Fitness CenterSwimming Pool

INSTAGRAM_STANDARD_PREFERRED - 让广告主可以将信息库中的特定图片标记为用于 Instagram 默认图片。此标签区分大小写。

地址对象参数


字段名称和类型描述

addr1

类型:字符串

必需

酒店的街道地址。

示例:675 El Camino Real

city

类型:字符串

必需

酒店所在的城市。

示例:Palo Alto

region

类型:字符串

必需

酒店所在的州/省、县、区。

示例:California

country

类型:字符串

必需

酒店所在的国家/地区。

示例:United States

postal_code

类型:字符串

酒店的邮编。必需,除非对应的国家/地区没有邮编系统。

示例:94125NW1 3FG


可订日期价格配置

借助 available_dates_price_config,您可以提供给定日期范围内每个物业的可订状态和价格。当您在这一领域中包含日期范围时,Facebook 将这种可订状态纳入我们的产品推荐中,并试图显示某人在您网站上搜索的日期可订的房源。或者,如果您包含定价,我们也可以在您广告创意中显示特定日期的价格。要启用此功,您必须在 Pixel 像素代码事件中向 Facebook 发送 lease_start_datelease_end_date

可订日期对象参数


字段名称和类型描述

start_date

类型:字符串

如果提供了 end_date,则为可选

以 ISO-8601 格式表示的可订日期范围的开始;包括开始日期。如果您只提供 start_date,那么 end_date 默认为该日期起的一年后。

示例:YYYY-MM-DD,如 2018-01-01

end_date

类型:字符串

如果提供了 start_date 则为可选

以 ISO-8601 格式表示的可订日期范围的结束;不包括结束日期。如果您只提供 end_date,那么 start_date 默认为当前日期。

示例:YYYY-MM-DD,如 2018-02-01

rate

类型:字符串

在这个时间范围内的房源价格(以整数表示)。

示例:如果房源为 $100.00 USD,则为 10000

currency

类型:字符串

如果提供了 rate,则为必需。

ISO-4217 货币代码。

示例:USDGBP 等。

interval

类型:字符串

指定价格的住宿时间。

允许的值为:nightlyweeklymonthlysale

这是房源的可订状态及其在 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",
    },
]

商品深度链接

按照应用链接文档的说明,在信息库中提供深度链接。信息库中的深度链接信息优先于 Facebook 借助网络爬虫通过应用链接元数据收集的任何信息。

如果您已通过应用链接获得深度链接信息,则无需指定此数据。Facebook 使用来自应用链接的信息显示正确的深度链接。如需在广告中展示深度链接,请参阅广告模板 > 进阶赋能型目录广告

步骤 3:更新选项

进阶赋能型目录广告

对于进阶赋能型目录广告,您可以通过下列方法使用直接上传来刷新目录中的房源信息。请参阅直接上传信息库参考

示例——您可以手动执行一次性上传:

curl \
  -F "url=http://www.example.com/sample_feed.xml" \
  -F "access_token=

电商

对于电商,您可以通过设置定期(自动执行)的信息库上传并更新信息库来刷新目录中的房源信息。在 Marketplace 中,我们强烈建议使用定期上传选项。

设置定期上传目录数据信息库

  1. 前往电商管理工具
  2. 点击数据源
  3. 点击添加数据源
  4. 点击使用数据信息库,然后点击下一步
  5. 点击定期上传
  6. 选择您希望 Facebook 检查数据信息库更新的频率:每日每小时每周。如果您选择每小时每周作为频率,还可以指定何时重复执行上传。
  7. 输入信息库的直接网址。可以使用 HTTP、HTTPS、FTP 或 SFTP 的网址。注意:网址应直接指向您的数据信息库文件,否则上传可能会失败。
  8. (选填)输入数据信息库提供者的用户名和密码。这不同于用来访问 Facebook 广告帐户的用户名和密码。
  9. 输入数据信息库名称。
  10. 选择数据信息库的货币类型。如果您在数据信息库文件中没有指定货币类型,则它将用于数据信息库。
  11. 点击下一步
  12. 检查数据信息库文件并修复任何错误。如果文件中缺少任何必要的列,或者有 Facebook 不识别的列,您可以这里将它们映射到相应的列。此处映射的栏将被保存以供后续上传数据信息库使用。
  13. 点击下一步

上传多语言信息库

电商多语言体验。向目录添加次级语言信息库后,您可以通过该目录创建另一个使用次级语言的信息库。当相关受众看到您的房源时,次级信息库中的信息将覆盖默认的语言。

此功能只适用于特定的国家/地区的合作伙伴。请联系您的 Facebook 代表,了解所在市场的可用功能

  1. 使用数据信息库针对默认语言和国家/地区创建一个目录。
  2. 仅使用房源编号 (home_listing_id) 和需要本地语言覆盖的其他字段(如名称、描述)或其他额外字段创建 XML 文件。要覆盖信息,home_listing_id 必须匹配原始目录数据信息库中的信息。
  3. 添加来自电商管理工具的额外信息库。

    添加来自电商管理工具的额外信息库 [添加房源信息] - [添加语言信息]


  4. 确认同一目录中的 2 个数据源。

步骤 4:将房源目录筛选为房源集

这是您在进阶赋能型目录广告中为其投放广告的目录中的一组项。每个房源目录都包含多个房源集。

curl \
  -F "name=test set" \
  -F 'filter={"availability":{"eq":"for_sale"}}' \
  -F "access_token=" \
  https://graph.facebook.com/

上述 filter 由下列运算符和数据组成:

运算符筛选类型

i_contains

包含子字符串(不区分大小写)

i_not_contains

不包含子字符串(不区分大小写)

contains

包含子字符串(区分大小写)

not_contains

不包含子字符串(区分大小写)

eq

等于(不区分大小写)

neq

不等于(不区分大小写)

lt

小于(仅限数字字段)

lte

小于或等于(仅限数字字段)

gt

大于(仅限数字字段)

gte

大于或等于(仅限数字字段)

数据要筛选的数据

availability

房源可订状态。示例:for_sale

listing_type

房源类型。示例:for_sale_by_agent

property_type

物业类型。示例:house

price

房源价格

name

名称

city

城市

country

国家/地区

region

区域或州/省

postal_code

邮政编码

num_beds

床位数量

num_baths

卫生间数

步骤 5:发送线下转化

您可以发送线下转化事件,查看有多少客户在转化前浏览或点击了 Facebook 广告和电商房源;使用线下转化 API 并在步骤 4 中添加以下字段。上传线下事件

匹配键

匹配键比对转换和用户。

描述

email

邮箱

哈希

phone

手机号

哈希

fn

名字

哈希

ln

姓氏

哈希

madid

Apple 或 Android 广告主编号

哈希

zip

邮编

哈希

ct

城市

哈希

st

哈希

country

国家/地区

哈希

dob

出生日期(DD 格式)

哈希

doby

出生日期(YYYY 格式)

哈希

gen

性别

哈希

age

年龄

哈希

lead_id

Marketplace 潜在客户编号

自定义数据

自定义数据比对转换与经销商。

字段描述

content_ids

来自目录上传的 home_listing_id

content_type

设为 APARTMENT

事件详情

事件详情描述所发生的转化事件。上传频率是每天,活动发生后的 48 小时内。

字段描述

event_name

必需

事件类型枚举:

ViewContent

Search

AddToCart

AddToWishlist

Lead = 打过电话或其他合格的潜在客户

CompleteRegistration = 预约设置

InitiateCheckout = 经销商访问

AddPaymentInfo = 物业查看

Purchase = 已签署租约

Other

event_time

必需

事件的时间

value

必需

租金值。非租赁事件设置为 0

currency

必需

货币代码