Überblick
Die App DecorViz: Furniture Visualizer fügt deinen Shopify-Produktseiten einen "In deinem Zimmer ansehen"-Button hinzu. Kunden wählen ihn aus, laden ein Foto ihres eigenen Zimmers hoch und erhalten eine realistische Vorschau des Produkts in ihrem Raum, bevor sie sich entscheiden.
Sie arbeitet mit dem Produktfoto, das bereits auf der Seite veröffentlicht ist. Es gibt keine 3D-Modelle zu beauftragen, keinen Produktfeed zuzuordnen und kein Setup pro Produkt: Sobald das App-Embed aktiv ist, ist jede geeignete Produktseite abgedeckt, auch später hinzugefügte Produkte.
Die gesamte Einrichtung findet in deinem Shopify-Adminbereich statt. Du öffnest nie eine Theme-Datei.
WooCommerce, Wix, Squarespace und individuell programmierte Shops installieren Storefront stattdessen mit einem Script aus dem DecorViz-Web-Dashboard. Das ist in der Storefront-Einrichtungsanleitung beschrieben.
Das App-Embed wird im Theme-Editor aktiviert und lässt sich dort genauso wieder deaktivieren.
DecorViz erkennt geeignete Produkte selbst. Die Produktseite brauchst du nur, um den Button bei einzelnen Artikeln auszublenden.
Zimmerfotos werden nur zur Erzeugung der Vorschau verwendet und sind für dich weder in der App noch in Analysen einsehbar.
Bevor du startest
Es gibt nur sehr wenig vorzubereiten:
- Ein Shopify-Shop, den du verwalten kannst. Du brauchst die Berechtigung, Apps zu installieren und das Theme zu bearbeiten.
- Ein Shopify-Theme, das du anpassen kannst. App-Embeds funktionieren sowohl mit Vintage- als auch mit Online Store 2.0-Themes, ein Theme-Upgrade ist also nicht nötig.
- Produktseiten mit einem klaren Produktfoto. Storefront liest das Bild direkt von der Seite, ein sauberes, gut beleuchtetes Produktfoto ist also die einzige nötige Vorlage.
Die App nutzt die E-Mail-Adresse deines Shopify-Shop-Inhabers, um nach der Installation ein DecorViz-Konto für dich anzulegen oder zu verknüpfen. Wenn du den Storefront-Plan bereits auf decorviz.ai abonniert hast, installiere mit derselben E-Mail-Adresse, und die App läuft über den Plan, für den du schon zahlst.
Installation
Vier Schritte von Anfang bis Ende. Zwei davon sind Pflicht, und die App zeigt dir an, wann dein Schlüssel bereit ist.
Schritt 1: App installieren
Aus dem Shopify App Store installieren
Öffne den Eintrag für DecorViz: Furniture Visualizer und installiere die App in deinem Shop. Sie fordert ausschliesslich Lesezugriff auf Produkte an, um daraus die Kategorieliste zu erstellen und dir das Ausschliessen einzelner Artikel zu ermöglichen. Sie schreibt nie in deinen Katalog und greift nie auf Bestellungen oder Kunden zu.
Neue Installationen starten mit 5 Testvorschauen und ohne Shopify-Abrechnung. Das reicht, um den Button live zu schalten und ihn an deinen eigenen Produkten zu testen, bevor du einen Plan wählst.
Schritt 2: Installationsschlüssel kopieren
Installation in der App öffnen
Öffne DecorViz unter Apps in deinem Shopify-Adminbereich und gehe dann zu Installation. Dort ist dein Installationsschlüssel aufgeführt, mit dem Hinweis Key ready, sobald der Shop verbunden ist. Kopiere ihn.
Turn on the embed, then check a product page.
Open your theme editor, go to App embeds, switch on DecorViz Storefront, and paste your install key into it.
Copy this into DecorViz Storefront in your theme editor.
Open theme editor → Button settings →Es bedeutet, dass dein Shop verbunden und der Schlüssel aktiv ist. DecorViz prüft derzeit nicht, ob das Embed selbst aktiviert und gespeichert wurde, deshalb kann die App diesen Teil nicht für dich bestätigen. Dafür ist Schritt 4 da.
Schritt 3: App-Embed aktivieren
DecorViz Storefront im Theme-Editor aktivieren
Wähle in der App Open theme editor oder gehe zu Online Store → Themes und klicke bei deinem Live-Theme auf Customize. Öffne in der Seitenleiste App embeds, aktiviere DecorViz Storefront, füge deinen Installationsschlüssel in das Feld Install key ein und klicke auf Save.
Shows a Preview button on suitable product pages. Shoppers upload a photo of their space and see your furniture there.
Die Einstellung gehört zu dem Theme, in dem du sie aktiviert hast. Wenn du später ein anderes Theme veröffentlichst, öffne dessen Theme-Editor, aktiviere DecorViz Storefront dort und füge denselben Installationsschlüssel ein. Deine Button-Einstellungen und Produktausschlüsse bleiben unverändert.
Schritt 4: Produktseite testen
Erste Vorschau erzeugen
Öffne eine Produktseite unter deiner Live-Shop-URL, nicht im Theme-Editor und nicht in einer Entwurfsvorschau. Prüfe, ob der Preview-Button an der erwarteten Stelle erscheint, lade dann ein Zimmerfoto hoch und erzeuge eine vollständige Vorschau.
Danach suchst du. Der Preview-Button sitzt in der Button-Reihe deines eigenen Themes, neben "In den Warenkorb":
Premium velvet upholstery with solid wood frame. Available in 4 colors. Free delivery.
Eine Demo der Kundenansicht. Buttontext, Farbe und Position kommen aus der Settings-Seite der App.
Prüfe dabei am besten mehrere Vorlagen: einen einfachen Artikel, einen mit vielen Varianten, alles individuell Gebaute und mindestens eine Seite auf dem Smartphone. Öffne danach eine Nicht-Produktseite wie deine Startseite und prüfe, dass der Button dort nicht erscheint.
Alles Weitere ist optionale Feinabstimmung. Der Button ist auf deinen Produktseiten bereits aktiv.
Auswählen, welche Produkte ihn zeigen
Du schaltest Produkte nicht einzeln frei. DecorViz erkennt geeignete Artikel und zeigt den Preview-Button automatisch. Es gibt zwei Wege, das einzugrenzen:
- Kategorien. Wähle in den Settings, in welchen Kategorien der Preview-Button erscheint. Das ist die grobe Steuerung und die, die die meisten Shops nutzen.
- Einzelne Produkte. Öffne Products in der App und blende den Button bei bestimmten Artikeln aus, die du nicht einbeziehen willst.
Beide greifen in dieser Reihenfolge ineinander: Kategorien bestimmen, welche Produkttypen überhaupt infrage kommen, und die Checkbox pro Produkt schliesst einzelne Artikel aus dem Rest aus.
Kategorien
Klappe in den Settings Show the Preview button on these categories auf. Anfangs ist alles angehakt. Entferne den Haken bei einer Kategorie, um den Button für diesen gesamten Produkttyp auszublenden.
The Preview button only appears on products DecorViz recognises. Untick a category to hide it there.
Einzelne Produkte
Öffne Products in der App für die Liste pro Artikel. Jedes infrage kommende Produkt ist zunächst angehakt; entferne den Haken in der Spalte Preview button bei allem, was aussen vor bleiben soll. Änderungen greifen beim nächsten Seitenaufruf durch Kunden.
DecorViz detects suitable products and shows the Preview button automatically. Uncheck Preview button only for items you want to exclude. Categories in Settings still decide which product types are eligible.
"Published" is the product's Shopify status, not DecorViz. Use the checkbox to include or exclude the Preview button.
Die Erkennung laufen zu lassen und die wenigen unpassenden Artikel auszublenden ist meist schneller, als die Liste vorab bestimmen zu wollen. Neue Produkte sind in beiden Fällen automatisch abgedeckt.
Abrechnung & Vorschauen
Eine Vorschau wird gezählt, wenn ein Kunde sie erzeugt. Das Ansehen der Produktseite und das Öffnen des Widgets kosten nichts.
- Free: 5 Testvorschauen, keine Shopify-Abrechnung und keine Karte.
- Storefront 250: 119 USD pro Monat für 250 Vorschauen. Erster Monat 101,15 USD, 15 % Rabatt.
- Storefront 500: 199 USD pro Monat für 500 Vorschauen. Erster Monat 169,15 USD, 15 % Rabatt.
Bezahlte Pläne verlängern sich monatlich über Shopify und lassen sich in deinem Shopify-Adminbereich kündigen. Upgrades starten sofort und legen ein volles neues Kontingent auf dein Restguthaben obendrauf; Downgrades greifen zum Ende der laufenden Abrechnungsperiode. Der Einführungsrabatt von 15 % gilt nur beim ersten Abschluss, nicht bei späteren Planwechseln.
Wenn das Monatskontingent aufgebraucht ist, bleibt der Preview-Button sichtbar, aber Kunden, die eine Vorschau erzeugen wollen, sehen statt eines Ergebnisses einen Hinweis, dass die Funktion vorübergehend nicht verfügbar ist. Ihnen wird nie mitgeteilt, dass der Shop kein Kontingent mehr hat. Die App warnt dich bei drei verbleibenden Vorschauen und erneut bei null, achte also auf diese Hinweise.
Installiere die App mit derselben E-Mail-Adresse, mit der du dich registriert hast, und sie läuft über deinen bestehenden Storefront-Plan. Die App zeigt dann den Hinweis "Billed on decorviz.ai" statt einer Aufforderung, über Shopify zu abonnieren, und die Vorschauen werden von dem Kontingent abgezogen, für das du bereits zahlst. Diesen Plan verwaltest du mit deiner Anmeldung auf decorviz.ai.
Fehlerbehebung
Button erscheint nirgends
- Prüfe, ob das App-Embed DecorViz Storefront im Theme-Editor für dein veröffentlichtes Theme aktiviert ist, nicht für einen Entwurf oder ein Theme, das du nur ausprobiert hast
- Prüfe, ob dein Installationsschlüssel im Feld Install key des Embeds eingefügt und das Theme gespeichert wurde
- Stelle sicher, dass du deine Live-Shop-URL ansiehst und nicht den Theme-Editor oder eine Entwurfsvorschau
- Prüfe, ob "Show the Preview button on my store" in den Settings der App aktiviert ist
- Leere deinen Browser-Cache und lade die Seite neu
Button erscheint bei einem bestimmten Produkt nicht
- Prüfe, ob das Produkt nicht in einer Kategorie liegt, die du in den Settings ausgeschlossen hast
- Prüfe, ob es nicht einzeln auf der Seite Products der App ausgeblendet wurde
- Wenn das Theme stark angepasst ist, setze in den Settings einen CSS selector auf das genaue Element
Button erscheint doppelt
- Das bedeutet, dass die Runtime zweimal geladen wird. Wenn du das DecorViz-Script früher von Hand in dein Theme eingefügt hast, bevor du die App installiert hast, entferne dieses Snippet aus dem Theme und behalte nur das App-Embed
Button erscheint, aber die Erzeugung funktioniert nicht
- Prüfe deine verbleibenden Vorschauen auf der Seite Billing der App. Sobald das Kontingent aufgebraucht ist, wird der Button weiterhin angezeigt, Kunden erhalten aber statt einer Vorschau einen Hinweis auf vorübergehende Nichtverfügbarkeit
- Prüfe, ob dein Abo aktiv ist. Ein gekündigter oder abgelaufener Plan schaltet die Erzeugung ab, deine Einstellungen bleiben erhalten
Hinweis "Registered domain does not match"
- DecorViz ist für eine andere Domain registriert als die, über die dein Shop jetzt ausgeliefert wird, meist nach dem Wechsel auf eine eigene Domain. Der Button erscheint erst wieder, wenn das korrigiert ist. Schreibe an [email protected] mit deiner Shop-Domain, und wir stellen es um
Hinweis "Shop owner email is missing"
- Shopify hat keine Inhaber-E-Mail für den Shop übermittelt, die DecorViz zum Anlegen oder Verknüpfen deines Kontos benötigt. Trage eine im Shopify-Adminbereich nach und öffne die App erneut, oder schreibe an [email protected] mit deiner Shop-Domain
Falsches oder fehlendes Produktbild in der Vorschau
- Die Runtime holt das Hauptproduktbild direkt von der Seite. Prüfe, ob dieses Bild für Kunden normal lädt und nicht hinter einem Klick oder einer lazy-loading-Galerie versteckt ist
- Wenn dein Theme eine ungewöhnliche Galeriestruktur nutzt, wende dich an den Support, damit wir das Markup prüfen können
Wende dich an unser Support-Team unter [email protected] oder nutze die Seite Support in der App.
Häufig gestellte Fragen
Muss ich jedes Produkt einzeln einrichten?
Nein. Die App erkennt geeignete Produkte und zeigt den Preview-Button automatisch, auch bei Produkten, die du nach der Installation hinzufügst. Die Products-Seite öffnest du nur, um den Button bei bestimmten Artikeln auszublenden.
Brauchen meine Kunden ein DecorViz-Konto?
Nein. Kunden nutzen den Preview-Button direkt von deiner Produktseite aus. Es gibt keine Registrierung, keinen Download und keine Zahlung an DecorViz.
Kann ich die Zimmerfotos sehen, die Kunden hochladen?
Nein. Zimmerfotos werden ausschliesslich zur Erzeugung der Vorschau verwendet. Sie sind für dich weder über die App noch über Produktanalysen einsehbar.
Was passiert, wenn ich das Theme wechsle?
App-Embeds werden pro Theme gespeichert, ein neu veröffentlichtes Theme startet also mit deaktiviertem DecorViz Storefront. Öffne den Editor des neuen Themes, aktiviere es und füge denselben Installationsschlüssel ein. Deine Button-Einstellungen und Produktausschlüsse werden unverändert übernommen.
Verlangsamt es meine Produktseiten?
Die Runtime lädt asynchron und blockiert daher das Rendern deiner Produktseite nicht.
Welche Daten liest die App aus meinem Shop?
Ausschliesslich Produktdaten, und nur lesend. Daraus entstehen die Kategorieliste und die Ausschlussliste. Die App schreibt nicht in deine Produkte und fordert keinen Zugriff auf Bestellungen oder Kunden an.
Ich zahle bereits für Storefront auf decorviz.ai. Zahle ich erneut?
Nein. Installiere mit derselben E-Mail-Adresse, mit der du dich bei DecorViz registriert hast, und die App läuft über deinen bestehenden Plan und zeigt den Hinweis "Billed on decorviz.ai" statt einer Shopify-Abo-Aufforderung.
Was passiert, wenn ich deinstalliere?
Der Preview-Button erscheint nicht mehr und ein etwaiges Shopify-Abo endet mit der Deinstallation. Shopify sendet uns anschliessend eine Löschanfrage für den Shop, und wir entfernen die Daten des Shops innerhalb der von Shopify gesetzten Fristen. Details stehen in der Datenschutzerklärung.
Bereit loszulegen?
Installiere die App, aktiviere das Embed und lass DecorViz deine Produktseiten abdecken.