Dieses Widget ist derzeit ausschließlich für die Einbindung bei Auto-Motor-Sport gebaut. Eine allgemeine Variante ist noch in Entwicklung.
Dieses Widget ermöglicht es die besten Angebote (Preis aufsteigend) für eine bestimmte Series ID, eventuell mit Fuel Type oder sowie weiteren Parametern, als eine Top Liste auszugeben.
Hinweis: Aktuell ist hier die Staging API angebunden, weshalb die Suchergebnisse nicht mehr aktuell sein können und nicht mit der normalen Suche übereinstimmen.
Demo des Widgets
Hinweise zum Widget. Es wird nativ als JS Widget eingebunden. Damit wird die Farbe der Links und Schriftart von der Seite geerbt wo es eingebunden ist. Bzw. ist die Farbe und Schriftart von AMS ebenfalls im Widget hinterlegt, wenn es als iFrame geladen wird und die Vererbung nicht ordentlich funktioniert. Das Widget
Das Widget wird mit folgendem Code eingebunden:
Mit diesem Widget sind wir auf eine Identifikation mit Klassennamen gewechselt. Die Klasse mvd_offers_by_filter_widget kann auf einer Seite mehrmals verwendet werden, um mehrere Listen bei Bedarf auszugeben.
<div class="mvd_offers_by_filter_widget" data-offer-type="vehicle-leasing-offers" data-offer-count="4" data-make-id="" data-series-id="11519" data-fuel-type="" data-vehicle-type="" data-vehicle-condition="new" data-customer-groups="privat" data-partner-id="5" data-search-url="https://widgets-doc.mivodo.com/demo-such-widget-staging-api/"></div>
<script src="https://widgets.mivodo.com/widgets/ams-offers-by-filter/widget.js"></script>Dabei wird das Widget in alle Divs mit der class mvd_offers_by_filter_widget gesetzt. Wenn dieses div nicht vorhanden ist, wird das Widget nicht ausgegeben. Außerdem müssen bestimmte unten genannte Data Attribute vorhanden sein.
Widget Daten
Damit das Widget ordnungsgemäß funktioniert müssen bestimmte Data Attributes am div des Platzierung „div“ angehängt werden. Wir haben uns hier bewusst entschieden zukünftig die Widget Daten immer, soweit möglich, lieber in die Data Attributes zuschreiben. Das ermöglicht dann auch mehr Flexibilität wenn man das gleiche Widget eventuell mehrmals auf einer Seite platzieren will.
Wenn es nicht vorhanden ist, kann das Widget nicht gerendert werden. Damit das Widget etwas zurückgeben kann, muss zumindest die data-series-id, data-offer-type oder der data-search-url definiert werden. Folgende Data Attributes gibt es:
- series-id: Die ID einer Serie wie zB für Cupra Born
- make-id: Alternativ zu Series ID kann auch nur eine Marke übergeben werden (Beispiel Top BYD Leasing Angebote)
- offer-type: Es kann nur innerhalb eines Offer Types verglichen werden: vehicle-leasing-offers, vehicle-subscription-offers, vehicle-buy-offers
- partner_id ist die Partner ID die euch zugewiesen wird. Aktuell könnt ihr 5 verwenden.
- search-url: Die Url des Such Widgets für den Link
- customer-groups: privat oder gewerbe – beeinflusst das anzeigte günstigste Angebot und die Parameter die in die suche übergeben werden. Wenn nicht angegeben default privat!
Optional:
- fuel-type: Kraftstoffart mit den 5 Kraftstoffarten von AMS eingrenzen
- offer-count: Default ist 3 -> es können hier bis zu 20 Angebote ausgegeben werden
- vehicle-type: Eingrenzung mit dem Vehicle Type vom AMS
Folgende Logiken werden berücksichtigt:
- Wenn ein Parameter wie Make ID, Series ID, Fuel Type oder Vehicle Type nicht in unserer DB gematched sind werden keine Angebote ausgegeben. Es müssen alle Parameter gefunden werden. Hier gibt es keine Fallback Logik. Wenn es keine Angebote für das Fahrzeug gibt, wird ebenfalls nichts ausgegeben auch wenn gematched wurde.
- Es wird bei default immer nach Privat gesucht
Nach Absprache mit Florian:
D.h. es gibt in der Ausgabe nur noch folgende Kraftstoffarten:
- Benzin
- Diesel
- Hybrid
- Elektro
- Wasserstoff