建造與
SPREEAI.

Shopify 應用程式

Use the managed app when the store runs on Shopify and does not need a custom backend. The current onboarding flow connects the store after agreements and subscription; it does not require copying API keys into the setup screen.

1. 安裝官員 SPREEAI 應用並完成管理的同意流。
2. 同步初始目錄組,並審查產品準備狀態。
3. 定製配置和風格在一個重複主題。
4. Validate eligible products, variants, mobile behavior and add-to-cart.
5. 僅在品牌和QA批准後發佈。

開啟官方 Shopify 登機指南

網頁 SDK 快速啟動

使用 @ spreeai 網頁Sdk 定製的配置、風格、活動、尺寸和車輛行為。

npm install @spreeai/web-sdk

import { init } from "@spreeai/web-sdk";

const sdk = await init({
  clientId: "your-client-id",
  partnerId: "your-partner-id"
});

sdk.renderTryOnButton({
  selector: "#spreeai-try-on",
  productId: product.id,
  enableAddToCart: true
});

Initialize once, render only for an eligible product and connect documented client callbacks to your existing analytics. Confirm the current interface in the 官方 Web SDK API 參考

火災接入

Use the public Swagger reference only for server-side workflows approved during onboarding. Keep secrets on your server, separate test and production access, and scope credentials to the minimum required environment.

Direct REST endpoints, webhooks or authentication behaviors not present in the approved public reference should be treated as unavailable until Partner Engineering confirms them.

打開已批准的公共 API 參考

服裝資產基線

• JPEG or PNG; 2,000 × 2,000 px minimum, with approximately 4K preferred.
• One garment per image, centered with clean edges and neutral, even lighting.
• 前景要求;後景建議,當此體驗被啟用時。
• Stable SKU, style or garment ID included in the filename and catalogue record.
• No hands, hangers, styling props, watermarks or unrelated garments blocking the item.
• 變量地圖在允許體驗之前檢查。

QA 和啟動

• 在當前的移動和桌面瀏覽器上測試完整的客戶行程。
• Verify product and variant mapping, garment readiness and cart behavior.
• 檢查鍵盤訪問、焦點順序、可用的名稱和落後行為。
• 產品頁面性能測量,在可用前和後 SPREEAI.
• Exercise loading, empty, unavailable, timeout and retry states.
• 確認同意語言和客戶圖像的批准處理。
• 獲得工程,商業,QA和品牌簽名之前生產。

麻煩解決

按鈕不出現

Confirm SDK initialization, client and partner identifiers, the target selector, product eligibility, garment readiness and variant mapping. Then check browser console and network errors without sharing tokens.

出現錯誤的產品或變量

將商店前產品和變量ID與發送到 SPREEAI. 確認交付請求在買家改變變量時會發生變化。

體驗是緩慢或不可用

Test a known-ready product, verify the active environment, inspect blocked requests and compare a clean browser session. Capture a timestamp and reproducible sequence for support.

開發者支持

電子郵件 support@spreeai.com 與環境、產品或服裝 ID、瀏覽器或 vic 即時,預期的行為和複製步驟。 不要包含秘密或客戶圖像。