商品评价
买家评价帮助其他人挑选商品,搜索结果中的星级则能带来更多点击。OneTrace.pro 通过购买后邮件中的链接收集评价,用 AI 进行检查,并将已发布的评价显示在商品页面、推荐小组件、邮件和 AI 聊天的回答中。
商品评价从“增长版”套餐起可用,参见套餐。需要已有商品目录(推荐与商品目录)。
评价链接
在购买后的邮件中添加带有 review_url 函数的链接——例如在下单一周后发送邮件的旅程中:
请为您购买的商品评分:{{ review_url(event.properties.items) }}
可以向函数传入商品 id(review_url('SKU-123'))、id 列表,或带有 id 或 product_id 字段的商品列表,最多 10 件商品。链接是个人专属并经过签名的:买家只能评价邮件中的商品,评价会写入其档案。
在评价页面上,买家为每件商品打一到五颗星,可以选择填写标题和正文,并填写在网站上显示的署名。未评分的商品会被跳过。通过同一链接可以修改评价——修改后的评价需要重新审核。每位买家对每件商品只能留下一条评价。

审核
新评价在网站 → 商品评价板块中等待审核。顶部是待审核、已发布、已拒绝和全部队列,勾选仅显示 AI 标记的后,只显示 AI 发现了问题的评价。每条评价都显示商品、评分、正文、作者署名和买家档案链接。
- 发布:评价会显示在网站上,并计入商品评分;
- 拒绝:评价不显示,但仍保留在板块中;
- 垃圾桶图标会彻底删除评价。
拥有商品查看权限的角色可以查看评价,拥有商品修改权限的角色可以处理评价。每个决定都会记录在项目审计日志中,参见项目设置、套餐与审计。

AI 检查
AI 会检查每条新评价,并添加带有原因的标记:
| 标记 | AI 发现的内容 |
|---|---|
| 垃圾信息 | 广告、指向其他店铺的链接、无意义的文字 |
| 辱骂 | 粗话和侮辱性言论 |
| 个人数据 | 正文中的电话、地址、邮箱等数据 |
没有问题的评价会获得“AI:无问题”标记。差评本身不会被标记:真实的两星评价可以通过检查。
开启4–5★ 且无 AI 标记的评价立即发布,好评即可无需等待直接显示在网站上。其余评价——低分、带有标记或正文中含有链接或电话号码的——仍需等待审核员处理。
与其他 AI 功能一样,检查费用按用量从项目余额中扣除。余额不足时,评价不会被检查,将不带标记地等待审核员处理。
网站上的评价模块
在商品页面上插入带有目录商品 id 的元素:
<div data-cdp-reviews data-product-id="SKU-123"></div>
追踪器会在其中显示平均评分、5 到 1 星的评分分布,以及每次 10 条的已发布评价,并带有显示更多按钮。文字以访客的语言显示。如果还没有评价,模块会给出提示。您店铺中某件商品的现成代码和模块预览位于网站 → 商品评价板块。

- 搜索结果中的星级。 模块会在页面上添加 schema.org 标记——商品的评分和评价,搜索引擎据此在搜索结果中显示星级。如果页面已有自己的含评价的商品标记,请添加
data-schema="false"。 - 星星颜色:使用属性
data-accent="#f59e0b"。 - 单页应用网站。 如果页面上的商品无需重新加载即会切换,请修改
data-product-id,模块会自动更新。 - 要在整个网站上关闭该模块,请使用
cdp.init(key, { reviews: false })。
推荐、邮件和聊天中的评分
商品评分即已发布评价的平均分,会在审核员每次做出决定后重新计算,并显示在:
API
GET /api/v1/reviews?product=SKU-123:商品的已发布评价、评分和评分分布。可使用写入密钥和私密密钥,适合自建评价模块或应用。POST /api/v1/reviews:来自店铺服务器的评价(需要具有商品修改权限的私密密钥):买家通过标识符指定,例如邮箱。评价同样要经过检查和审核。要迁移原有系统中已审核过的评价,请传入publish: true和评价日期date,评价将立即发布。
详情请参阅 API 参考,参见API 密钥。
事件
每条评价都会以 $review_submitted 事件写入买家档案,属性包括 product_id、rating 和 source。可以据此建立分群,或在旅程中向买家致谢。