Sitenize 3D Baskı Teklif Widget'ı Yerleştirin

Genel Bakış

Quote3D Gömülebilir Widget'ı, herhangi bir web sitesinde müşterilerinize anında 3D baskı fiyat teklifleri sunmanıza olanak tanıyan kodsuz/az kodlu bir çözümdür. İster özel bir site, ister WordPress veya Shopify kullanın, 3D model görüntüleme ile sipariş verme arasındaki boşluğu sorunsuz bir şekilde kapatabilirsiniz.

Temel Özellikler

• 3D Model Görüntüleyici: Yüklenen STL, OBJ ve 3MF dosyalarının etkileşimli önizlemesi.
• Anında Fiyatlandırma: Kendi malzeme ve yazıcı profillerinize dayalı otomatik maliyet hesaplaması.
• Çoklu Teknoloji: Belirli hesaplama mantığıyla FDM, SLA ve SLS teknolojilerini destekler.
• Özel Temalar: Glassmorphism ve özel renk paletleri ile marka estetiğinize uyum sağlayın.
• Müşteriler İçin Sıfır Yapılandırma: Müşterilerinizin teknik dilimleme detaylarını bilmesine gerek yoktur; her şey Quote3D tarafından halledilir.
• Platform Eklentileri: WooCommerce ve Shopify için kullanıma hazır eklentiler.

Neler Yapabilirsiniz?

• Gerçek Zamanlı E-Ticaret Senkronizasyonu: Fiyat tekliflerini doğrudan mağazanızın sepetine bağlamak için 'Sepete Ekle' olaylarını kullanın.
• Otomatik Potansiyel Müşteri Oluşturma: Müşteri gereksinimlerini ve model verilerini otomatik olarak yakalayın.
• Küçük Resim Oluşturma: Üretim takibi için model ekran görüntülerini otomatik olarak yakalayın ve saklayın.
• Esnek Yönlendirmeler: Başarılı bir hesaplamadan sonra müşterileri belirli bir açılış sayfasına gönderin. Yönlendirme hedefi bir http veya https URL'si olmalıdır.

Platform Entegrasyonları: Shopify, WooCommerce ve Daha Fazlası

Quote3D Widget, modern web teknolojileriyle oluşturulmuştur ve neredeyse her platformda çalışır. Popüler sistemler için hazır entegrasyon çözümlerimiz bulunmaktadır:

Diğer platformlar ve özel yapılar

• Wix: Velo ve Custom Element üzerinden gelişmiş entegrasyon.
• Squarespace: Kod blokları üzerinden hızlı kurulum.
• PrestaShop: Smarty şablon motoru ile uyumlu yapılar.
• OpenCart: Twig tabanlı modern tema desteği.
• Özel Yazılımlar: Her türlü React, Vue veya Vanilla JS projesine JS SDK ile entegre edilebilir.

Teknik Çalışma Prensibi

Quote3D Widget, yüksek performanslı bir Iframe veya modern bir JS SDK olarak çalışır. İşte nasıl çalıştığı:

• İzole Çalışma: Widget, kendi korumalı alanında (Iframe) çalışır, böylece web sitenizin stilini bozmaz.
• Gerçek Zamanlı İletişim: Widget, hesaplama sonuçlarını sayfanıza 'postMessage' API'si üzerinden iletir. SDK'yı kullandığınızda olaylar herhangi bir dinleyiciye yayınlanmak yerine yalnızca widget'ı gömen kaynağa teslim edilir.
• Otomatik Boyutlandırma: SDK kullanıldığında, widget içeriğe göre yüksekliğini otomatik olarak ayarlar.

Widget'ın yanı sıra API ile çalışmak

Widget kendi API trafiğini dahili olarak yönetir — o rotaları siz çağırmazsınız. Aynı veriyi kendi kodunuzdan okumak veya üzerinde işlem yapmak istediğinizde, Temel Kavramlar'da açıklanan genel v2 uç noktalarını, bir token kimliği değil gerçek bir API Bearer token'ı ile https://api.quote3d.com/v2 üzerinde kullanın. Bir alışverişçinin yapılandırılmış bir parçayı sepetine eklemesine tepki vermek için doğrudan bir şey çağırmak yerine widget.added_to_cart webhook'una abone olun.

Güvenlik ve Doğrulama

Widget, Quote3D'yi tarayıcıdan çağırır, bu yüzden token'ı sayfa kaynağını görüntüleyen herkese görünür. Özel bir widget token'ı oluşturun, widget kapsamıyla sınırlandırın ve mağaza kaynaklarınıza bağlayın. Döndürme her iki kısıtlamayı da korur, dolayısıyla döndürülmüş bir widget token'ı asla tam erişimli hale gelmez.

Yüklenen dosyalar ve önizlemeler

Widget aracılığıyla yüklenen dosyalar şifrelenmiş olarak saklanır ve herkese açık olarak erişilemez. Sepete ekle (add-to-cart) payload’ı size, kendi mağazanızdan oluşturulan mutlak bir bağlantı olan thumbnailUrl’ı verir: bunu tam olarak alındığı gibi saklayın. Bağlantıyı yeniden yazmak, sorgusunu temizlemek veya kendi alan adınız altında yeniden barındırmak görüntünün bozulmasına neden olacaktır.

Widget Token Kapsamı

Widget kapsamıyla oluşturulan bir token yalnızca gömülü deneyimin gerçekten ihtiyaç duyduğu uç noktalara ulaşabilir. API'deki diğer her şey reddedilir, böylece sayfa kaynağınızdan alınan bir token hesabınıza karşı kullanılamaz.

Widget kapsamının izin verdikleri:

• Teklif formunun seçeneklerinizi gösterebilmesi için yazıcı ve malzeme yapılandırmanızı okumak.
• Bir yükleme kimliği istemek ve model dosyası yüklemek.
• Yüklediği dosyayı okumak ve silmek.
• O dosya için asenkron bir teklif başlatmak ve oluşan işi sorgulamak.
• Bir teklifi kimliğine göre okumak, küçük resmini kaydetmek ve sepete ekleme olayını göndermek.

Widget kapsamının reddettikleri:

• Webhook yönetimi; böylece çalınan bir token olay akışınızı başka bir sunucuya yönlendiremez.
• Hesap bilgileri, yükleme geçmişiniz, teklif listeleri, analitik, kullanım ve kota.
• Lisans etkinleştirme ve yukarıda listelenmeyen diğer her uç nokta.

Kaynak Bağlama

Token'ı kullanmasına izin verilen mağazaları listeleyin, örneğin https://shop.example.com. Quote3D, iframe yüklendiğinde widget'ı gömen sayfayı kontrol eder ve listede olmayan hiçbir sitede görüntülenmeyi reddeder. Boş bırakırsanız token her yerde çalışır.

Kaynak bağlamanın sayfanızdan beklediği şey

• Kontrol, tarayıcınızın widget iframe'ini yüklerken gönderdiği yönlendireni okur. Bu varsayılan davranıştır, bu yüzden normal bir sayfadan hiçbir şey gerekmez.
• Sayfanız referrer-policy: no-referrer ayarlıyorsa kaynak doğrulanamaz ve widget yüklenmeyi reddeder. Bu tür sayfalarda kaynak kısıtlaması olmayan bir token kullanın.
• Doğrudan API çağrıları ayrıca kontrol edilir: listede olmayan bir sitedeki tarayıcıdan gönderilen istek reddedilirken, Origin başlığı göndermeyen sunucudan sunucuya çağrılar etkilenmez.

Bir widget token'ının okuyamadıkları

Yapılandırma uç noktası yalnızca teklif formunun gösterdiklerini döndürür — yazıcı adları, baskı hacimleri, malzemeler, renkler ve katman limitleri. Maliyet tabanınız (kilogram başına malzeme fiyatı, makine saatlik maliyeti, destek maliyeti çarpanı, güç tüketimi) tarayıcıya asla gönderilmez; fiyatlandırma sunucuda hesaplanır.

Kapsamsız oluşturulan token'lar tam erişimi korur, dolayısıyla mevcut entegrasyonlar değişmeden çalışmaya devam eder. Bir token'ı kısıtlamaya dahil etmenin yolu ona kapsam eklemektir.