要发布房地产的电商信息,您的企业需要通过验证。
步骤 1:创建房源目录。
步骤 2:设置房源定价。
步骤 3:更新选项。
步骤 4:将房源目录筛选为房源集。
步骤 5:发送线下转化(可选)
步骤 6:构建房地产受众。不同于用户发布的房源,对于合作伙伴集成,潜客信息通过潜客信息表单而不是通过 Messenger 聊天发送给合作伙伴。详细了解如何获取商业潜在客户信息。
步骤 7:为房源创建并投放广告。
步骤 8:获取投放信息,了解 Facebook 用户与广告互动的情况。请参阅广告成效分析。
步骤 9:使用调试工具诊断和解决问题。请参阅进阶赋能型目录广告调试工具。
您的目录应该包含您想要推广的物业清单。请参阅目录参考文档。
如需为进阶赋能型目录广告创建房源目录,请将 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 平台文档。
房源包含物业的信息,如房源编号、名称、可订状态、描述、地址、卧室数、卫生间数等。您可以通过您的公司上传或获取一组房源。房源项是在您的网站或应用中展示的一套物业。
您的目录中可以包含用于所有物业的单个信息库,也可以包含多个信息库,其中一个信息库表示一个国家/地区的物业、一个房地产代理机构或一个房地产经纪人。
对于进阶赋能型目录广告,您必须以下面的格式提供房源信息库:
文件格式 | 描述 | 示例文件 |
---|---|---|
XML | 通常由自动信息库提供程序系统生成。根 | |
CSV、TSV | 第一行必须按照赋值顺序列出选定的字段名称。然后,后面的每行为每个房源提供相应的值。嵌套字段或多值字段(如 image)可使用 JSON 编码值表示,也可以通过由 JSON 路径语法标记的一组“平展”纯文本列表示,例如: | 下载 (CSV) |
对于电商,您必须以 XML 格式提供房源信息库:
文件格式 | 描述 |
---|---|
XML | 通常由自动信息库提供程序系统生成。根 |
CSV、TSV、JSON | 目前不支持这些格式。 |
我们的信息库分析程序可以自动检测 UTF8
、UTF16
或 UTF32
文本编码,并且在出现意外字节顺序的情况下,会回到 LATIN1
。
<?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>
以下支持的字段可用于要添加到商品目录中的商品。
有关本地化目录,请参阅房源支持的字段。
我们的信息库分析程序可以自动检测 UTF8
、UTF16
或 UTF32
文本编码,并且在出现意外字节顺序的情况下,会回到 LATIN1
。虽然能够以任何语言提供字段值中的文本,但字段名称必须完全按下方所示以英语提供。
字段名称和类型 | 描述 |
---|---|
类型:字符串 | 对于进阶赋能型目录广告和电商为必需参数。 唯一的房源(公寓/产权公寓)编号;可能的最精细编号。 示例: |
类型:字符串 | 不适用于进阶赋能型目录广告。对于商是可选项。 建筑或公寓的独特 ID。必须在组内是独特的。 |
类型:字符串 | 对于进阶赋能型目录广告和电商为必需参数。 房源标题。示例: |
类型:字符串 | 对于进阶赋能型目录广告和电商为必需参数。 房源目前的可订状态。支持的值为: |
类型:字符串 | 对于进阶赋能型目录广告和电商为必需参数。 物业的街道地址,必须可解析为相应位置。 请参阅地址对象参数。 示例: |
类型:字符串 | 对于进阶赋能型目录广告和电商为必需参数。 物业所在的城市。 请参阅地址对象参数。 示例: |
类型:字符串 | 对于进阶赋能型目录广告和电商为必需参数。 物业所在的州/省、县、区。 请参阅地址对象参数。 示例: |
类型:对象 | 对于进阶赋能型目录广告和电商为必需参数。 物业所在的国家/地区。 请参阅地址对象参数。 示例: |
类型:字符串 | 对于进阶赋能型目录广告和电商为必需参数。 物业所在的国家/地区。 请参阅地址对象参数。 示例: |
类型:浮点数 | 对于进阶赋能型目录广告和电商为必需参数。 房源的纬度。 示例: |
类型:浮点数 | 对于进阶赋能型目录广告和电商为必需参数。 房源的经度。 示例: |
类型:字符串 | 进阶赋能型目录广告的必要参数。可选,但强烈推荐用于电商。 允许的社区上限:20 物业的房源社区。可以有多个社区。如果不止一个社区,则应为各个类型添加额外的栏,并在各个栏名称中使用 JSON 路径语法标明社区编号。 示例: |
类型:字符串 | 对于进阶赋能型目录广告和电商为必需参数。 物业的出售或出租价格。价格由费用和[三位数 ISO 货币代码](https://en.wikipedia.org/wiki/ISO_4217?fbclid=IwAR0_xYfUmL3kIUA6sMeEaFAzbJa4MLeMiPDPrftFSX6wkKiTXxPinC-5j70">组成,并在这二者之间加上一个空格。 示例: |
类型:对象 | 对于进阶赋能型目录广告和电商为必需参数。 最大图片数:20 最大尺寸:4 MB 广告中使用的图片网址。
示例: 请参阅图片对象参数。 |
类型:字符串 | 对于进阶赋能型目录广告和电商为必需参数。 链接到房源页面。必须是有效网址。 请参阅图片对象参数。 示例: |
类型:字符串 | 进阶赋能型目录广告的可选参数。电商为必需。 字符数上限:5000 物业的描述。 示例: |
类型:浮点数 | 进阶赋能型目录广告的可选参数。电商为必需。 卧室总数。如果是单间,可以为 示例: |
类型:浮点数 | 进阶赋能型目录广告的可选参数。
卫生间数量。对于电商,至少必须是 |
类型:浮点数 | 不适用于进阶赋能型目录广告。对于电商为必需参数。 物业的房间总数。 |
类型:字符串 | 进阶赋能型目录广告的可选参数。 物业类型。对于进阶赋能型目录广告,支持的值包括: |
类型:字符串 | 进阶赋能型目录广告的可选参数。 房源类型。对于进阶赋能型目录广告,支持的值包括: |
类型:整数 | 不适用于进阶赋能型目录广告。对于电商为必需参数。 房源平面图的面积或空间。 |
类型:字符串 | 不适用于进阶赋能型目录广告。对于电商为必需参数。 楼层面积值的单位(平方英尺或平方米)。支持的值: |
类型:字符串 | 不适用于进阶赋能型目录广告。对于电商为可选参数。 空调的类型。支持的值: |
类型:字符串 | 不适用于进阶赋能型目录广告。对于电商为可选参数。 物业中可用的家具类型。支持的值: |
类型:字符串 | 不适用于进阶赋能型目录广告。对于电商为可选参数。 物业中安装的暖气类型。支持的值: |
类型:字符串 | 不适用于进阶赋能型目录广告。对于电商为可选参数。 洗衣设施的类型。支持的值: |
类型:整数 | 对于进阶赋能型目录广告和电商为可选参数。 可出租的单元(公寓、产权公寓)总数。 示例: |
类型:字符串 | 不适用于进阶赋能型目录广告。对于电商为可选参数。 物业中可用的停车场类型。支持的值: |
类型:字符串 | 不适用于进阶赋能型目录广告。对于电商为可选参数。 合作伙伴公司是否已核实房源。支持的值: |
类型:字符串 | 物业建造年份,使用YYYY 格式的 4 位数年份。 示例:1994。 |
类型:字符串 | 不适用于进阶赋能型目录广告。对于商是可选项。 显示物业中允许的宠物: |
类型:对象 | 房源可订日期和价格的列表。提供价值时,Facebook 可以根据可订日期推荐房源,并在您的广告中动态显示相关价格。 请参阅可订日期对象参数 |
类型:对象 | 房源的应用链接。 |
类型:字符串 | 控制目录中的商品是在展示中还是已归档。仅展示中的商品可对您的广告受众以及店铺或其他任何渠道的用户显示。支持的值: 示例: 注意:部分合作伙伴平台(如 Shopify)将商品同步到您的目录时可能附带 staging 状态,其作用与 此字段之前被称为 |
请访问 Marketplace 平台文档,了解电商的特定国家/地区的必需字段。
字段名称和类型 | 描述 |
---|---|
类型:字符串 | 对于进阶赋能型目录广告和电商为必需参数。 图片源网址。请遵循以下图片规格:
|
类型:字符串 | 对于进阶赋能型目录广告和电商为可选参数。 附加到图片上的标签,用于说明图片内容。一张图片可以与多个标签相关联。 示例:
|
字段名称和类型 | 描述 |
---|---|
类型:字符串 | 必需。 酒店的街道地址。 示例: |
类型:字符串 | 必需。 酒店所在的城市。 示例: |
类型:字符串 | 必需。 酒店所在的州/省、县、区。 示例: |
类型:字符串 | 必需。 酒店所在的国家/地区。 示例: |
类型:字符串 | 酒店的邮编。必需,除非对应的国家/地区没有邮编系统。 示例: |
借助 available_dates_price_config
,您可以提供给定日期范围内每个物业的可订状态和价格。当您在这一领域中包含日期范围时,Facebook 将这种可订状态纳入我们的产品推荐中,并试图显示某人在您网站上搜索的日期可订的房源。或者,如果您包含定价,我们也可以在您广告创意中显示特定日期的价格。要启用此功,您必须在 Pixel 像素代码事件中向 Facebook 发送 lease_start_date
和 lease_end_date
。
字段名称和类型 | 描述 |
---|---|
类型:字符串 | 如果提供了 以 ISO-8601 格式表示的可订日期范围的开始;包括开始日期。如果您只提供 示例: |
类型:字符串 | 如果提供了 以 ISO-8601 格式表示的可订日期范围的结束;不包括结束日期。如果您只提供 示例: |
类型:字符串 | 在这个时间范围内的房源价格(以整数表示)。 示例:如果房源为 |
类型:字符串 | 如果提供了 ISO-4217 货币代码。 示例: |
类型:字符串 | 指定价格的住宿时间。 允许的值为: |
这是房源的可订状态及其在 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 使用来自应用链接的信息显示正确的深度链接。如需在广告中展示深度链接,请参阅广告模板 > 进阶赋能型目录广告。
对于进阶赋能型目录广告,您可以通过下列方法使用直接上传来刷新目录中的房源信息。请参阅直接上传信息库参考
示例——您可以手动执行一次性上传:
curl \
-F "url=http://www.example.com/sample_feed.xml" \
-F "access_token=
对于电商,您可以通过设置定期(自动执行)的信息库上传并更新信息库来刷新目录中的房源信息。在 Marketplace 中,我们强烈建议使用定期上传选项。
电商多语言体验。向目录添加次级语言信息库后,您可以通过该目录创建另一个使用次级语言的信息库。当相关受众看到您的房源时,次级信息库中的信息将覆盖默认的语言。
此功能只适用于特定的国家/地区的合作伙伴。请联系您的 Facebook 代表,了解所在市场的可用功能。
这是您在进阶赋能型目录广告中为其投放广告的目录中的一组项。每个房源目录都包含多个房源集。
curl \
-F "name=test set" \
-F 'filter={"availability":{"eq":"for_sale"}}' \
-F "access_token=" \
https://graph.facebook.com/
上述 filter
由下列运算符和数据组成:
运算符 | 筛选类型 |
---|---|
| 包含子字符串(不区分大小写) |
| 不包含子字符串(不区分大小写) |
| 包含子字符串(区分大小写) |
| 不包含子字符串(区分大小写) |
| 等于(不区分大小写) |
| 不等于(不区分大小写) |
| 小于(仅限数字字段) |
| 小于或等于(仅限数字字段) |
| 大于(仅限数字字段) |
| 大于或等于(仅限数字字段) |
数据 | 要筛选的数据 |
---|---|
| 房源可订状态。示例: |
| 房源类型。示例: |
| 物业类型。示例: |
| 房源价格 |
| 名称 |
| 城市 |
| 国家/地区 |
| 区域或州/省 |
| 邮政编码 |
| 床位数量 |
| 卫生间数 |
您可以发送线下转化事件,查看有多少客户在转化前浏览或点击了 Facebook 广告和电商房源;使用线下转化 API 并在步骤 4 中添加以下字段。上传线下事件。
匹配键比对转换和用户。
键 | 描述 |
---|---|
| 邮箱 哈希 |
| 手机号 哈希 |
| 名字 哈希 |
| 姓氏 哈希 |
| Apple 或 Android 广告主编号 哈希 |
| 邮编 哈希 |
| 城市 哈希 |
| 州 哈希 |
| 国家/地区 哈希 |
| 出生日期(DD 格式) 哈希 |
| 出生日期(YYYY 格式) 哈希 |
| 性别 哈希 |
| 年龄 哈希 |
| Marketplace 潜在客户编号 |
自定义数据比对转换与经销商。
字段 | 描述 |
---|---|
| 来自目录上传的 |
| 设为 |
事件详情描述所发生的转化事件。上传频率是每天,活动发生后的 48 小时内。
字段 | 描述 |
---|---|
| 必需 事件类型枚举:
|
| 必需 事件的时间 |
| 必需 租金值。非租赁事件设置为 |
| 必需 货币代码 |