Zum Hauptinhalt springen

URL-Aufbau für die Fahrzeug-Detailseite

Eine Fahrzeug-Detailseite kann auf mehrere Arten verlinkt werden. Alle Varianten führen zur selben Seite des Fahrzeugs – Sie können also die für Ihren Anwendungsfall (Print, QR-Code, E-Mail, Anzeige …) passendste Form wählen.

Bestandteile einer URL​

  • Shop-Basis-URL: die Adresse Ihrer Website plus den Pfad, unter dem der Shop integriert ist. Dieser Pfad ist mandanten-/integrationsabhängig (z. B. /fahrzeugshop/, /gebrauchtwagen/, /autos/ …) und wird beim Setup festgelegt. Er ist immer Bestandteil der URL – die Detailseite direkt unter der Domain (https://ihrshop.de/<…>) funktioniert nicht. Beispiele:
    • https://ihrshop.de/fahrzeugshop/ (History-Mode)
    • https://ihrshop.de/fahrzeugshop/#/ (Hash-Mode)
  • Fahrzeug-Kennung – wahlweise:
    • die UUID des Fahrzeugs, z. B. a1b2c3d4-e5f6-7890-abcd-ef1234567890, oder
    • die interne Fahrzeugnummer (Bestands-/Inventarnummer), z. B. 12345 oder AB-2022-007.
  • Optional ein frei wählbares Segment vor der Kennung (z. B. ein „sprechender" Name fürs SEO oder den Druck).

Mögliche URL-Formen​

In den Beispielen steht <basis> für die Shop-Basis-URL inklusive Integrationspfad, also z. B. https://ihrshop.de/fahrzeugshop/.

1. Nur Kennung​

<basis><Kennung>
  • mit UUID: https://ihrshop.de/fahrzeugshop/a1b2c3d4-e5f6-7890-abcd-ef1234567890
  • mit interner Nummer: https://ihrshop.de/fahrzeugshop/12345

2. Freies Segment + Kennung​

<basis><beliebiger-text>/<Kennung>

Beispiel: https://ihrshop.de/fahrzeugshop/vw-golf-2022/12345

Das Segment vor der Kennung ist frei wählbar (Marke, Modell, Kampagnenname o. Ä.) und wird vom Shop ignoriert – die Kennung entscheidet, welches Fahrzeug geöffnet wird.

Wichtig​

  • Der Integrationspfad (z. B. /fahrzeugshop/) muss in jeder URL enthalten sein. Wie er genau heißt, hängt von Ihrer Integration ab.
  • Es darf entweder die UUID oder die interne Fahrzeugnummer verwendet werden – beides führt zur selben Detailseite. Die UUID wird am UUID-Format erkannt; alles andere wird als interne Nummer behandelt und intern aufgelöst.
  • Wird die interne Nummer nicht gefunden, leitet der Shop auf die Startseite um – Schreibweise (inkl. Groß-/Kleinschreibung) bitte exakt so übernehmen, wie im Händler-System hinterlegt.
  • Im Hash-Mode muss /#/ direkt nach dem Integrationspfad stehen, also z. B. https://ihrshop.de/fahrzeugshop/#/12345 oder https://ihrshop.de/fahrzeugshop/#/<text>/<UUID>. Im History-Mode entfällt das #.

Damit lassen sich z. B. Print-Anzeigen, QR-Codes oder E-Mail-Links mit kurzen, sprechenden URLs erzeugen – am bequemsten mit der internen Fahrzeugnummer.