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

向 eMAG 发送
值得展示的商品

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

eMAG 商品 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 发送给 eMAG 的内容

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

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

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 不会更改您的出价或预算。

什么是 eMAG?

eMAG 是罗马尼亚最大的电商平台,并在保加利亚(emag.bg)和匈牙利(emag.hu)以同一卖家计划运营同等的 Marketplace 平台。第三方卖家并不通过独立的店面销售——他们通过 eMAG Marketplace 直接针对 eMAG 自己的商品目录发布报价,每个报价都与 eMAG 自营零售商品信息及其他平台卖家在同一个商品页面上竞争。eMAG 为卖家提供两种发布和维护商品目录的方式:eMAG Marketplace API(JSON,当前文档版本为 4.5.1),或由 eMAG 按计划抓取并重新处理的托管式 XML/CSV Feed Import。

为什么要将商品 Feed 连接到 eMAG?

一旦商品目录超过几十个 SKU,在 eMAG 卖家后台手动重新录入商品、重新输入库存或价格变动就无法扩展,而这正是在快速变化的电商平台上价格过时和超卖的最大根源。以程序化方式向 eMAG 提供 Feed,您就可以在新报价、价格变动和库存水平在您自己的 PIM 或店面中发生变化的那一刻推送它们,而不是取决于有人想起来登录后台手动编辑商品信息的频率。由于三个国家站点都基于相同的 Marketplace API 和 Feed Import 机制运行,您还可以利用同一份底层商品数据覆盖罗马尼亚、保加利亚和匈牙利三个市场。

eMAG 的佣金模式如何运作

eMAG 不收取注册费、月度订阅费或按商品计费的上架费。卖家只需对已完成的销售支付按类别计算的佣金,eMAG 自己的卖家文档指出,佣金“根据商品所在类别在 7% 到 25% 之间”——每个类别的具体费率在卖家的 Marketplace 合同中列明。佣金会在结算前自动扣除,卖家每月收款两次。选择 eMAG 履约服务(Fulfilled by eMAG,FBE)的卖家还需根据库存在 eMAG 仓库中存放的时长支付额外的仓储费,以及按订单收取的处理费,起价为 3.99 RON,并随包裹尺寸和重量递增。

eMAG 要求什么 Feed 格式?

eMAG 支持两种不同的集成方式,而 Feedance 围绕 API 方式构建,因为它能对验证和更新时机提供最严格的控制:

  1. Marketplace API(推荐用于自动化)——通过经过身份验证的 POST 请求,将 JSON 负载发送到 product_offer、category 和 order 等资源端点(例如 product_offer/save、product_offer/read、product_offer/count)。每个响应都是标准化的 JSON,包含一个 isError 布尔值和一个 messages 数组;单次 save 调用的上限为 50 个实体(eMAG 建议 10–50 个以确保可靠处理),每次调用的硬性上限为 4000 个元素。
  2. Feed Import(XML/CSV)——一个托管文件 URL,eMAG 的 Feed Import 模块会按照您在卖家后台中配置的计划重新抓取。单个 Feed 文件的上限为 100 MB,最多 100,000 件商品,每个 Feed 最多 150 个类别。

两种方式最终都会填充相同的底层商品/报价记录,因此选择取决于您需要对验证响应和错误处理拥有多少实时控制——这也是 Feedance 默认使用 JSON API 的原因。

哪些商品属性是必填的?

属性是否必填?格式/说明
id必填整数 1–16,777,215——您自己的内部商品 ID,用作今后对该报价每次更新的主键。
category_id必填标识 eMAG 商品类别的整数;卖家不能创建或修改类别,只能通过 category 资源从 eMAG 现有的类别树中选择。
name必填字符串,1–255 个字符。
part_number必填字符串,1–128 个字符——制造商的零件号/型号,eMAG 用其检测重复商品。
brand必填字符串,1–255 个字符。
sale_price必填小数,必须大于 0,最多 4 位小数;不含增值税的价格。
vat_id必填引用适用增值税税率的整数。
stock必填由 warehouse_id/value 对象组成的数组——每个仓库的数字库存。
min_sale_price / max_sale_price首次保存时必填小数区间;之后每次 sale_price 更新都必须落在此区间内,否则报价会被拒绝。
ean有条件必填条形码数组,6–14 位数字(EAN-8/13、UPC-A/E、GTIN-14 等);category/read 响应会告诉您每个类别的 EAN 是必填还是选填。
images选填,但实际上必需图片 URL 数组;每张图片最大 6000x6000 像素、8 MB,仅支持 JPG/JPEG/PNG。
characteristics选填,但实际上必需由 id/value 对组成的数组;每个特征 ID 都必须对所选的 category_id 有效,否则保存会因类别/特征不匹配而被拒绝。
warranty选填整数,保修月数,0–255(默认为 0)。
handling_time选填按仓库区分的发货/处理天数数组。

如何将 eMAG 与 Feedance 连接

  1. 让您的 eMAG Marketplace 卖家账户获得批准,并在卖家后台生成 API 凭据。
  2. 在 Feedance 中添加 eMAG 作为目标渠道,并输入这些凭据,以便 Feedance 能够通过 Marketplace API 的身份验证。
  3. 将您的商品目录字段映射到 product_offer 模式——name、part_number、brand、sale_price、vat_id、stock、EAN、images,以及 eMAG 对您所销售的每个 category_id 要求的类别专属特征。
  4. 设置 min_sale_price / max_sale_price 区间,以免报价上线后今后的价格更新被悄无声息地拒绝。
  5. 让 Feedance 验证映射后的 Feed,按 eMAG 建议的每次 save 调用 10–50 个实体进行分批并推送——同时自动控制请求节奏以保持在 eMAG 的速率限制之内,而不是一次性全部发出。
  6. 查看 Feedance 从每次推送中反馈的 isError / messages 响应,让被拒绝的报价(类别与特征配对错误、价格超出区间、EAN 无效等)被标记出来以便修复,而不是悄无声息地消失。

Feed 应多久更新一次?

eMAG 自己的指南对请求节奏有明确规定:Marketplace API 每个账户最多每 3 秒 1 次请求、每分钟 20 次请求,并且 eMAG 建议不要将调用安排在整点等固定时刻(例如在 12:04:42 而不是 12:00:00 开始一批任务),以免众多卖家的任务在同一秒发生冲突。在这一上限之内,价格和库存是最值得积极更新的字段——理想情况下在您这边每次发生变化时都更新,至少每天更新数次——因为在快速变化的电商平台上,过时的库存数字会直接让您损失无法履约的订单,或在同一商品页面上相对于竞争报价的排名。对大多数卖家来说,每天进行一次全量商品目录重新同步(新商品、更新的描述、图片、特征)是合理的;如果您使用的是 Feed Import 而不是 API,文件的新鲜度仅取决于 eMAG 的 Feed Import 模块上次重新抓取您托管 URL 的时间,因此请检查您在卖家后台中配置的刷新间隔。

常见 Feed 错误

eMAG Marketplace API 参考文档中记录的最常见拒绝情况包括:

  • isError: true 并附带 messages 数组——eMAG 的标准失败响应结构;必须对每个请求检查此项,而不能仅因为返回了 HTTP 200 就认为请求成功。
  • 价格无效(验证状态 11)——当 sale_price 更新超出报价首次保存时设置的 min_sale_price/max_sale_price 区间时触发。
  • EAN/品牌/文档验证待定或被拒(状态 1–8)——eMAG 会让新报价依次经过 Marketplace、品牌、EAN 和文档验证阶段,之后报价才会获得批准(状态 9);格式错误的条形码(必须是可识别的 EAN/UPC/GTIN 格式、6–14 位数字)是在 EAN 阶段卡住的常见原因。
  • 类别/特征不匹配——发送的 characteristics 条目的 ID 对报价的 category_id 无效,会导致该次保存被拒绝。
  • 图片错误——超过 6000x6000 像素或 8 MB,或格式不是 JPG/JPEG/PNG 的图片会被拒绝。
  • HTTP 429 超出速率限制——当您超过每 3 秒 1 次请求或每分钟 20 次请求时返回,同时附带 X-RateLimit-Limit-3second / X-RateLimit-Remaining-3second 响应头,您可以据此在再次触及上限之前放缓请求。

优化建议

  • 如果某件商品已存在于 eMAG 的商品目录中,请使用 part_number_key 将您的报价挂靠到该商品上,而不是提交一个全新的商品——这样可以跳过重新验证,让报价更快上线。
  • 预先设置切合实际的 min_sale_price/max_sale_price 区间;区间过窄意味着日后常规的调价会被拒绝,而 eMAG 只允许在首次保存时设置这些值。
  • 一次性填对 EAN——条形码验证是较慢的审核阶段之一,被拒的 EAN 会阻止整个报价上线,而不仅仅是该字段。
  • 填写每个类别必填的特征,而不只是满足验证的最低要求——eMAG 站内的筛选器正是基于这些值构建的,不完整的特征会悄悄降低您的报价在类别浏览中被找到的概率。
  • 按照 eMAG 建议的 10–50 个实体范围对 product_offer/save 调用进行分批,并将任务的开始时间错开整点分钟,避免与其他卖家的计划任务发生速率限制冲突。
  • 将每个 isError: true 响应都视为需要处理的问题,而不是无关紧要的提示——eMAG 自己的文档指出,某些失败的保存仍会被部分处理,如果忽略错误,商品信息可能会处于不一致的状态。

常见问题

eMAG 使用 XML Feed 还是 JSON API?
两者都有。Marketplace API 是通过经过身份验证的 POST 请求传输的 JSON,也是 Feedance 自动化的方式。eMAG 还提供单独的 Feed Import 选项,接受托管的 XML 或 CSV 文件,上限为 100 MB、100,000 件商品和 150 个类别。

一个 Feed 能同时覆盖罗马尼亚、保加利亚和匈牙利吗?
每个国家都运营各自的 Marketplace 账户和各自的 API/卖家后台实例(emag.ro、emag.bg、emag.hu),因此需要分别连接,不过三者的模式和机制完全相同。

如果超出 eMAG 的 API 速率限制会怎样?
您会收到带有超出速率限制信息的 HTTP 429 响应。eMAG 的限制是每个账户每 3 秒 1 次请求、每分钟 20 次请求。

使用 eMAG Marketplace API 本身需要付费吗?
不需要——API 访问没有单独收费。eMAG 的收入来自对已完成销售收取的按类别计算的佣金(约 7%–25%),而不是来自集成或上架活动。

单次 API 保存调用最多可以包含多少件商品?
每次 product_offer/save 调用最多 50 个实体,建议 10–50 个以确保可靠处理,每次调用的总上限为 4000 个元素。

关于 eMAG

Emag 是一个向消费者提供丰富商品的电商平台。它于 2001 年推出,是历史最悠久、最成熟的在线商城之一。Emag 起源于罗马尼亚,此后已将业务扩展到中东欧的其他国家。

该平台为顾客提供多样化的商品选择,包括电子产品、家用电器、时尚、美妆、运动器材、家居园艺用品等。凭借友好的用户界面和丰富的商品种类,Emag 致力于满足顾客多样化的需求和偏好。

Emag 的主要特点之一是高度重视客户服务和满意度。该平台通过安全的支付方式、高效的配送服务和响应迅速的客服团队等功能,优先提供顺畅可靠的购物体验。这种对客户满意度的承诺,帮助它多年来积累了忠实的客户群。

Emag 还与众多品牌和卖家建立了合作关系,为顾客提供海量商品选择。这有助于为顾客提供多种选择和有竞争力的价格。此外,该平台经常开展促销活动、折扣和独家优惠,以进一步吸引和留住顾客。

近年来,Emag 进一步扩展了服务,推出了更多功能,例如让顾客能够快速、安全付款的数字钱包 Emag Pay,以及让第三方卖家能够在平台上发布和销售商品的 Emag Marketplace。

作为一个知名电商平台,Emag 因其对行业的贡献获得了多项荣誉和奖项。它的成长和成功归功于对客户满意度的专注、对品质的承诺,以及在提供顺畅网购体验方面的持续创新。

总之,Emag 是一个 2001 年起源于罗马尼亚的成熟电商平台。它为顾客提供种类繁多的商品,并专注于提供卓越的客户服务。Emag 的稳步增长和扩张使其成为中东欧地区广受欢迎的网购选择。

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

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