Alle Plattformen / Anleitung
3D-Modell und AR in Magento und Adobe Commerce
Mit Page Builder fügen Sie ein Element „HTML Code“ in die Produktbeschreibung ein. Ohne Page Builder fügen Sie den Code im HTML-Editor der Beschreibung ein.
- Plugin / App
- Nicht nötig
- Wo der Code hinkommt
- Content → Page Builder → „HTML Code“
- AR auf dem Handy
- Ja, Android und iPhone
Variante 1: Page Builder (Magento 2.4)
Der Standardweg in Magento 2.4.3+ und Adobe Commerce.
Schritt 1
Code aus 3DView kopieren
Öffnen Sie in Ihrem Konto „Meine Modelle“ und klicken Sie beim Modell auf „Code für die Website“: Der Code wird sofort kopiert. Die Tabs „Shopify“, „WooCommerce“ und „Jede Website“ zeigen nur, wo Sie ihn einfügen; der Code ist derselbe.
Code aus 3DView kopieren Schritt 2
Produkt öffnen
Catalog → Products → Edit beim Produkt.
Produkt öffnen Schritt 3
Page Builder öffnen
Öffnen Sie den Bereich Content und klicken Sie auf „Edit with Page Builder“.
Schritt 4
Element HTML Code hineinziehen
Ziehen Sie im linken Bereich unter Elements „HTML Code“ in die Beschreibung. Klicken Sie auf das Zahnrad des Elements, fügen Sie den Code ein und klicken Sie auf Save.
Element HTML Code hineinziehen Schritt 5
Produkt speichern
Schließen Sie Page Builder, klicken Sie auf Save und prüfen Sie das Produkt im Shop.
Variante 2: Ohne Page Builder (WYSIWYG-Editor)
Wenn Page Builder deaktiviert ist oder Sie eine ältere Version haben.
Schritt 1
Code aus 3DView kopieren
Öffnen Sie in Ihrem Konto „Meine Modelle“ und klicken Sie beim Modell auf „Code für die Website“: Der Code wird sofort kopiert. Die Tabs „Shopify“, „WooCommerce“ und „Jede Website“ zeigen nur, wo Sie ihn einfügen; der Code ist derselbe.
Code aus 3DView kopieren Schritt 2
Auf HTML umschalten
Klicken Sie im Bereich Content bei Description auf „Show / Hide Editor“, um den HTML-Code zu sehen.
Auf HTML umschalten Schritt 3
Code einfügen und speichern
Fügen Sie den Code ein und klicken Sie auf Save.
Code einfügen und speichern
Der Code, den Sie einfügen
So sieht der aus 3DView kopierte Code aus (bei Ihnen steht die ID des Modells statt MODEL_ID). Die Höhe (height:480px) können Sie ändern; den Rest lassen Sie unverändert. Hängen Sie ?controls=0 an die ID an, um die Bedienleiste unter dem Modell auszublenden.
<iframe src="https://www.3dview.ai/embed/MODEL_ID" title="Sofa Oslo" loading="lazy" allow="xr-spatial-tracking; fullscreen; accelerometer; gyroscope" allowfullscreen style="width:100%;height:480px;border:0;border-radius:12px"></iframe>
So prüfen Sie, ob es funktioniert
- Am Computer: Das Modell lädt, lässt sich mit der Maus drehen, und die Schaltfläche „Auf dem Handy ansehen“ zeigt einen QR-Code für AR.
- Auf Android (Chrome): Tippen Sie auf die AR-Schaltfläche in der Ecke des Modells. Der AR-Viewer von Google öffnet sich und Sie stellen das Produkt in Originalgröße in den Raum. Das Handy muss ARCore unterstützen.
- Auf iPhone/iPad (Safari): Tippen Sie auf die AR-Schaltfläche. AR Quick Look öffnet sich, ganz ohne App.
- Testen Sie in Safari oder Chrome, nicht im internen Browser von Facebook/Instagram: Dort startet AR nicht.
- Leeren Sie nach dem Speichern den Cache: System → Cache Management → Flush Magento Cache (falls Sie die Änderung nicht sehen).
Häufige Probleme und Lösungen
Die Browser-Konsole zeigt einen Content-Security-Policy-Fehler
Ihr Shop nutzt CSP im restriktiven Modus. Ihr Entwickler fügt https://www.3dview.ai zu frame-src hinzu (in der csp_whitelist.xml des Themes oder eines Moduls).
Das Modell erscheint bei allen Produkten
Sie haben es in die Seitenvorlage gesetzt, nicht in die Produktbeschreibung. Setzen Sie das Element HTML Code bei jedem Produkt in Content.
Der Code verschwindet oder wird nach dem Speichern zu Text
Der Editor hat ihn bereinigt: Fügen Sie den Code im HTML- bzw. Quellcode-Modus ein, nicht im visuellen Modus (die Schritte oben zeigen die genaue Schaltfläche). Verschwindet er trotzdem, erlaubt die Plattform keine iframes: Nutzen Sie Link und QR-Code aus „Teilen / QR“.
Das Modell ist zu klein oder wird abgeschnitten
Erhöhen Sie die Höhe im Code: aus height:480px wird zum Beispiel height:600px. Die Breite (100%) passt sich automatisch an die Spalte an. Auf dem Handy reichen meist 400–500px.
Die AR-Schaltfläche erscheint nicht oder startet nicht auf dem iPhone
AR auf dem iPhone braucht Safari (oder Chrome unter iOS) und ein iPhone/iPad mit iOS 12 oder neuer. 3DView erstellt die iPhone-Variante (USDZ) automatisch. Öffnen Sie den Link des Modells direkt (Schaltfläche „In AR ansehen“ im Konto): Funktioniert es dort, blockiert Ihre Plattform AR in eingebetteten Frames; setzen Sie unter das Modell einen Link „In AR ansehen“ zu diesem Link.
Der Browser meldet „unsichere Inhalte“ oder das Modell lädt nicht
Ändern Sie die Adresse im Code nicht auf http://. Auf einer https-Seite blockieren Browser http-Frames (gemischte Inhalte). Lassen Sie die Adresse genau so: https://www.3dview.ai/embed/…
Auf dem Modell erscheint das 3DView-Logo
Sie entfernen es pro Modell im Konto: „Logo entfernen“, eine einmalige Zahlung in Credits. Der Code bleibt derselbe.
Wird die Seite langsamer?
Nein: Der Code hat loading="lazy", das Modell lädt also erst, wenn es auf dem Bildschirm erscheint. Das Hosting ist inklusive, ohne Abo.
Vereinfachte Illustrationen, keine Screenshots; die Menüs können in Ihrer Version etwas anders aussehen.
Häufige Fragen
Brauche ich eine Magento-Erweiterung?
Nein. Das Element HTML Code im Page Builder ist enthalten.
Funktioniert es mit Magento Open Source?
Ja. Page Builder ist seit 2.4.3 enthalten; davor nutzen Sie die Variante mit dem WYSIWYG-Editor.
Sie haben noch kein 3D-Modell?
Scannen Sie das Produkt mit dem Handy oder starten Sie mit einem Foto. Sie erhalten den Code für die Website, den Link mit QR-Code und AR inklusive.
Erstes Modell erstellen