Pazar yeri
Geliştiriciler için SPREEAI
Soyunma odasını kur
her ekrana.
Shopify, Web SDK veya onaylanmış bir API entegrasyonu ile başlayın. Bu merkez, ekibinizi ilk karardan test edilmiş bir lansmana taşır.
- 04
- entegrasyon yolları
- v2.1
- güncel Web SDK'sı
- 01
- fırlatma kontrol listesi
Yolunu seç
Olduğun yerden başla
ticaret yığını yaşıyor.
Mağazanıza en uygun olan en hızlı yolu seçin. Deneyiminiz geliştikçe yönetilen bir uygulamadan özel bir SDK veya API entegrasyonuna geçiş yapabilirsiniz.
CanlıÇok yakında
En hızlı yol
Shopify Uygulaması
Özel bir arka uç (backend) olmadan kurun, kıyafetleri senkronize edin, özelleştirin ve başlatın.Shopify Mağazaları İçin En İyisi ↗ v2.1.0Özel web
Web SDK
Denetim yerleşimi, biçimlendirmesi, olayları, boyutlandırması ve sepete ekleme davranışını kontrol edin.JavaScript + TypeScript ↗ BelgelerYerel mobil
iOS SDK
SPREEAI deneyimini mevcut bir iOS alışveriş yolculuğuna entegre edin.iOS kılavuzunu aç ↗ BelgelerYerel mobil
Android SDK
Yerel kontrollerle Android ürün deneyimine üzerinizde deneme (try-on) özelliğini entegre edin.Android kılavuzunu aç ↗ İş ortağı erişimiÖzel sistemler
Açık API'ler
Sunucu tarafı ve katalog iş akışları için onaylanmış API referansını kullanın.API referansını aç ↗Web SDK hızlı başlangıç kılavuzu
Kurulumdan
çalışan düğme.
Bir kez kimlik doğrulaması yapın, ardından sayfanın herhangi bir yerinde üzerimde dene veya beden seçimi özelliğini oluşturun. Kayıt sürecinde verilen test kimlik bilgilerini kullanın ve asla tarayıcı koduna bir istemci gizli anahtarı koymayın.
npm install @spreeai/web-sdk
# veya
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) => {
// Mevcut sepet iş akışınıza bağlanın.
},
}Entegrasyon modeli
Dört sistem.
Tek bir müşteri anı.
Ürün kimlikleri, varyantlar, görseller ve pazarlama içeriği.
Giysiler işleme, inceleme ve kullanıma hazırlık aşamalarından geçer.
Mağazanız uygun bir ürün için deneyim talebinde bulunur.
Dene, bedenini bul, kombinini tamamla ve kasaya geri dön.
Üretim yolu
İntegrali al
bitiş çizgisini geçmek.
Sorunsuz bir lansman, çalışan bir tuştan çok daha fazlasıdır. Erişimi, varlıkları, davranışları, kaliteyi ve ölçümlemeyi aynı hizaya getirmek için bu sırayı kullanın.
- 01Sahip · Ürün + Ticaret
İlk yolculuğun kapsamını belirle
Bir kanal, katalog grubu, müşteri anı ve başarı ölçütü seçin.
- 02Sahip · Mühendislik
Erişimi hazırla
Ortak kimliğini, onaylanmış müşteri kim bilgilerini, mağazafönü izinlerini ve hazırlık ortamını onaylayın.
- 03Sahip · Katalog ekibi
Temiz varlıklar gönderin
Görsel başına bir kıyafet, ön görünüm zorunludur, yüksek çözünürlük, temiz aydınlatma ve Stok Kodu (SKU) uyumlu dosya adları sağlayın.
- 04Sorumlu · Ön yüz
Staging ortamına entegre et
Yalnızca uygun ürünlerde gösterin, varyantları ve sepet davranışını bağlayın ve giriş noktasını marka ile eşleştirin.
- 05Sahip · QA + marka
Lansman Kalite Kontrolünü Çalıştır
Mobil ve masaüstü testi, tarayıcı kapsamı, erişilebilirlik, performans, görsel doğruluk ve hata durumları.
- 06Sahip · Ticaret + analitik
Etkinleştir ve ölç
Hazır ürünleri açın, aşamalandırılmış deneyimi yayınlayın ve benimsenmeyi, tamamlanmayı ve dönüşümü izleyin.
Varlık taban çizgisi
İyi girdi daha iyi bir sonuç sağlar.
- JPEG veya PNG
- Minimum 2.000 × 2.000 piksel
- Ön görünüm gerekli
- Arka görünüm tavsiye edilir
- Nötr, eşit aydınlatma
- Dosya adında SKU veya stil ID'si
Geliştirici referansı
Sonrakini bul
faydalı cevap.
Buradan başla
Başlarken
Erişimi, desteklenen platformları ve ekibinizin vermesi gereken ilk kararları anlayın.
Resmi referans ↗ Yönetilen entegrasyonShopify başlangıç kılavuzu
Uygulamayı yükleyin, sözleşmeleri kabul edin, kıyafetleri senkronize edin, düğmeyi özelleştirin ve canlıya geçin.
Resmi referans ↗ Web SDKAPI yüzeyi
Başlatma, oluşturma seçenekleri, boyutlandırma, özelleştirme ve türü belirtilmiş arayüzleri inceleyin.
Resmi referans ↗ İş Ortağı API'siGenel API referansı
Kimliği doğrulanmış iş ortaklarının kullanımına sunulan onaylı sunucu tarafı arayüzünü keşfedin.
Swagger referansı ↗ KaliteGiysi varlıkları
Veri alımından ve incelemeden sorunsuz bir şekilde geçen ürün görselleri ve meta verileri hazırlayın.
SPREEAI kılavuzu ↗ ÜretimKalite Güvencesi ve Lansman
Paylaşılan tarayıcı, performans, erişilebilirlik ve canlıya geçiş kontrol listesini kullanın.
SPREEAI kılavuzu ↗ DestekSorun Giderme
En yaygın kimlik doğrulama, uygunluk, sunum ve performans sorunlarını çözün.
SPREEAI kılavuzu ↗ BelgelendirmeUygulama kılavuzları
Herkese açık hızlı başlangıç kılavuzlarına, varlık standartlarına, lansman kontrol listelerine ve sorun giderme kılavuzlarına göz atın.
Belgeleri aç ↗Eşleşen geliştirici kaynağı yok. “Shopify,” “SDK,” “assets” veya “QA” kelimelerini deneyin.”
Üretime yönelik derle
Koruyan detaylar
müşteri deneyimi.
Güvenlik
Gizli bilgileri sunucu tarafında tutun, yalnızca verilmiş ortamları kullanın ve kimlik bilgilerini iş ortağı iş akışı aracılığıyla yenileyin.
Gizlilik
Açık rıza alarak müşteri görselleri talep edin ve veri işlemeyi onaylı entegrasyon planınızla uyumlu hale getirin.
Performans
Deneyimi gerekli olduğu yerde yükleyin, gerçek cihazları test edin ve ürün sayfası gerilemelerini izleyin.
Erişilebilirlik
Deneyim kullanılamadığında klavye erişimini, odak sırasını, erişilebilir adları ve kullanılabilir bir yolu koruyun.
Developer FAQ
Questions before
the first commit.
Which integration should we choose?
Use the Shopify App for the fastest managed path, the Web SDK for custom or headless web placement, the native SDKs for app experiences, and the approved API reference for server-side workflows agreed during onboarding.
Where do credentials come from?
SPREEAI issues the partner ID and approved credentials during onboarding. The browser SDK uses a client ID and partner ID. Never embed a client secret in front-end code.
Does the Shopify App require API keys?
The current Shopify App onboarding flow connects the store after the required agreements and subscription step; the managed app does not require copying keys into the setup screen.
Why does the Try-On button not appear?
Confirm the garment has completed processing, is enabled for Try-On, maps to the active product or variant, and that the app block or SDK container is present on the product template.
Which client events are available?
The documented SDK callbacks cover Try-On button clicks and add-to-cart interactions. Connect them to your analytics layer without including customer imagery or unnecessary personal data.
Are server webhooks available?
Server-push webhooks are not part of the currently published SDK documentation. Scope any server-side event requirement with Partner Engineering before relying on it.
Where do developers get help?
Use the technical support path provided during onboarding or email support@spreeai.com. Include the environment, product ID, browser or device, timestamp and a concise reproduction path—never send secrets.
When will Amazon Partner Network support be available?
The Amazon Partner Network integration is in development. It is intentionally marked Coming Soon until the onboarding and production interface are ready for external developers.
Ready to build?