新功能Product Score、4T Segmentation、Price War 和 Broken Size 现已上线。查看新功能
Feedance
Grupo Zap 标志Grupo Zap渠道 · 电商市场和应用
Grupo Zap 集成

向 Grupo Zap 发送
值得展示的商品

Feedance 为您构建 Grupo Zap feed,并添加评分、4T 细分、价格位置和断码等商品级标签,让每个商品都带有自己的效果信号。

Grupo Zap 商品 feed
由 Feedance 生成
XML、CSV 或 JSON 导出每次同步时更新
<item>
  <id>TS-1042</id>
  <title>圆领 T 恤</title>
  <price>49.90 USD</price>
  <availability>in stock</availability>
  <custom_label_0>score_86</custom_label_0>
  <custom_label_1>top</custom_label_1>
  <custom_label_2>best_price</custom_label_2>
  <custom_label_3>size_ok</custom_label_3>
</item>
Feedance 标签,以自定义标签形式写入
Feedance 发送给 Grupo Zap 的内容

每个商品都带有效果信号的商品目录

Grupo Zap 从 feed 中读取您的商品。Feedance 会发送一份完整、有效的 feed,并附上 Grupo Zap 自身无法获得的信号。

Product Scorecustom_label_0基于 1 天、7 天和 30 天内的浏览、加购和购买数据得出的 0 到 100 分评分。
4T 细分custom_label_1根据每个商品自身的流量和回报,划分为 Top、Tolerable、Tranquil 或 Toxic。
Price Warcustom_label_2与指定竞争对手相比,价格更低、持平或更高。
Broken Sizecustom_label_3标记大部分尺码已售罄的款式。
创意素材image_link来自 Creative Suite 的品牌化图片,包含 feed 中的价格和促销活动信息。
使用方式: 按这些标签拆分广告系列、商品组或商品组合,例如只投放 Top 商品,或排除 Toxic 商品和断码款式后投放其余全部商品。标签位置可自行配置。Feedance 不会更改您的出价或预算。

什么是 Grupo ZAP?

Grupo ZAP 是 OLX Group 在巴西的房地产业务板块,运营着巴西最大的两个房源信息门户网站:ZAP Imóveis 和 Viva Real。房地产中介机构、经纪人和 CRM 提供商将其房源库存连接到 Grupo ZAP,这样出售和出租房源就能通过一份数据 Feed 同时出现在这两个门户网站上(根据所签约的套餐,还可能出现在 OLX 分类信息网站上),而无需在每个门户网站上手动录入。

为什么要将房源信息 Feed 连接到 Grupo ZAP?

经纪人或中介无需将同一条房源分别重新录入 ZAP Imóveis、Viva Real 和 OLX,而是由房产管理系统生成一个标准化的 XML 文件,再由 Grupo ZAP 的爬虫按固定计划拉取。在源系统中进行的任何一次更改(新的价格、更新的照片集、标记为已售或已租的房源),都会在下一次抓取时自动同步到每个已连接的门户网站,这正是中介机构选择自动化、而不是手动管理每个门户网站后台的核心原因。

VRSync 取代了旧版 ZAP XML 格式

Grupo ZAP 的开发者文档列出了两种受支持的 XML 架构:旧版“ZAP”格式(文档明确表示该格式处于维护模式),以及当前标准 VRSync,后者“整合了所有新功能”。文档指出,非 VRSync 格式的 Feed 正在逐步淘汰,而且 Grupo ZAP 自己的 XML 验证工具只接受 VRSync 格式的文件。任何新的集成(包括使用 Feed 管理工具构建的集成)都应以 VRSync 为目标,而不是旧格式。

Grupo ZAP 要求使用什么 Feed 格式?

Grupo ZAP 通过轮询架构获取房源:它不接受推送上传,而是定期从您提供的 URL 下载 VRSync XML 文件。根据官方 Guia de Conexão(连接指南),接收端服务器必须满足以下几项具体技术要求:

  1. 允许爬虫的 User-Agent(文档中标识为 VivaRealBot/1.0),否则请求将以 HTTP 403 失败
  2. 通过 HTTPS 提供 Feed,使用有效的非自签名证书,并支持 TLS 1.0–1.2
  3. 在 60 秒连接超时内响应,并在 20 分钟的下载时限内完成文件传输
  4. Feed URL 本身不超过 255 个字符,使用正确的 URL 编码,不含未编码的空格
  5. 如果 URL 链存在重定向,支持最多 100 次同协议重定向

此外,官方 XML 验证工具将可接受的文件大小上限设为 30MB,并会拒绝任何非 VRSync 格式的文件。

VRSync 要求哪些房源属性?

VRSync 架构由 Listing 块和嵌套的 Details 块组成。根据 Grupo ZAP 自己的元素参考文档,以下内容被记录为必填(或根据房产类型有条件必填):

属性元素要求
房源 IDListingID必填,1–50 个字符,每套房产唯一
标题Title必填,10–100 个字符,不得包含 HTML 标签
交易类型TransactionType必填:For Sale、For Rent 或 Sale/Rent
地址/位置Location(Country、State、City、Neighborhood、PostalCode)必填;所有房源都必须填写 PostalCode
照片Media / Item必填,每条房源至少 5 张图片
经纪人联系方式ContactInfo(Name、Email)必填
房产类型PropertyType必填,必须使用标准化的值
描述Description必填,50–3,000 个字符,使用 CDATA,不得包含 HTML 标签
居住面积LivingArea大多数房产类型必填,unit="square metres"
卧室/浴室Bedrooms、Bathrooms住宅类型必填;土地或仓库无需填写
售价或租金ListPrice / RentalPrice出售房源必须填写 ListPrice;出租房源必须填写 RentalPrice;必须带有 currency="BRL" 属性
占地面积LotArea对于土地、农场和牧场,需用其代替 LivingArea

如何将 Grupo ZAP 与 Feedance 连接

Feedance 可以生成并托管 Grupo ZAP 爬虫所轮询的 VRSync XML 文件,将源系统(CRM、ERP 或电子表格)中的房产记录映射到该标准要求的 Header、Listing 和 Details 结构中。

  1. 将您的房产数据字段(地址、价格、卧室、浴室、面积、照片、交易类型)映射到相应的 VRSync 元素
  2. 配置所需的条件逻辑,例如仅为土地房源填写 LotArea,或仅为 Rent/Sale-Rent 房源填写 RentalPrice,因为 VRSync 的必填字段因房产类型而异
  3. 在符合 Grupo ZAP 连接要求(有效证书、允许 User-Agent、URL 不超过 255 个字符)的稳定 HTTPS URL 上发布 Feed
  4. 通过 Canal Pro 或您的客户代表向 Grupo ZAP 注册该 Feed URL,让其爬虫开始轮询
  5. 监控 Grupo ZAP 返回的集成报告(根据其文档,通过 Canal Pro、电子邮件或 webhook 发送),并在源头修正任何被拒绝的房源

由于这是一种专门的、深度嵌套的房地产架构,而不是扁平的商品目录,因此与标准电商购物 Feed 相比,前期需要投入更多的字段映射工作。

Feed 应该多久更新一次?

Grupo ZAP 自己的文档说明,XML 文件每天处理两次,间隔约 12 小时;这是基于抓取的拉取方式,而不是推送,因此比该周期更频繁地重新生成 Feed 并没有好处。关键在于 Feed 要在每个抓取窗口之前反映最新的实际情况(价格、可用性、已售/已租状态),因为过时的 Feed 会让已不可用的房产继续上架,或让更新后的价格无法同步,直到下一次 12 小时拉取。

常见的 Feed 错误

Grupo ZAP 的文档及其 XML 验证工具指出了导致房源被拒绝的几个常见原因:

  1. 金额和面积值使用了货币符号、千位分隔符或小数格式,例如“R$560.000,00”或“32,20”,而不是纯整数
  2. 价格元素缺少必需的 currency="BRL" 属性,或面积元素缺少 unit="square metres" 属性
  3. Description 元素为空或缺失(<Description/>),或描述不在 50–3,000 个字符的范围内
  4. 缺少 LivingArea(土地/农场房源则为 LotArea),验证工具会将其视为严重错误
  5. 由于托管服务器阻止了爬虫的 User-Agent 而返回 HTTP 403 响应
  6. Feed URL 超过 255 个字符,或包含未编码的字符/空格
  7. 文件不是有效的 VRSync XML,或超过验证工具的 30MB 上限

优化技巧

以下是通常能提升房源在房地产门户网站上表现的通用 Feed 质量实践(并非 Grupo ZAP 的具体说明):

  1. 不要只满足 5 张图片的最低要求:更多的照片,并按合理顺序排列(将外观或最好的房间放在最前面),通常能提升房源在门户网站上的互动
  2. 撰写完整、准确的描述,充分利用可用的字符范围,而不是只写到最低要求,因为仅 50 个字符的单薄描述即使通过验证,也不太可能带来良好的转化
  3. 在您这一端让价格和状态字段与源系统实时同步,确保下一次抓取总能拉取到最新数据,而不是过时的快照
  4. 尽可能填写可选的差异化信息(虚拟看房链接、精确的经纬度、街区/区域详情),帮助买家筛选并找到房源

常见问题

Feedance 是否专门支持 VRSync 格式?Feedance 可以生成映射到 Grupo ZAP 文档所定义的 VRSync 元素结构的 XML Feed;旧版 ZAP 格式已被弃用,不应用于新的集成。

我可以将同一个 Feed 发送到 ZAP Imóveis、Viva Real 和 OLX 吗?Grupo ZAP 自己的资料表示,单个 XML Feed 会被分发到您签约套餐所包含的门户网站,而不需要为每个门户网站提供单独的 Feed。

我如何知道某条房源被拒绝了?Grupo ZAP 表示会发送集成报告;对于持续超过三天的错误,还会直接发送电子邮件通知,详细说明失败原因。

这与 Google Merchant Center 或 Meta 商品 Feed 是同一类 Feed 吗?不是。VRSync 是一种房地产专用架构,具有嵌套的 Location、Media、ContactInfo 和 Details 结构,且必填字段取决于房产类型,在结构上与扁平的电商商品 Feed 不同,尽管两者的根本目标(一个源 Feed,多个目标平台)相似。

关于 Grupo Zap

Grupo ZAP 是 OLX Group 在巴西的房地产业务。它运营着该国最大的两个房产门户网站 ZAP Imóveis 和 Viva Real,人们在这里搜索要购买或租赁的住宅、公寓和商业地产。

房地产中介、经纪人和房产软件提供商将房源发送给 Grupo ZAP,使房产出现在这两个门户网站上;根据所签订的套餐,还可以出现在 OLX 分类广告中。一个数据源即可取代在每个门户后台手动重复录入同一房源。

房源以 VRSync 格式的 XML Feed 交付,Grupo ZAP 将其列为当前标准;较早的 ZAP XML 格式已进入维护模式。Grupo ZAP 不接受推送式上传。其爬虫按固定计划从 HTTPS URL 下载 Feed,因此服务器必须允许该爬虫访问、快速响应并稳定提供文件。

对中介而言,Feed 质量会影响房源的表现。正确的价格、地址、房产类型、面积、房间数和配套设施有助于房源出现在正确的搜索中,优质的照片能吸引更多咨询,而及时下架已售出或已出租的房产则能保持房源组合的可信度,避免浪费线索。

看看哪些
商品真正带来收益。

连接您的 feed 和 GA4,我们会在您自己的商品目录上展示 Product Score、4T、Price War 和 Broken Size。