Dokümantasyon

SDK 2.0 · ENTEGRASYON

Katalog ve çeşitleri

Vitrin ürünlerini uygun SPREEAI giysilere ve mevcut ürün verilerine bağlayın.

Doğru tanımlayıcıyı kullanın

Vitrin ürün kimliği, SKU veya varyant kimliği otomatik olarak bir SPREEAI giysi kimliği değildir. Beslemeniz veya Shopify senkronizasyon iş akışınız aracılığıyla oluşturulan bir eşlemeyi koruyun. Giysi, kimliği doğrulanmış ortağa ait olmalı ve denemeye hazır olmalıdır.

Bir ürün seçimini eşleyin

TypeScript
import type { RenderTryOnButtonOptions } from "@spreeai/web-sdk";

export const productOptions: RenderTryOnButtonOptions = {
  elementId: "spreeai-try-on",
  garments: [{
    garmentId: "SPREEAI_GARMENT_ID",
    variant: { color: "blue", fit: "regular" },
    availableSizes: ["S", "M", "L"],
    price: "$59.00",
  }],
  showSizes: true,
  showPrices: true,
};

variant rengi, uyumu, cinsiyeti ve stili filtreleyebilir. Belgelenen eşleştirme büyük/küçük harfe duyarlı değildir. Rengi ismine göre eşleştirin; blue, onaltılık bir değer yerine.

Giysi hazırlığı

Durum veya koşulEntegrasyon eylemi
Senkronize edilmedi / besleme tamamlanmadıNormal ürün deneyimini koruyun; deneme olanağı vaat etmeyin.
Shopify'de hazır ancak devre dışıAmaçlanan ürünü inceleyin ve açıkça etkinleştirin. Hazır olmak tek başına onu canlı kılmaz.
Mevcut giysi ve eşleşen varyantBu seçimin düğmesini işleyin.
Eşleşen kıyafet yokDizideki ilk giysiye geri dönüş bekliyoruz.
Doğrulama başarısızHiçbir düğme görüntülenmiyor; konsolu ve ürün eşlemesini inceleyin.

Ürün verilerini güncel tutun

  • Ürün seçimi değiştiğinde görüntülenen fiyatı ve stoktaki boyutları güncelleyin.
  • Ayrı ürün düğmeleri için benzersiz kapsayıcı kimlikleri kullanın.
  • Bir düğmeyi yeniden işlerken mevcut giysi ve varyant seçimini iletin.
  • Bir sepet değişimi oluşturmadan önce, döndürülen sepet verilerini kendi kataloğunuzla karşılaştırarak inceleyin.

Giysi varlıklarını hazırlayın

Akımı kullan giysi görseli standartları desteklenen görüntüler ve meta veriler için. Ürünleri etkinleştirmeden önce işleme sorunlarını çözün; Üretim verileri yerine yer tutucu giysi kimliklerini kullanmayın.

Kaynak referansları

Sayfa başlıklarını ve içeriğini arayın. Kaçış aramayı kapatır.

Dilinizi seçin.