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 das jeweils beste Angebot für mehrere SeriesIds einer bestimmten Finanzierungsform 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.
Hinweis: Wir haben hier ebenfalls auf eine Identifikation via class gewechselt, um den Weg frei zu machen für mehrere Widgets auf einer Seite.
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. Das Widget
Das Widget wird mit folgendem Code eingebunden:
<div class="mvd_offer_by_series_widget" data-series-ids="11274,11481,11519,11352" data-offer-type="vehicle-leasing-offers" data-fuel-types="Elektro,Benzin" data-vehicle-condition="new" data-partner-id="5" data-customer-groups="privat" data-search-url="https://widgets-doc.mivodo.com/such-widget/"></div>
<script src="https://widgets.mivodo.com/widgets/ams-offer-by-series/widget.js"></script>Dabei wird das Widget in ein Div mit der Klasse mvd_offer_by_series_widget gesetzt. Wenn dieses div nicht vorhanden ist, wird das Widget nicht ausgegeben. Wenn mehrere vorhanden sind, wird das Widget auch mehrfach gerendert.
Das Widget passt sich an das HTML der aktuellen Seite an, womit es Schriftart, Farben usw. übernimmt. Sollte es hier zu Problemen führen, können wir weitere Styles zum überschreiben des Aussehens definieren. Es beinhaltet aber auch die Font und Farben von AMS, wenn es via iFrame eingebunden wird.
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-ids, data-offer-type oder der data-search-url definiert werden. Folgende Data Attributes gibt es:
- series-ids: Komma separierte Liste von euren Serien IDs
- offer-type: Es kann nur innerhalb eines Offer Types verglichen werden: vehicle-leasing-offers, vehicle-subscription-offers, vehicle-buy-offers
- fuel-type: optional kann eine Kraftstoffart (von euren) hinzugefügt werden, um bei Modellen mit mehreren Kraftstoffvarianten sicher die richtige zu erhalten zB Volvo XC40 als Elektro
- 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.
Folgende Logiken werden berücksichtigt:
- Von den definierten series-ids werden nur Angebote für solche zurückgegeben, wenn welche vorhanden sind und die ID in unserer DB schon zugeordnet wurde. Es kann also sein, dass weniger Angebote angezeigt werden als man ids eingegeben hat.
- 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