最快路径
选择你的道路
从你的地方开始
商业堆栈的生命力。
使用 Shopify 进行托管设置,或与我们的 SDK 和 API 集成。选择您的业务所需的功能并保持您品牌的购物旅程。
定制网页
网页版SDK
控制放置、样式、事件、尺寸和添加到购物车行为。JavaScript + TypeScript 文档本机移动
iOS SDK
将 SPREEAI 体验融入现有的 iOS 购物之旅中。打开 iOS 指南 文档本机移动
安卓软件开发工具包
通过本机控件将试用集成到 Android 产品体验中。打开安卓指南 合作伙伴访问定制系统
公共API
将批准的 API 参考用于服务器端和目录工作流程。开放API参考市场
亚马逊合作伙伴网络
即将推出亚马逊合作伙伴网络和其他平台,提供更多将 SPREEAI 集成到您的商务堆栈中的方法。更新将首先出现在此处Web SDK 快速入门
您的第一次集成。
验证一次,然后在页面上的任何位置呈现试穿或尺寸调整。使用在入职期间颁发的测试凭据,并且切勿将客户端机密放入浏览器代码中。
npm install @spreeai/web-sdk@3.0.0
# or
yarn add @spreeai/web-sdk@3.0.0
import { init } from "@spreeai/web-sdk";
import "@spreeai/web-sdk/dist/web-sdk.css";
// Add <div id="spreeai-try-on"></div> to the product page first.
const sdk = await init({ clientId: "your-client-id" });
if (sdk) {
await sdk.renderTryOnButton({
elementId: "spreeai-try-on",
garments: [{ garmentId: "your-garment-id" }],
enableAddToCart: true,
});
}
// Pass events inside renderTryOnButton's options.
await sdk?.renderTryOnButton({
elementId: "spreeai-try-on",
garments: [{ garmentId: "your-garment-id" }],
events: {
onTryOnButtonClick: (event) => {
console.info(event.name);
},
onAddToCartClicked: (event) => {
// Connect event.garments to your storefront's cart.
},
},
});
整合模型
四个系统。
一个客户时刻。
产品 ID、变体、图像和营销背景。
服装经历加工、审查和准备状态。
您的店面请求获得合格产品的体验。
试穿、找到尺码、完成造型并返回结帐。
专注的启动路径
准备。连接。
充满信心地生活。
三个里程碑,每个里程碑都有一个实用的清单。
- 01 · 准备
一个明确的起点。
协调旅程、访问和目录。
准备清单
- 选择一个频道、目录组和成功衡量标准。
- 确认合作伙伴访问权限、凭据和暂存权限。
- 提供干净、符合 SKU 的服装图像。
- 02 · 连接
让它有原生的感觉。
建立舞台。测试整个旅程。
集成清单
- 呈现符合条件的产品并连接变体和购物车行为。
- 将体验与品牌相匹配。
- 检查移动设备、桌面设备、可访问性、性能和故障状态。
- 03 · 启动
从实际使用中学习。
启用现成的产品并进行测量。
启动清单
- 确认产品准备就绪并发布分阶段体验。
- 监控采用、完成和转换。
- 使用结果来指导下一个类别或旅程。
开发者参考
寻找下一个
有用的答案。
开始使用
了解访问权限、支持的平台以及您的团队需要做出的首要决策。
官方参考 托管集成Shopify 入职
安装应用程序、接受协议、同步服装、自定义按钮并上线。
官方参考 网页版SDKAPI表面
检查初始化、渲染选项、大小、定制和类型化接口。
官方参考 合作伙伴API公共API参考
探索可供经过身份验证的合作伙伴使用的经批准的服务器端界面。
Swagger 参考 品质服装资产
准备通过摄取和审查干净利落地移动的产品图像和元数据。
SPREEAI 指南 生产质量检查和发布
使用共享浏览器、性能、可访问性和上线清单。
SPREEAI 指南 支持故障排除
解决最常见的身份验证、资格、渲染和性能问题。
SPREEAI 指南 文档实施指南
浏览公共快速入门、资产标准、启动清单和故障排除指南。
打开文档没有匹配的开发者资源。尝试“Shopify”、“SDK”、“资产”或“QA”。
为生产而构建
保护的细节
客户体验。
安全
在服务器端保留机密,仅使用已发布的环境并通过合作伙伴工作流程轮换凭证。
隐私
在明确同意的情况下请求客户图像,并将数据处理与您批准的集成计划保持一致。
性能
在需要的地方加载体验、测试真实设备并监控产品页面回归。
无障碍
当体验不可用时,保留键盘访问、焦点顺序、可访问名称和可用路径。
开发者常见问题解答
之前的问题
第一次提交。
我们应该选择哪种集成?
使用 Shopify 应用程序实现最快的托管路径,使用 Web SDK 实现自定义或无头 Web 放置,使用本机 SDK 实现应用程序体验,以及用于在入职期间商定的服务器端工作流程的已批准 API 参考。
凭证从哪里来?
SPREEAI 在合作伙伴注册过程中颁发合作伙伴 ID 和已批准的凭证。浏览器 SDK 使用客户端 ID 和合作伙伴 ID。切勿将客户端密钥嵌入前端代码中。
Shopify 应用程序是否需要 API 密钥?
当前的 Shopify 应用程序入门流程在所需的协议和订阅步骤后连接商店;托管应用程序不需要将密钥复制到设置屏幕中。
为什么没有出现“试用”按钮?
确认服装已完成处理、启用试穿、映射到活动产品或变体,并且应用程序块或 SDK 容器存在于产品模板上。
哪些客户活动可用?
记录的 SDK 回调涵盖试用按钮点击和添加到购物车交互。将它们连接到您的分析层,而不包含客户图像或不必要的个人数据。
服务器 webhook 是否可用?
服务器推送 Webhook 目前尚未包含在已发布的 SDK 文档中。在使用任何服务器端事件需求之前,请务必先与合作伙伴工程团队沟通确认。
开发人员从哪里获得帮助?
使用入职或电子邮件期间提供的技术支持路径 support@spreeai.com。包括环境、产品 ID、浏览器或设备、时间戳和简洁的复制路径——切勿发送机密。
亚马逊合作伙伴网络支持何时提供?
亚马逊合作伙伴网络集成功能正在开发中。在面向外部开发者的集成和生产环境接口准备就绪之前,该功能暂时标记为“即将推出”。
准备好建造了吗?