Smart Feed：创建通用型 XML 商品 Feed – SHOPLINE 常见问题

本指南将介绍如何创建一个可用于多个渠道的通用 XML 商品 Feed。每个通用 XML Feed 对应一个投放国家和一种投放语言，并使用该国家所在市场的价格和商品内容。这样您可以为每个国家分别创建一个商品目录，满足许多广告平台在多国投放时“一国一目录”的要求。

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

开始前准备

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

已在 SHOPLINE 后台创建并上架商品
商品已勾选「在线商店」
要投放的国家和语言已添加至已启用的市场（在店铺的「市场」设置中）
要同步的商品已添加至该市场

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

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

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

创建通用型 XML Feed

第一步：从 SHOPLINE 同步商品

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

使用建议：

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

预计同步时间：

不超过 10,000 个款式：约 30 分钟
不超过 50,000 个款式：约 2 小时

注意： 若超过 2 小时仍未完成，请联系客户经理协助处理。。

第二步：连接设置

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

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

多个渠道共享统一字段规则
同步商品数据至尚未与 Smart Feed 直接对接的媒体渠道

每个 Feed 对应一个投放国家和一种投放语言。如需覆盖多个国家或语言，请为每个组合分别创建 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」时不可用。

第三步：选择投放国家、语言及同步商品范围

在 商品过滤 页面，选择该 Feed 广告投放的国家和商品内容使用的语言，然后设置要同步的商品范围。

为通用 XML Feed 选择投放国家和语言：

在 选择广告投放的国家 下拉框中选择一个国家。每个选项会显示市场、国家及其币种，例如 欧盟–荷兰 (EUR)。
在 选择投放语言 中选择一种语言。列表显示所选市场中已添加的语言：

推荐语言：所选国家的官方或通行语言，置顶显示。
市场默认语言：所选市场的默认语言。

注意：

下拉框中仅显示已启用市场中的国家。
无需手动选择币种。若市场已开启本地币种，Feed 使用该国家的本地币种；否则使用市场币种。
Feed 创建后无法修改投放国家和语言。如需更换，请删除该 Feed 后重新创建。

示例：某店铺在荷兰、比利时和卢森堡销售，均以 EUR 计价，其广告平台要求每个国家对应一个目录。该店铺可创建以下 3 个通用 XML Feed：

荷兰，荷兰语
比利时，法语
卢森堡，法语

商品筛选规则用于决定哪些商品会被同步至该 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 链接
查看同步时间及商品数量

系统会按以下格式自动命名 Feed：通用 XML-{币种}-{国家}-{语言}。例如，投放卢森堡、使用法语的 Feed 会命名为 通用 XML-EUR-LU-FR。

Feed 中的价格使用所选市场中设置的价格，商品标题等内容使用所选语言。

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

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

市场设置变更对通用 XML Feed 的影响

通用 XML Feed 的商品、价格和内容均来自您所选的市场，因此该市场的部分设置变更会影响 Feed。

市场、国家或语言被移除时，Feed 将失效：出现以下任一情况时适用：

市场被删除
国家从市场中被移除
语言从市场中被移除

此时，该 Feed 会从 Feed 列表中移除，商品管理 和 渠道管理 页面会显示相应提示。如需继续为该国家同步商品，请使用有效的市场、国家和语言重新创建 Feed。

市场币种设置变更时，Feed 会自动更新：例如，为市场开启本地币种后，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 会直接在商品管理页面标记出来，方便您在渠道拒审之前提前处理。

问：已创建的通用 XML Feed 可以修改投放国家或语言吗？

不可以。Feed 创建后无法修改投放国家和语言。如需更换，请删除该 Feed 后重新创建。

问：为什么我的通用 XML Feed 从 Feed 列表中消失了？

这通常是因为该 Feed 对应的市场被删除，或其国家、语言已从市场中移除。请查看 商品管理 或 渠道管理 页面的提示，然后使用有效的市场、国家和语言重新创建 Feed。