SuperAPI AI 工具集

portaly-review

营销与增长

查看项目

更新于 10-15 21:39

技能介绍

用途:把 Portaly 托管的已验证买家评分徽章(类似 Trustpilot 的评分组件)嵌入商家自有站点。它是嵌入与验证类技能,不是评价系统:评价链接由 Portaly 在结账后自动生成,评分、存储与公开评价页均由 Portaly 托管。本技能不创建评价链接、不采集评分,也不在 Portaly 托管 iframe 之外渲染分数。

前提:商家需有 Portaly 账号、已启用 Portaly Payment,并拥有公开 slug;尚未开通时先参考 portaly-payment 或 portaly-payment-integration。无需 API key,iframe 是公开、免鉴权的嵌入,仅以公开 slug 为键。

用法:请用户打开后台 https://portaly.cc/admin/creator-subscription → Portaly Payment → 評價 标签页,粘贴其提供的嵌入代码;若只有 slug,先与用户确认,再用模板构造(host 为解析后的主机): <iframe src="{host}/embed/reviews/{slug}?theme=light&locale=zh-TW" width="320" height="80" style="border:0" title="Portaly Reviews"></iframe> 可按页面调整 theme(light|dark,默认 light)与 locale(zh-TW|en-US,默认 zh-TW);title 固定为 "Portaly Reviews"。徽章透明无边框,会继承宿主页面背景,theme 只控制文字与星标颜色,不要用卡片包裹。

位置与尺寸:常见位置为页脚、产品/定价页或结账附近。默认 320×80,宽约 240–480px、高约 60–100px,保持约 4:1,超出会裁切或留白。

验证:加载页面确认显示平均星级、评价数与 Portaly 标识;点击应在新标签打开 {host}/{locale}/reviews/{slug}。

限制与护栏:不得自制或仿造评价 UI,不得遮挡 Portaly 标识或点击外链,不得代理/转托管 iframe URL、注入未记录参数或改写内容;不存在公开的评价 JSON API,无法在 Portaly 验证之外原生渲染分数。API key 只发送至 https://portaly.ai(仅版本上报使用),PORTALY_API_HOST 只影响 iframe 与公开评价页链接。客户端打包环境需使用框架前缀变量(如 NEXT_PUBLIC_/VITE_/REACT_APP_)。Windows 打印非 ASCII 前先执行 chcp 65001 或设置 $OutputEncoding。未在资料中提供的价格、效果等信息暂未提供。