Sắp tới Amazon Partner Network và các nền tảng khác, với nhiều cách để tích hợp SPREEAI vào hàng thương mại của bạn.Các cập nhật sẽ xuất hiện ở đây trước tiên

Bắt đầu nhanh Web SDK

Sự tích hợp đầu tiên của bạn.

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-sdk

import { 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.

01Danh mục của bạn

ID sản phẩm, các biến thể, hình ảnh và bối cảnh kinh doanh.

02Quá trình nạp dữ liệu SPREEAI

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.

03SDK hoặc API

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.

04Hành động của khách hàng

Thử đồ, tìm kích cỡ, hoàn thiện bộ trang phục và quay lại thanh toán.

Một con đường tập trung để khởi động

chuẩn bị Kết nối
Hãy sống với sự tự tin

Ba dặm, với một danh sách kiểm tra thực tế cho mỗi.

01 - Chuẩn bị
Một điểm khởi đầu rõ ràng.
Thích hợp hành trình, truy cập và thư mục.
Danh sách kiểm tra chuẩn bị
- Chọn một kênh, nhóm danh mục và đo thành công.
- Kiểm tra quyền truy cập đối tác, chứng nhận và giấy phép xếp hạng.
- Cung cấp hình ảnh trang phục sạch, SKU-liên kết.
Sản phẩm · Kỹ thuật · Catalogue
02 · Kết nối
Hãy để nó cảm thấy bản địa.
Xây dựng trong đỉnh Kiểm tra toàn bộ chuyến đi.
Danh sách kiểm tra Integration
- Thuê cho các sản phẩm đủ điều kiện và kết nối biến thể và hành vi xe.
- Kết hợp kinh nghiệm với thương hiệu.
- Kiểm tra các trạng thái di động, máy tính để bàn, khả năng truy cập, hiệu suất và thất bại.
Front-end · QA · Thương hiệu
03 - Bắt đầu
Học hỏi từ việc sử dụng thực tế
Cho phép sản phẩm và đo lường sẵn sàng.
Bắt đầu checklist
- Kiểm tra sự sẵn sàng của sản phẩm và xuất bản kinh nghiệm giai đoạn.
- Kiểm tra việc chấp nhận, hoàn thành và chuyển đổi.
- Sử dụng kết quả để hướng dẫn danh mục hoặc chuyến đi tiếp theo.
Thương mại · Analytics

Đườ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

Mở danh sách kiểm tra tài sản

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.

Reference 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.

Reference chính thức Web SDK

Giao 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.

Reference chính thức API Đối tác

Tà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.

Swagger tham khảo Chất lượng

Tà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.

SPREEAI Hướng dẫn Sản xuất

Kiể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ẻ.

SPREEAI Hướng dẫn 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.

SPREEAI Hướng dẫn Tài liệu

Hướ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.

Tài liệu mở

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?

Hãy chọn con đường.
Chúng tôi sẽ giúp bạn vận chuyển nó.

Đặt lịch khám phá kỹ thuật Tìm tất cả chủ đề docs Mở Không gian làm việc của Đối tác

Xây dựng phòng thử đồvào mọi màn hình.

Bắt đầu từ nơi bạncommerce stack vẫn tồn tại.

Ứng dụng Shopify

Web SDK

SDK iOS

Bộ công cụ phát triển phần mềm Android

API công khai

Mạng lưới đối tác Amazon

Sự tích hợp đầu tiên của bạn.

Bốn hệ thống.Một khoảnh khắc khách hàng.

chuẩn bị Kết nốiHãy sống với sự tự tin

Một điểm khởi đầu rõ ràng.

Hãy để nó cảm thấy bản địa.

Học hỏi từ việc sử dụng thực tế