市场
SPREEAI 开发者专区
搭建试衣间
进入每一个屏幕。.
Connect your catalogue. Shape the customer journey. Bring Always On into your storefront with the integration path that fits your team.
选择你的道路
从你的
商业技术栈依然存在。.
使用 Shopify 为管理设置,或与我们的 SDK 和 API 集成。 选择您的业务需求的特点,并保持您的品牌购物之旅。
最快路径
Shopify 应用
我们的技术通过我们Shopify合作伙伴关系提供。 安装应用程序,连接您的目录并为您的商店提供体验。Shopify 商店前线 网页 SDK自定义网站
网页 SDK
控制位置、样式、事件、大小和加入购物车行为。.JavaScript + 字体编辑 文档原生移动端
SDK 等
将 SPREEAI 体验融入现有的 iOS 购物流程中。.开启指南 文档原生移动端
Android SDK 端口
将试穿功能融入具有原生控件的 Android 产品体验中。.開放Android指南 合作伙伴访问权限定制系统
公开 API
请使用经批准的 API 参考进行服务器端和目录工作流。.开放 API 参考Web SDK 快速入门
您的第一次融入
身份验证一次,即可在页面上的任何位置渲染试穿或尺码。请使用在入职培训期间颁发的测试凭据,切勿将客户端密钥放入浏览器代码中。.
npm install @spreeai/web-sdk
# 或
yarn add @spreeai/web-sdk
以“@”为主。 spreeai /web-sdk; const sdk = await init({ clientId:“your-client-id”,合作伙伴Id:”your-partner-id”, });如果(sdk) { await sdk.renderTryOnButton({ elementId: “ spreeai (),(),(,),,。
events: {
onTryOnButtonClick: (event) => {
analytics.track("try_on_started", event);
},
onAddToCartClicked: async (event) => {
// 连接到您现有的购物车工作流。
},
}
集成模型
四个系统。.
一个客户的高光时刻。.
产品ID、变体、图像和营销内容。.
服装经历加工、审核和就绪状态。.
您的店面请求符合条件的商品体验。.
试穿,寻找尺码,搭配造型,然后返回结账。.
一个专注的路径启动
做好准备。 连接
以信心生活吧。
三英里,每一个实用的检查列表。
- 01 准备好
一个明确的起点。
调整旅行、访问和目录。
准备检查列表
- 选择一个频道,目录组和成功测量。
- 确认合作伙伴访问、认证和排序许可。
- 提供清洁,SKU合并的服装图像。
- 02 连接
让它感到原生。
建在站台上。 整个旅程测试。
集成检查列表
- 租借合格的产品,并连接变量和车辆行为。
- 与品牌相匹配的经验。
- 检查移动、桌面、可用性、性能和故障状态。
- 03 · 启动
从真正的使用中学习。
可准备的产品和测量。
启动检查列表
- 确认产品准备,并发布实时体验。
- 监测采用、完成和转换。
- 使用结果来指导下一个类别或旅行。
开发者参考
查找下一个
有用的回答。.
入门
了解访问权限、支持的平台以及您的团队需要做出的首要决策。.
官方参考 托管集成Shopify 商家入驻
安装应用程序,接受协议,同步服装,自定义按钮并开始直播。.
官方参考 网页 SDKAPI 表面
审查初始化、渲染选项、大小调整、自定义和类型化接口。.
官方参考 合作伙伴 API公共 API 参考
探索面向已认证合作伙伴的已批准服务器端接口。.
Swagger 引用 质量服装资产
准备能够顺利通过导入和审核的产品图像与元数据。.
SPREEAI 指南 生产质量保证与发布
使用共享浏览器、性能、无障碍访问和上线检查清单。.
SPREEAI 指南 支持故障排除
解决最常见的身份验证、资格验证、渲染和性能问题。.
SPREEAI 指南 文档实施指南
浏览公开的快速入门、资产标准、发布检查清单和故障排除指南。.
开放文档没有找到匹配的开发者资源。请尝试“Shopify”、“SDK”、“assets”或“QA”。”
构建生产版本
保护的细节
客户体验。.
安全
将机密保存在服务器端,仅使用发放的环境,并通过合作伙伴工作流程轮换凭据。.
隐私
请在获得明确同意的情况下收集客户图像,并根据您批准的集成计划规范数据处理。.
性能
在需要的地方加载体验,测试真实设备并监控产品页面回归。.
无障碍
当体验不可用时,请保留键盘访问权限、焦点顺序、无障碍名称和可用的路径。.
开发者常见问题解答
之前的问题
首次提交。.
我们应该选择哪个集成?
使用 Shopify 应用以获得最快的托管路径,使用 Web SDK 实现自定义或无头网页布局,使用原生 SDK 实现应用体验,并使用在接入培训期间商定的已批准 API 参考来实现服务器端工作流。.
凭据来自哪里?
SPREEAI会在入驻流程中发放合作伙伴ID和获批的凭据。浏览器SDK使用客户端ID和合作伙伴ID。绝不能将客户端密钥嵌入前端代码中。.
Shopify 应用需要 API 密钥吗?
当前的 Shopify 应用引导流程在完成必需的协议和订阅步骤后连接店铺;托管应用无需将密钥复制到设置界面中。.
为什么“试穿”按钮没有显示?
请确认服装已完成处理、已启用试穿功能、已映射到当前的产品或变体,并且产品模板上已包含应用块或 SDK 容器。.
哪些客户端事件可用?
已记录的SDK回调涵盖了试穿按钮点击和加入购物车交互。将其连接到您的分析层,但不要包含客户图像或不必要的个人数据。.
服务器 Webhook 可用吗?
服务器推送式 Webhook 不属于当前已发布的 SDK 文档的一部分。在依赖任何服务端事件需求之前,请与合作伙伴工程团队(Partner Engineering)确认范围。.
开发者在哪里寻求帮助?
使用入职培训期间提供的技术支持路径或发送电子邮件 support@spreeai.com. 包含环境、产品ID、浏览器或设备、时间戳以及简明的复现路径——切勿发送任何机密信息。.
亚马逊合作伙伴网络支持何时可用?
亚马逊伙伴网络集成正在开发中。在入驻和生产界面准备好供外部开发人员使用之前,它被有意标记为“即将推出”。.
准备好构建了吗?