Wie kann ich ausgewählte Fahrzeuge anzeigen lassen?
Sie können den Shop und die Widgets beliebig oft auf Ihrer Website einbinden und jede Einbindung auf eine bestimmte Fahrzeugauswahl beschränken. So zeigen Sie beispielsweise auf der Startseite nur Neuwagen und auf einer eigenen Seite ausschließlich Gebrauchtwagen.
Die Auswahl steuern Sie über Filterparameter, die Sie direkt am Einbindungscode setzen — nicht im Admin-Bereich.
Zwei Wege, eine Auswahl zu zeigen
| Einbindung | Wofür geeignet |
|---|---|
| Vollständiger Shop | Eine eigene Seite mit Suche, Filtern und Fahrzeugdetailseiten — eingeschränkt auf einen Teil Ihres Bestands. Siehe Shop-Einbindung. |
| Widget | Ein kompakter Ausschnitt auf einer bestehenden Seite, z. B. ein Fahrzeug-Karussell auf der Startseite. Siehe Widget-Einbindung. |
Erzwungen oder nur vorbelegt?
Bei beiden Wegen entscheiden Sie, wie verbindlich die Auswahl ist:
| Art | Wirkung |
|---|---|
| Erzwungen | Der Filter gilt immer und lässt sich vom Besucher nicht abwählen. Passend für eine Seite, die ausschließlich Neuwagen zeigen soll. |
| Vorbelegt (initial) | Die Filtermaske startet mit Ihrer Auswahl, der Besucher kann sie aber ändern. Passend für einen bequemen Einstieg. |
Die passenden Attribute
Die Attribute unterscheiden sich je nachdem, ob Sie den Shop oder ein Widget einbinden:
| Einbindung | Attribut | Wirkung |
|---|---|---|
| Shop | data-enforced-request-params | Filter, die immer gelten. |
| Shop | data-initial-request-params | Filter, die nur vorbelegt sind. |
| Widget: Karussell | query-params | Reine Filterung — das Karussell ist nicht interaktiv. |
| Widget: Schnellsuche | initial-vehicle-request-parameters bzw. enforced-vehicle-request-parameters | Filtermaske vorbelegen bzw. fest einschränken. |
| Widget: Volltextsuche | enforced-vehicle-request-parameters | Grenzt die durchsuchten Fahrzeuge fest ein. |
Alle Attribute erwarten dieselbe Schreibweise: parameter=wert, mehrere Angaben mit & verbunden. Mehrere Werte für denselben Parameter trennen Sie mit Komma.
Beispiel: nur Neuwagen anzeigen
Im Shop-Einbindungscode:
<script
src="https://cdn.meinfahrzeugshop.com/v1/shop-hash/loader.js"
data-tenant="IHRE-MANDANTEN-UUID"
data-enforced-request-params="usedConditionTypes=NEUWAGEN"
async
></script>
In einem Fahrzeug-Karussell:
<custom-elements-wrapper
tenant-admin-id="IHRE-MANDANTEN-UUID"
widget-type="1"
query-params="usedConditionTypes=NEUWAGEN"
></custom-elements-wrapper>
Welche Parameter und Werte es gibt — Fahrzeugtyp, Hersteller, Preis, Standort und viele weitere —, steht in der technischen Referenz der Vehicle Request Parameters.
Verwenden Sie als Grundlage immer das Snippet aus Ihrem eigenen Admin-Bereich unter Integration Shop und ergänzen Sie darin nur die Filterattribute. Der Beispielcode auf dieser Seite enthält Platzhalter-Werte und darf nicht auf Live-Seiten verwendet werden.
Verwandte Themen
- Shop-Einbindung auf Ihrer Website — alle
data-Attribute des Shop-Snippets. - Widget-Einbindung auf Ihrer Website — die verfügbaren Widgets und ihre Attribute.
- Enforced Vehicle Request Parameters — die vollständige Referenz aller filterbaren Eigenschaften.