Đường đi nhanh nhất
SPREEAI dành cho nhà phát triển
Xây dựng phòng thử đồ
Trên mọi màn hình.
Kết nối danh mục sản phẩm của bạn. Định hình hành trình khách hàng. Tích hợp Always On vào cửa hàng trực tuyến của bạn với lộ trình tích hợp phù hợp với nhóm của bạn.
Hãy chọn con đường của bạn
Bắt đầu từ nơi bạn
Nền tảng thương mại vẫn hoạt động.
Sử dụng Shopify để thiết lập được quản lý, hoặc tích hợp với SDK và API của chúng tôi. Chọn các tính năng mà doanh nghiệp của bạn cần và duy trì hành trình mua sắm của thương hiệu bạn.
Trang web tùy chỉnh
Bộ công cụ phát triển phần mềm web (Web SDK)
Kiểm soát vị trí, kiểu dáng, sự kiện, kích thước và hành vi thêm vào giỏ hàng.JavaScript + TypeScript Bác sĩỨng dụng di động gốc
Bộ công cụ phát triển phần mềm iOS (iOS SDK)
Mang trải nghiệm SPREEAI vào hành trình mua sắm hiện có trên iOS.Hướng dẫn mở iOS Bác sĩỨng dụng di động gốc
Bộ công cụ phát triển Android (Android SDK)
Tích hợp tính năng thử đồ vào trải nghiệm sản phẩm trên Android với các điều khiển gốc.Hướng dẫn mở Android Quyền truy cập của đối tácHệ thống tùy chỉnh
API công khai
Hãy sử dụng tài liệu tham khảo API đã được phê duyệt cho các quy trình làm việc phía máy chủ và danh mục.Tài liệu tham khảo API mởChợ
Mạng lưới đối tác của Amazon
Sắp có mặt trên Mạng lưới Đối tác Amazon và các nền tảng khác, với nhiều cách hơn để tích hợp SPREEAI vào hệ thống thương mại của bạn.Các bản cập nhật sẽ xuất hiện ở đây đầu tiên.Hướng dẫn nhanh về Web SDK
Lần tích hợp đầu tiên của bạn.
Xác thực một lần, sau đó hiển thị trang thử đồ hoặc chọn kích cỡ ở bất kỳ đâu trên trang. Sử dụng thông tin đăng nhập thử nghiệm được cấp trong quá trình thiết lập ban đầu và tuyệt đối không đặt mã bí mật của khách hàng vào mã trình duyệt.
npm install @spreeai/web-sdk@3.0.0
# or
yarn add @spreeai/web-sdk@3.0.0import { 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.
},
},
});Mô hình tích hợp
Bốn hệ thống.
Một khoảnh khắc dành cho khách hàng.
Mã sản phẩm, biến thể, hình ảnh và bối cảnh tiếp thị.
Hàng may mặc trải qua các giai đoạn xử lý, kiểm tra và sẵn sàng.
Cửa hàng trực tuyến của bạn yêu cầu trải nghiệm cho một sản phẩm đủ điều kiện.
Hãy thử đồ, tìm kích cỡ phù hợp, hoàn thiện set đồ và quay lại quầy thanh toán.
Một lộ trình tập trung để khởi nghiệp
Chuẩn bị. Kết nối.
Hãy tự tin bước lên sân khấu.
Ba cột mốc quan trọng, kèm theo danh sách kiểm tra thực tế cho mỗi cột mốc.
- 01 · Chuẩn bị
Một điểm khởi đầu rõ ràng.
Đồng bộ hóa hành trình, quyền truy cập và danh mục.
Danh sách kiểm tra chuẩn bị
- Chọn một kênh, nhóm danh mục và thước đo thành công.
- Xác nhận quyền truy cập, thông tin đăng nhập và quyền thiết lập môi trường của đối tác.
- Cung cấp hình ảnh sản phẩm rõ nét, phù hợp với mã SKU.
- 02 · Kết nối
Hãy làm cho nó có cảm giác tự nhiên.
Xây dựng trên môi trường thử nghiệm. Kiểm tra toàn bộ quy trình.
Danh sách kiểm tra tích hợp
- Hiển thị các sản phẩm đủ điều kiện và liên kết các biến thể cũng như hành vi giỏ hàng.
- Hãy điều chỉnh trải nghiệm sao cho phù hợp với thương hiệu.
- Kiểm tra trạng thái trên thiết bị di động, máy tính để bàn, khả năng truy cập, hiệu năng và lỗi.
- 03 · Ra mắt
Học hỏi từ kinh nghiệm thực tế.
Kích hoạt các sản phẩm sẵn có và tiến hành đo lường.
Danh sách kiểm tra khởi chạy
- Xác nhận sản phẩm đã sẵn sàng và công bố trải nghiệm thử nghiệm.
- Theo dõi việc áp dụng, hoàn thành và chuyển đổi.
- Sử dụng kết quả để định hướng cho danh mục hoặc hành trình tiếp theo.
Cơ sở tài sản
Đầu vào tốt sẽ dẫn đến kết quả tốt hơn.
- JPEG hoặc PNG
- Độ phân giải tối thiểu 2.000 × 2.000 pixel
- Cần có ảnh chụp từ phía trước.
- Nên xem ảnh chụp từ phía sau.
- Ánh sáng trung tính, đều
- Mã SKU hoặc mã kiểu trong tên tệp
Tài liệu tham khảo dành cho nhà phát triển
Tìm tiếp theo
Câu trả lời hữu ích.
Bắt đầu từ đây
Bắt đầu
Hiểu rõ về quyền truy cập, các nền tảng được hỗ trợ và những quyết định đầu tiên mà nhóm của bạn cần đưa ra.
Tài liệu tham khảo chính thức Quản lý tích hợpShopify onboarding
Cài đặt ứng dụng, chấp nhận thỏa thuận, đồng bộ hóa trang phục, tùy chỉnh nút và bắt đầu phát trực tiếp.
Tài liệu tham khảo chính thức Bộ công cụ phát triển phần mềm web (Web SDK)Bề mặt API
Xem lại quá trình khởi tạo, các tùy chọn hiển thị, kích thước, tùy chỉnh và giao diện kiểu dữ liệu.
Tài liệu tham khảo chính thức API đối tácTài liệu tham khảo API công khai
Khám phá giao diện phía máy chủ đã được phê duyệt dành cho các đối tác đã được xác thực.
Tham chiếu Swagger Chất lượngTài sản may mặc
Chuẩn bị hình ảnh sản phẩm và siêu dữ liệu sao cho quá trình nhập và xem xét diễn ra suôn sẻ.
Hướng dẫn SPREEAI Sản xuấtKiểm thử chất lượng & ra mắt
Sử dụng trình duyệt chung, danh sách kiểm tra hiệu năng, khả năng truy cập và chuẩn bị cho việc vận hành.
Hướng dẫn SPREEAI Ủng hộKhắc phục sự cố
Giải quyết các vấn đề thường gặp nhất về xác thực, quyền truy cập, hiển thị và hiệu năng.
Hướng dẫn SPREEAI Tài liệuHướng dẫn triển khai
Tìm hiểu các hướng dẫn nhanh dành cho người dùng phổ thông, tiêu chuẩn tài sản, danh sách kiểm tra khi khởi chạy và hướng dẫn khắc phục sự cố.
Tài liệu mởKhông tìm thấy tài nguyên nhà phát triển phù hợp. Hãy thử “Shopify,” “SDK,” “assets,” hoặc “QA.”
Xây dựng cho sản xuất
Những chi tiết bảo vệ
Trải nghiệm khách hàng.
Bảo vệ
Giữ bí mật ở phía máy chủ, chỉ sử dụng các môi trường đã được cấp phép và luân chuyển thông tin đăng nhập thông qua quy trình làm việc của đối tác.
Sự riêng tư
Yêu cầu khách hàng cung cấp hình ảnh với sự đồng ý rõ ràng và đảm bảo việc xử lý dữ liệu phù hợp với kế hoạch tích hợp đã được phê duyệt của bạn.
Hiệu suất
Tải trải nghiệm người dùng vào những nơi cần thiết, kiểm tra trên các thiết bị thực và theo dõi các lỗi hồi quy trên trang sản phẩm.
Khả năng tiếp cận
Bảo toàn quyền truy cập bàn phím, thứ tự tiêu điểm, tên dễ truy cập và đường dẫn khả dụng ngay cả khi trải nghiệm đó không khả dụng.
Câu hỏi thường gặp dành cho nhà phát triển
Câu hỏi trước
Lần commit đầu tiên.
Chúng ta nên chọn phương pháp tích hợp nào?
Sử dụng ứng dụng Shopify để có đường dẫn quản lý nhanh nhất, Web SDK để triển khai web tùy chỉnh hoặc không giao diện người dùng, SDK gốc cho trải nghiệm ứng dụng và tài liệu tham khảo API đã được phê duyệt cho các quy trình làm việc phía máy chủ đã được thống nhất trong quá trình thiết lập ban đầu.
Giấy chứng nhận đến từ đâu?
SPREEAI cấp ID đối tác và thông tin xác thực đã được phê duyệt trong quá trình thiết lập. SDK trình duyệt sử dụng ID khách hàng và ID đối tác. Không bao giờ nhúng mã bí mật khách hàng vào mã giao diện người dùng.
Ứng dụng Shopify có yêu cầu khóa API không?
Quy trình đăng ký ứng dụng Shopify hiện tại kết nối với cửa hàng sau bước thỏa thuận và đăng ký bắt buộc; ứng dụng được quản lý không yêu cầu sao chép khóa vào màn hình thiết lập.
Tại sao nút "Thử đồ" không hiển thị?
Xác nhận rằng sản phẩm may mặc đã hoàn tất quá trình xử lý, được kích hoạt chế độ thử đồ, khớp với sản phẩm hoặc biến thể đang hoạt động và khối ứng dụng hoặc vùng chứa SDK có mặt trên mẫu sản phẩm.
Hiện có những sự kiện nào dành cho khách hàng?
Các hàm gọi lại SDK được ghi lại bao gồm các lần nhấp vào nút Thử đồ và tương tác thêm vào giỏ hàng. Kết nối chúng với lớp phân tích của bạn mà không cần bao gồm hình ảnh khách hàng hoặc dữ liệu cá nhân không cần thiết.
Liệu máy chủ webhook có khả dụng không?
Webhook đẩy từ máy chủ hiện không nằm trong tài liệu SDK đã được công bố. Vui lòng thảo luận kỹ lưỡng với bộ phận Kỹ thuật Đối tác về bất kỳ yêu cầu sự kiện phía máy chủ nào trước khi sử dụng chúng.
Các nhà phát triển có thể tìm sự trợ giúp ở đâu?
Hãy sử dụng kênh hỗ trợ kỹ thuật được cung cấp trong quá trình hướng dẫn sử dụng hoặc gửi email. support@spreeai.comHãy bao gồm môi trường, mã định danh sản phẩm, trình duyệt hoặc thiết bị, dấu thời gian và đường dẫn tái tạo ngắn gọn — tuyệt đối không gửi thông tin bí mật.
Khi nào tính năng hỗ trợ Mạng lưới Đối tác Amazon sẽ khả dụng?
Việc tích hợp Mạng lưới Đối tác Amazon hiện đang trong quá trình phát triển. Nó được đánh dấu là "Sắp ra mắt" cho đến khi giao diện đăng ký và giao diện sản xuất sẵn sàng cho các nhà phát triển bên ngoài.
Sẵn sàng xây dựng chưa?