Start Strong
Sell Smart
Manage with Ease
Market to Success

Smart Feed：创建通用型 XML 商品 Feed

本指南将介绍如何创建一个可用于多个渠道的通用 XML 商品 Feed。

开始前，请先完成 Smart Feed：功能概览与核心升级 中的准备事项。

开始前准备

在创建商品 Feed 前，请确保以下条件已满足：

  • 已在 SHOPLINE 后台创建并上架商品
  • 商品已勾选「在线商店」

注意： 以下商品不会被同步至 Smart Feed：

若您发现商品未同步，请检查是否符合以下情况：

  • 已删除或已下架商品
  • 未勾选「在线商店」的商品
  • 被风控标记为不可售的商品
  • 前端被隐藏的商品（通过插件）
  • 自定义商品（如订单内创建或插件生成）
  • 未到上架时间的商品
  • 启用库存追踪且库存为 0 的商品

 

创建通用型 XML Feed

第一步：从 SHOPLINE 同步商品

在 Smart Feed 中，点击 商品管理 >  同步商品，系统将通过 API 拉取商品数据。

使用建议：

当您在 SHOPLINE 后台批量更新商品或调整重点商品信息后，建议手动执行一次同步。

预计同步时间：

  • 不超过 10,000 个款式：约 30 分钟
  • 不超过 50,000 个款式：约 2 小时
注意： 若超过 2 小时仍未完成，请联系客户经理协助处理。。

第二步：连接设置

Smart Feed > 渠道管理 > 渠道连接 > 选择 通用XML > 点击 添加渠道

同一个店铺最多可创建 5 个通用 XML Feed，可用于：

  • 多个渠道共享统一字段规则
  • 同步商品数据至尚未与 Smart Feed 直接对接的媒体渠道
注意： 推荐用于商品 ID 一致的迁移店铺。

设置商品ID格式

点击 添加渠道 后，系统会弹出 设置商品ID格式 弹窗，您可以选择该 Feed 商品 ID 的生成方式：

  • SHOPLINE的商品ID：沿用 SHOPLINE 后台的商品 ID（SPU ID 或 SKU ID），与该渠道现有逻辑一致。
  • 自定义商品ID：上传一份文件，映射您自己的商品 ID 与商品分组 ID（支持 .csv 格式文件，大小不超过 20MB）。若文件中找不到某个 SHOPLINE 商品，系统会改用其 SHOPLINE 商品 ID 进行渲染。
注意： 选择「自定义商品ID」时，页面会提供导入模板文件下载。

点击 下一步 继续。

媒体渠道上报管理（仅限「SHOPLINE的商品ID」）

若您选择 SHOPLINE的商品ID，可以为该 Feed 开启 媒体渠道上报管理。开启后，Smart Feed 会将该 Feed 的商品 ID 与商品数据实时同步至您勾选的渠道（例如 Google、Meta、Pinterest、TikTok、Microsoft），方便您在这些渠道的 Feed 中快速定位并排查商品问题。

  • 为需要同步的每个渠道单独开启上报开关。
注意： 媒体渠道上报管理仅在选择「SHOPLINE的商品ID」时可用；选择「自定义商品ID」时不可用。


第三步：设置同步商品范围

商品筛选规则用于决定哪些商品会被同步至该 XML Feed。

可用方式

  • 根据 SPU ID / SKU ID 指定商品。

     


 

第四步：配置商品字段规则

系统已根据最佳实践预设核心字段，建议保持启用。

您可以根据需要自定义字段，例如：

  • 商品标题（title）
  • 商品分类（category）
  • 自定义标签（labels）

宏（Macro）示例：
输入 colour，系统将自动从商品属性中匹配对应值（例如 red）。

完成字段配置后，建议使用 预览商品  功能检查字段填充结果。

注意： 

  • 如果您在保存 General XML 的字段规则时，某个必填字段仍未设置映射规则（未添加宏、自动化规则或固定值），系统会弹出确认对话框：「发现未配置的必填字段 —— 当前配置中存在部分必填字段未添加映射规则，可能会导致商品在渠道端拒审。确定要继续提交吗？」您可以选择继续提交以保存当前设置，或点击返回修改回到字段规则页面补充设置。
  • 若您同时在字段设置中配置了商品 ID 规则，系统会优先使用「自定义商品ID」导入文件中的 ID；仅当某商品在导入文件中找不到时，才会使用字段规则中设置的 ID 作为兜底。


第五步：预览商品

在预览页面中，请重点检查：

  • 字段内容是否正确
  • 商品款式是否完整
  • 商品 ID 是否一致（尤其是迁移店铺）


第六步：生成 XML Feed

点击 生成 XML 以生成 XML Feed。

生成后，您可以：

  • 在Feed 管理 中查看 XML 链接
  • 查看同步时间及商品数量

Smart Feed 会每日自动更新 XML Feed。

您可以在 Feed 管理 中查看最新更新时间及商品数量。

查看缺失的必填字段

商品同步完成后，Smart Feed 会检查 General XML 渠道是否存在渲染为空的必填字段，并直接在商品管理页面进行标记，这样您就不需要等到广告平台拒审后再回头排查。

General XML 的必填字段：id、title、description、link、image_link、price、availability。

注意： General XML 不要求填写availability（库存状况）字段。该渠道下库存为空不会触发提示。

 

查看并修复缺失字段的方法：

1. 前往 General XML 渠道的商品管理 > 已提交 标签页。

2. 如果任意商品存在必填字段为空的情况，页面会显示提示条：「部分商品必填字段为空，请前往主站补充。」

3. 点击某个商品行可查看字段级别的详情。仍缺失的字段会标记为必填项为空。

注意： 如果提示是因为字段规则未设置（而非主站商品数据缺失）导致的，提示条会改为引导您前往完善字段规则，并附上该渠道字段规则页面的链接。

常见问题

问：为什么有些商品已经生成 Feed，还是会显示「必填字段为空」的提示？

即使字段规则已经设置好，必填字段仍然可能渲染为空，这通常是因为主站的商品基础资料本身缺失（例如商品描述为空）。Smart Feed 会直接在商品管理页面标记出来，方便您在渠道拒审之前提前处理。