Chợ mạng
SPREEAI dành cho các nhà phát triển
Xây dựng phòng thử đồ
vào mọi màn hình.
Bắt đầu với Shopify, Web SDK hoặc tích hợp API đã được phê duyệt. Trung tâm này giúp nhóm của bạn chuyển từ quyết định đầu tiên sang một bản ra mắt đã được thử nghiệm.
- 04
- các con đường tích hợp
- v2.1
- Web SDK hiện tại
- 01
- Danh sách kiểm tra trước khi khởi chạy
Chọn con đường của bạn
Bắt đầu từ nơi bạn
commerce stack vẫn tồn tại.
Chọn con đường nhanh nhất phù hợpกับ cửa hàng của bạn. Bạn có thể chuyển từ một ứng dụng được quản lý sang SDK tùy chỉnh hoặc tích hợp API khi trải nghiệm phát triển.
Trực tiếpSắp ra mắt
Con đường nhanh nhất
Ứng dụng Shopify
Cài đặt, đồng bộ trang phục, tùy chỉnh và khởi chạy mà không cần backend tùy chỉnh.Tốt nhất cho các cửa hàng Shopify ↗ v2.1.0Web tùy chỉnh
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 ↗ Tài liệuỨng dụng di động thuần túy
SDK iOS
Đưa trải nghiệm SPREEAI vào hành trình mua sắm trên iOS hiện có.Mở hướng dẫn iOS ↗ Tài liệuỨng dụng di động thuần túy
Bộ công cụ phát triển phần mềm Android
Tích hợp tính năng thử đồ vào trải nghiệm sản phẩm Android với các điều khiển nguyên bản.Mở hướng dẫn Android ↗ Truy cập dành cho đối tácHệ thống tùy chỉnh
API công khai
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 ↗Bắt đầu nhanh Web SDK
Từ cài đặt đến
nút hoạt động.
Xác thực một lần, sau đó hiển thị tính năng thử đồ hoặc chọn kích cỡ ở bất kỳ đâu trên trang. Sử dụng thông tin xác thực thử nghiệm được cấp trong quá trình hướng dẫn và tuyệt đối không đặt mã bí mật của máy khách (client secret) trong mã trình duyệt.
npm install @spreeai/web-sdk
# hoặc
yarn add @spreeai/web-sdkimport { init } from "@spreeai/web-sdk";
const sdk = await init({
clientId: "your-client-id",
partnerId: "your-partner-id",
});
if (sdk) {
await sdk.renderTryOnButton({
elementId: "spreeai-try-on",
garments: [{ garmentId: "your-garment-id" }],
enableAddToCart: true,
});
}events: {
onTryOnButtonClick: (event) => {
analytics.track("try_on_started", event);
},
onAddToCartClicked: async (event) => {
// Kết nối với quy trình giỏ hàng hiện tại của bạn.
},
}Mô hình tích hợp
Bốn hệ thống.
Một khoảnh khắc khách hàng.
ID sản phẩm, các biến thể, hình ảnh và bối cảnh kinh doanh.
Các sản phẩm may mặc chuyển qua các trạng thái xử lý, kiểm tra và sẵn sàng.
Cửa hàng của bạn yêu cầu trải nghiệm cho một sản phẩm đủ điều kiện.
Thử đồ, tìm kích cỡ, hoàn thiện bộ trang phục và quay lại thanh toán.
Quy trình sản xuất
Lấy tích phân
về đích.
Một màn ra mắt thành công không chỉ đơn thuần là một chiếc nút hoạt động. Hãy sử dụng trình tự này để đồng bộ hóa quyền truy cập, tài nguyên, hành vi, chất lượng và đo lường.
- 01Chủ sở hữu · Sản phẩm + Thương mại
Xác định phạm vi của hành trình đầu tiên
Chọn một kênh, một nhóm danh mục, một thời điểm khách hàng và một đo lường thành công.
- 02Chủ sở hữu · Kỹ thuật
Chuẩn bị quyền truy cập
Xác nhận ID đối tác, thông tin xác thực khách hàng đã được phê duyệt, quyền cửa hàng và môi trường staging.
- 03Chủ sở hữu · Nhóm danh mục sản phẩm
Gửi các tài nguyên sạch
Cung cấp một trang phục cho mỗi hình ảnh, yêu cầu góc nhìn phía trước, độ phân giải cao, ánh sáng sạch và tên tệp phù hợp với mã SKU.
- 04Chủ sở hữu · Lập trình viên Front-end
Tích hợp vào môi trường staging
Chỉ hiển thị trên các sản phẩm đủ điều kiện, đồng thời liên kết các biến thể với hành vi của giỏ hàng và đồng bộ điểm truy cập với thương hiệu.
- 05Chủ sở hữu · QA + thương hiệu
Chạy kiểm tra chất lượng ra mắt
Kiểm tra thiết bị di động và máy tính để bàn, độ phủ trình duyệt, khả năng tiếp cận, hiệu suất, độ trung thực hình ảnh và trạng thái lỗi.
- 06Chủ sở hữu · Thương mại + phân tích
Kích hoạt và đo lường
Bật các sản phẩm Sẵn sàng, xuất trải nghiệm đã dàn dựng và theo dõi mức độ áp dụng, tỷ lệ hoàn thành và chuyển đổi.
Đường cơ sở tài sản
Đầu vào tốt tạo ra kết quả tốt hơn.
- JPEG hoặc PNG
- Tối thiểu 2.000 × 2.000 px
- Yêu cầu ảnh chụp chính diện
- Khuyên dùng góc nhìn từ phía sau
- Ánh sáng trung tính, đều
- SKU hoặc ID kiểu dáng 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 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 ↗ Tích hợp được quản lýQuy trình thiết lập cửa hàng Shopify
Cài đặt ứng dụng, chấp nhận các thỏa thuận, đồng bộ trang phục, tùy chỉnh nút và phát trực tiếp.
Tài liệu tham khảo chính thức ↗ Web SDKGiao diện API
Xem xét việc khởi tạo, các tùy chọn kết xuất, kích thước, tùy chỉnh và giao diện có kiể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 đã xác thực.
Tài liệu tham khảo Swagger ↗ Chất lượngTài sản hàng may mặc
Chuẩn bị hình ảnh sản phẩm và siêu dữ liệu có thể dễ dàng chuyển qua quá trình nhập liệu và kiểm duyệt.
Hướng dẫn SPREEAI ↗ Sản xuấtKiểm thử chất lượng & ra mắt
Sử dụng danh sách kiểm tra về trình duyệt, hiệu suất, khả năng truy cập và phát hành được chia sẻ.
Hướng dẫn SPREEAI ↗ Hỗ trợKhắc phục sự cố
Giải quyết các sự cố phổ biến nhất về xác thực, đủ điều kiện, kết xuất và hiệu suất.
Hướng dẫn SPREEAI ↗ Tài liệuHướng dẫn triển khai
Duyệt qua các hướng dẫn bắt đầu nhanh, tiêu chuẩn tài sản, danh sách kiểm tra ra mắt và hướng dẫn khắc phục sự cố công khai.
Mở tài liệu ↗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 để sản xuất
Chi tiết bảo vệ
trải nghiệm của khách hàng.
Bảo mật
Giữ bí mật ở phía máy chủ, chỉ sử dụng các môi trường đã cấp và luân chuyển thông tin xác thực thông qua quy trình làm việc của đối tác.
Quyền riêng tư
Yêu cầu hình ảnh khách hàng với sự đồng ý rõ ràng và điều chỉnh việc xử lý dữ liệu theo 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 ở nơi cần thiết, kiểm thử các thiết bị thực tế và theo dõi sự suy giảm chất lượng của trang sản phẩm.
Khả năng tiếp cận
Duy trì khả năng truy cập bằng bàn phím, thứ tự tiêu điểm, tên có thể truy cập và đường dẫn khả dụng khi trải nghiệm không khả dụng.
Câu hỏi thường gặp dành cho lập trình viên
Các câu hỏi trước
commit đầu tiên.
Chúng ta nên chọn tích hợp nào?
Sử dụng Ứng dụng Shopify cho đường dẫn được quản lý nhanh nhất, Web SDK cho các vị trí web tùy chỉnh hoặc không đầu (headless), các 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 giới thiệu.
Thông tin đăng nhập xuất phát 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 giới thiệu (onboarding). Trình duyệt SDK sử dụng ID khách hàng và ID đối tác. Không bao giờ được nhúng bí mật khách hàng (client secret) vào mã nguồn front-end.
Ứng dụng Shopify có yêu cầu khóa API không?
Quy trình giới thiệu ứng dụng Shopify hiện tại kết nối cửa hàng sau bước thỏa thuận bắt buộc và đăng ký; ứ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 trang phục đã xử lý xong, đã bật tính năng Thử đồ (Try-On), ánh xạ tới sản phẩm hoặc biến thể đang hoạt động, và khối ứng dụng (app block) hoặc vùng chứa SDK có mặt trên mẫu sản phẩm.
Những sự kiện khách hàng nào có sẵn?
Các lệnh gọi lại SDK đã được tài liệu hóa bao gồm các thao tác nhấp vào nút Thử đồ và tương tác thêm vào giỏ hàng. Hãy kết nối chúng với lớp phân tích của bạn mà không bao gồm hình ảnh của khách hàng hoặc dữ liệu cá nhân không cần thiết.
Webhook của máy chủ có sẵn không?
Webhook đẩy từ máy chủ không phải là một phần của tài liệu SDK hiện được công bố. Hãy xác định phạm vi của bất kỳ yêu cầu sự kiện phía máy服务器 nào với bộ phận Kỹ thuật Đối tác trước khi dựa vào nó.
Các lập trình viên tìm kiếm sự trợ giúp ở đâu?
Sử dụng đường dẫn hỗ trợ kỹ thuật được cung cấp trong quá trình giới thiệu hoặc qua email support@spreeai.com. Bao gồm môi trường, ID sản phẩm, trình duyệt hoặc thiết bị, dấu thời gian và các bước tái hiện ngắn gọn—tuyệt đối không gửi thông tin bí mật.
Khi nào hỗ trợ Mạng lưới Đối tác Amazon sẽ có sẵn?
Việc tích hợp Mạng lưới Đối tác Amazon đang được phát triển. Tính năng này được chủ ý đánh dấu là Sắp ra mắt cho đến khi giao diện giới thiệu và 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?