Manuelle Code-Integrierung

Das Widget King-Avis anzeigen

Um das Widget auf Ihrer Seite anzuzeigen, müssen Sie lediglich den Javascript-Code direkt vor der Schließung des Tags </head> im Code Ihres Shops integrieren und die Parameter angeben, die mit Ihrem Konto verbunden sind. Schauen Sie sich das Beispiel unten an:

<script type="text/javascript" src="https://king-avis.com/widgets/31-991bf70b65ba2b823dd8b50fd3621a2b8933b47d5.js"></script>

31 = Händler ID
991bf70b65ba2b823dd8b50fd3621a2b8933b47d5 = Händler Token
Diese beiden Werte werden mit einem Bindestrich verbunden. Sie finden diese beiden Informationen direkt in Ihrem Kundenkonto.

Eine Meinungsanfrage hinzufügen.

Damit der Prozess automatisch funktioniert, muss Ihre Plattform in der Lage sein, jede Bestellung, die in Ihrem Online-Shop getätigt wurde, auf die Seite King-Avis weiterzuleiten. Dafür empfehlen wir die Integration mit PHP (mit file_get_contents oder CURL) durch Ausführen einer URL zu unserer API. Sie müssen das folgende Integrationsbeispiel beachten, indem Sie jedem Parameter automatisch die richtigen Werte zuweisen. Wenn Sie diesen Code ausführen, sendet er automatisch Bestellinformationen an die King-Avis-Plattform.

<?php
file_get_contents('https://king-avis.com/de/merchantorder/add?id_merchant=31&token=991bf70b65ba2b823dd8b50fd3621a2b8933b47d5&private_key=62af78aebuiod02e4e773b21e9bd4a7c54a2ab68&ref_order=17&email[email protected]&amount=57.230000&iso_currency=CHF&firstname=Germain&lastname=Tenthorey&iso_lang=de');
?>


Eine alternative Vorgehensweise ist die Verwendung der Pixel-Methode in HTML mit einer eingebetteten URL auf einem IMG-Tag:

<img src="https://king-avis.com/de/merchantorder/add?id_merchant=31&token=991bf70b65ba2b823dd8b50fd3621a2b8933b47d5&private_key=62af78aebuiod02e4e773b21e9bd4a7c54a2ab68&ref_order=17&email[email protected]&amount=57.230000&iso_currency=CHF&company=Webbax&firstname=Germain&lastname=Tenthorey&address=CP%20157&postcode=1926&city=Fully&iso_country=CH&phone=0277461981&date_order=2021-01-01%2010:01:32&iso_lang=de" height="0" width="0">


Die URL besteht aus den folgenden Elementen:

https://king-avis.com/de/merchantorder/add? : Der Basislink muss so aussehen wie im Bespiel. Der Wert "/de/" kann durch diese Werte ersetzt werden: "/fr/", "/en/", "/it/".
id_merchant Händler ID, die in Ihrem Back-Office von King-Avis angegeben ist.
Type : int
Feld : obligatorisch
token Händler Token, das in Ihrem Back-Office von King-Avis angegeben ist.
Type : string
Feld : obligatorisch
private_key Händler Private Key, das in Ihrem Back-Office von King-Avis angegeben ist.
Type : string
Feld : obligatorisch
ref_order Nummer / Referenz der Bestellung
Type : string
Feld : obligatorisch
email E-Mail-Adresse des Käufers
Type : email
Feld : obligatorisch
amount Gesamtbetrag der Bestellung
Type : float
Feld : obligatorisch
iso_currency ISO-Code der Währung (CHF, EUR, USD...)
Type : string(3)
Feld : obligatorisch
company Name der Firma
Type : string
Champ : fakultativ
firstname Vorname des Käufers
Type : string
Feld : obligatorisch
lastname Name des Käufers
Type : string
Feld : obligatorisch
address Adresse des Käufers
Type : string
Feld : fakultativ
postcode Postleitzahl des Käufers
Type : string
Feld : fakultativ
city Stadt des Käufers
Type : string
Feld : fakultativ
iso_country ISO-Code des Käuferlandes (FR, CH, DE, IT...)
Type : string(2)
Feld : fakultativ
phone Telefonnummer des Käufers
Type : string
Feld : fakultativ
iso_lang ISO-Code der Sprache des Käufers (ex. fr, de, en, it...)
Type : string(2)
Feld : obligatorisch
date_order Datum der Bestellung
Type : DateTime (Y-m-d H:i:s)
Feld : fakultativ