Xây dựng với
SPREEAI.

Ứng dụng Shopify

Hãy sử dụng ứng dụng được quản lý khi cửa hàng chạy trên Shopify và không cần hệ thống phụ trợ tùy chỉnh. Quy trình thiết lập hiện tại kết nối với cửa hàng sau khi hoàn tất thỏa thuận và đăng ký; nó không yêu cầu sao chép khóa API vào màn hình thiết lập.

1. Cài đặt ứng dụng chính thức SPREEAI và hoàn tất quy trình chấp thuận được quản lý.
2. Đồng bộ nhóm danh mục ban đầu và xem xét trạng thái sẵn sàng của sản phẩm.
3. Tùy chỉnh vị trí và kiểu dáng trong một giao diện được sao chép.
4. Xác thực các sản phẩm đủ điều kiện, biến thể, hành vi trên thiết bị di động và thao tác thêm vào giỏ hàng.
5. Chỉ được phép đăng tải sau khi đã được bộ phận thương hiệu và bộ phận kiểm soát chất lượng phê duyệt.

Mở hướng dẫn nhập cảnh chính thức của Shopify

Hướng dẫn nhanh về Web SDK

Sử dụng @spreeai/web-sdk Để tùy chỉnh vị trí, kiểu dáng, sự kiện, kích thước và hành vi giỏ hàng.

npm install @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,
  });
}

Khởi tạo một lần, chỉ hiển thị cho sản phẩm đủ điều kiện và kết nối các hàm gọi lại của máy khách đã được ghi lại với hệ thống phân tích hiện có của bạn. Xác nhận giao diện hiện tại trong... Tài liệu tham khảo API Web SDK chính thức

Truy cập API

Chỉ sử dụng tham chiếu Swagger công khai cho các quy trình làm việc phía máy chủ đã được phê duyệt trong quá trình thiết lập ban đầu. Giữ bí mật trên máy chủ của bạn, tách biệt quyền truy cập thử nghiệm và sản xuất, và giới hạn thông tin xác thực cho môi trường tối thiểu cần thiết.

Các điểm cuối REST trực tiếp, webhook hoặc hành vi xác thực không có trong tài liệu tham khảo công khai đã được phê duyệt nên được coi là không khả dụng cho đến khi bộ phận Kỹ thuật Đối tác xác nhận chúng.

Mở tài liệu tham khảo API công khai đã được phê duyệt.

Cơ sở dữ liệu tài sản may mặc

• Định dạng JPEG hoặc PNG; kích thước tối thiểu 2000 × 2000 pixel, ưu tiên độ phân giải khoảng 4K.
• Một hình ảnh chỉ hiển thị một món đồ may mặc, được đặt ở vị trí trung tâm với các đường viền sắc nét và ánh sáng trung tính, đều.
• Cần hiển thị hình ảnh mặt trước; nên hiển thị hình ảnh mặt sau khi tính năng này được bật.
• Mã SKU, kiểu dáng hoặc mã sản phẩm ổn định được bao gồm trong tên tệp và bản ghi danh mục.
• Không có tay, móc treo, đạo cụ tạo kiểu, hình mờ hoặc quần áo không liên quan che khuất sản phẩm.
• Đã kiểm tra ánh xạ biến thể trước khi kích hoạt trải nghiệm.

Kiểm thử chất lượng và ra mắt sản phẩm

• Kiểm tra toàn bộ hành trình trải nghiệm khách hàng trên các trình duyệt di động và máy tính để bàn hiện tại.
• Kiểm tra việc ánh xạ sản phẩm và biến thể, tình trạng sẵn có của sản phẩm may mặc và hành vi giỏ hàng.
• Kiểm tra quyền truy cập bàn phím, thứ tự tiêu điểm, tên có thể truy cập và hành vi dự phòng.
• Đo lường hiệu suất trang sản phẩm trước và sau khi kích hoạt SPREEAI.
• Các trạng thái tải bài tập: trống, không khả dụng, hết thời gian chờ và thử lại.
• Xác nhận ngôn ngữ đồng ý và cách thức xử lý hình ảnh khách hàng đã được phê duyệt.
• Cần có sự chấp thuận từ bộ phận kỹ thuật, thương mại, kiểm soát chất lượng và thương hiệu trước khi sản xuất.

Khắc phục sự cố

Nút không hiển thị

Xác nhận quá trình khởi tạo SDK, mã định danh máy khách, ID phần tử máy chủ, tính hợp lệ của sản phẩm, tình trạng sẵn sàng của trang phục và việc ánh xạ biến thể. Sau đó, kiểm tra bảng điều khiển trình duyệt và lỗi mạng mà không cần chia sẻ mã thông báo.

Sản phẩm hoặc biến thể không chính xác đã xuất hiện.

So sánh ID sản phẩm và biến thể trên trang cửa hàng với các bản ghi được gửi đến SPREEAI. Xác nhận rằng yêu cầu được hiển thị thay đổi khi người mua hàng thay đổi biến thể.

Trải nghiệm chậm hoặc không khả dụng

Kiểm tra một sản phẩm đã được xác nhận là sẵn sàng sử dụng, xác minh môi trường hoạt động, kiểm tra các yêu cầu bị chặn và so sánh với một phiên trình duyệt sạch. Ghi lại dấu thời gian và trình tự có thể tái tạo để hỗ trợ.

Nhận hỗ trợ từ nhà phát triển

E-mail support@spreeai.com Bao gồm thông tin về môi trường, mã sản phẩm hoặc quần áo, trình duyệt hoặc thiết bị, dấu thời gian ước tính, hành vi dự kiến ​​và các bước tái hiện. Không bao gồm thông tin bí mật hoặc hình ảnh của khách hàng.