Installations- und Integrationshandbuch
Befolgen Sie unsere Schritt-für-Schritt-Anleitung, um AutoChat nahtlos auf Ihrer Händler-Website zu installieren und zu integrieren. Stellen Sie sicher, dass alles richtig eingerichtet und konfiguriert ist, um AutoChat optimal zu nutzen.
Bevor Sie beginnen:
Bevor Sie mit der Implementierung von AutoChat auf Ihrer Website beginnen, stellen Sie sicher, dass Sie mindestens eine AssistantId und ein AccessToken erhalten haben. Jeder Assistent benötigt eine Kombination aus einer AssistantId und einem AccessToken. Wenn Sie diese Informationen nicht haben, wenden Sie sich bitte an unser Supportteam unter support@autochat.ai.
Bitte beachten Sie auch, dass wir die neuesten beiden Versionen von Chrome und Safari unterstützen. Andere oder ältere Versionen anderer Browser funktionieren möglicherweise, werden jedoch nicht aktiv unterstützt.
Eine typische Installation des Skripts sieht folgendermaßen aus:
<script>
(function(){
var autochatConfig = {
assistantId: "INSERT ASSISTANTID",
accessToken: "INSERT ACCESSTOKEN",
locale: "NL", // or EN/FR
// To set up a link between the website and the car a consumer is looking at use one of these identification methods:
currentCarVin: "PLACE CAR VIN NUMBER HERE",
// - OR -
licensePlate: "PLACE CAR LICENSE PLATE NUMBER HERE",
// - OR -
stockNumber: "PLACE CAR STOCK NUMBER HERE"
};
var s=document.createElement("script");s.src="https://static.chatclient.autochat.ai/release/autochat.js?ver=1",s.async=!0,s.defer=!0,s.addEventListener("load",function(){autochat.init(autochatConfig)}),document.body.appendChild(s);
})()
</script>
Verwenden Sie nicht mehr als eine Methode zur Fahrzeugidentifizierung.
Sie können AutoChat auf zwei Arten installieren:
-
Indem Sie den Code direkt in Ihre Website installieren.
-
Indem Sie unseren Code über den Google Tag Manager hinzufügen.
Installation durch Hinzufügen von Code zum Quellcode der Website
Um AutoChat in seiner grundlegendsten Form zu installieren, d. h. nur die Chat-Blase, keine CTA-Schaltflächen und keine Fahrzeugidentifikation, müssen Sie zwei Dinge hinzufügen:
Platzieren Sie dieses HTML unter der Öffnung< Körper> Etikett:
und platzieren Sie dieses Javascript über dem schließenden< /Körper> Etikett.
Vergessen Sie nicht, die AssistantId und den AccessToken einzugeben.
Installation über Google Tag Manager
Wenn Sie GTM auf Ihrer Website verwenden, können Sie AutoChat auch auf diese Weise installieren.
Schritt 1: Logge dich in den Tag Manager ein und öffne die Tags
Schritt 2: Klicken Sie auf Neu
Schritt 3: Klicken Sie auf Tag-Konfiguration
Schritt 4: Wählen Sie benutzerdefiniertes HTML
Schritt 5: Geben Sie diesen Code ein
<div id="autochat-root"></div>
<div id="autochat-chat-overlay"></div>
<script>
(function(){
var autochatConfig = {
assistantId: "INSERT ASSISTANTID",
accessToken: "INSERT ACCESSTOKEN",
locale: "NL", // or EN/FR
};
var s=document.createElement("script");s.src="https://static.chatclient.autochat.ai/release/autochat.js?ver=1",s.async=!0,s.defer=!0,s.addEventListener("load",function(){autochat.init(autochatConfig)}),document.body.appendChild(s);
})()
</script>
Vergessen Sie nicht, die AssistantId und den AccessToken einzugeben.
Das Ergebnis sollte ungefähr so aussehen:
Schritt 6: Triggerung wählen
Schritt 7: Wenn Sie die Sprechblase auf allen Seiten anzeigen möchten, wählen Sie alle Seiten aus
Einen Namen festlegen
Klicken Sie auf Speichern
Das Ergebnis sieht so aus
Schritt 8: Änderungen auf der Website veröffentlichen
Die Chat-Blase sollte jetzt auf der Website sichtbar sein
Es gibt verschiedene Möglichkeiten, auf der Website mit dem digitalen Assistenten von AutoChat zu interagieren.
-
Über die Chat-Blase
-
Über eine Suchleiste
-
Über einen speziellen Call-to-Action-Button
Über die Chat-Blase
Wenn Sie die Basisversion unseres Skripts installieren, wird die Blase automatisch angezeigt, sofern sie im Dashboard aktiviert ist.
Verwenden Sie eine SPA und möchten Sie die Chat-Blase nur auf bestimmten Seiten anzeigen? Mit diesem Code können Sie sie optional anzeigen:
window.dispatchEvent(new Event('autochat_hide_chat_bubble'));
// To re-enable the bubble after disabling it, use the following command:
window.dispatchEvent(new Event('autochat_show_chat_bubble'));
Über eine Suchleiste
Es ist möglich, auf Ihrer Website eine Suchleiste zu installieren, die mit AutoChat verbunden ist.
<textarea id="question"></textarea><button onclick="autochat.askQuestionToAi(document.getElementById('question').value);">Ask question</button>
Stellen Sie sicher, dass Sie die Anzahl der Zeichen, die Sie uns als Frage senden, auf 256 begrenzen.
Um sicherzustellen, dass Sie das volle Potenzial Ihres digitalen Assistenten nutzen, empfehlen wir Ihnen, spezielle CTAs zu installieren und Ihren digitalen Assistenten mit diesen zu verbinden.
Sie können Ihren digitalen Assistenten in den folgenden Szenarien verwenden:
-
Zur Terminbuchung
-
So buchen Sie einen Showroom-Termin
-
Zur Terminvereinbarung für eine Probefahrt
-
Ein Auto in Zahlung geben
-
Lassen Sie den gesamten Verkaufsfluss unter einem CTA ablaufen
-
Zur Buchung eines Werkstatttermins
-
So erstellen Sie eine Kontaktanfrage
Einige dieser Abläufe funktionieren besser, wenn wir wissen, welches Auto der Kunde gerade ansieht (eine sogenannte Fahrzeugdetailseite). Um unsere Funktionen optimal nutzen zu können, aktivieren Sie die Fahrzeugidentifikation.
Termin buchen
Wenn Sie sich nicht sicher sind, ob der Verbraucher einen Verkaufs- oder After-Sales-Termin buchen möchte, können Sie diesen Ansatz verwenden und den Verbraucher selbst entscheiden lassen:
<button onclick="autochat.askQuestion('I want to book an appointment');">Book appointment</button>
Buchen Sie einen Showroom-Termin
Um eine Schaltfläche zu erstellen, die den Showroom-Flow startet, können Sie diesen Code verwenden:
<button onclick="autochat.askQuestion('I want a showroom appointment');">Book showroom appointment</button>
Wenn Sie dem Verbraucher jedoch die Möglichkeit geben möchten, einen Termin im Ausstellungsraum für das Auto zu buchen, für das er sich interessiert, müssen Sie eine etwas andere Version verwenden:
<button onclick="autochat.askQuestion('I want to see this car', { vdp: true });">Book a showroom appointment for this car</button>
Es ist möglich, eine oder mehrere Fragen zu überspringen, indem Sie im Eröffnungssatz zusätzliche Informationen hinzufügen, zum Beispiel:
<button onclick="autochat.askQuestion('I want to book a showroom appointment for BMW');">Book showroom appointment for BMW</button>
Im obigen Beispiel fragt der Assistent nicht nach der Marke, da er bereits weiß, für welche Marke sich der Verbraucher interessiert.
Sie können auch einen bestimmten Ort angeben und diese Frage überspringen:
<button onclick="autochat.askQuestion('I want to book a showroom appointment at BMW Dealer 1');">Book showroom appointment at BMW Dealer 1</button>
Es ist wichtig, dass der hier verwendete Name genau derselbe ist, der in unserem Dashboard definiert ist.
Anstatt den Ortsnamen im Eingangssatz zu verwenden, kann auch ein Filter eingesetzt werden:
<button onclick="autochat.askQuestion('I want to book a showroom appointment',{filterByLocationName:"Amsterdam"});">Showroom appointment</button>
Vereinbaren Sie einen Termin zur Probefahrt
Um den Testlaufablauf zu starten, verwenden Sie diesen Code:
<button onclick="autochat.askQuestion('I want to book a testdrive appointment');">Book a testdrive appointment</button>
Wenn Sie eine Probefahrt mit dem Auto buchen möchten, das Sie gerade ansehen, verwenden Sie:
<button onclick="autochat.askQuestion('I want to book a testdrive for this car', { vdp: true });">Book a testdrive for this car</button>
<button onclick="autochat.askQuestion('I want to book a testdrive appointment for a BMW 1 serie');">Book a testdrive appointment for a BMW 1 serie</button>
Auto in Zahlung geben
Wenn Sie den Trade-In-Flow starten möchten:
<button onclick="autochat.askQuestion('I want to trade in my current car');">Trade in my car</button>
Sie können den gleichen Code verwenden, unabhängig davon, ob ein Fahrzeugkontext vorliegt oder nicht. Das bedeutet: Wenn ein Verbraucher sich auf einer Seite mit Fahrzeugdetails befindet, nehmen wir das von ihm angesehene Auto in den Lead zum Händler auf.
Lassen Sie den gesamten Verkaufsfluss unter einem CTA ablaufen
Sie können auch eine CTA-Schaltfläche erstellen und den Verbraucher wählen lassen, was er tun möchte:
<button onclick="autochat.askQuestion('I'm interested', { vdp: true });">I'm interested in this car</button>
Workshop-Termin buchen
Die einfachste Variante einen Werkstatttermin anzulegen ist:
<button onclick="autochat.askQuestion('I want to book a workshop appointment');">Book workshop appointment</button>
Oder Sie können Fragen überspringen:
<button onclick="autochat.askQuestion('I want to book a workshop appointment for my BMW');">Book workshop appointment for a BMW</button>
<button onclick="autochat.askQuestion('I want to book a workshop appointment for my BMW at BMW Dealer 1');">Book workshop appointment for a BMW at BMW Dealer 1</button>
<button onclick="autochat.askQuestion('I want to book a workshop appointment',{filterByLocationName:"Birmingham"});">Showroom appointment</button>
Kontaktanfrage erstellen
Wenn Sie möchten, dass der Verbraucher Kontaktdaten hinterlässt:
<button onclick="autochat.askQuestion('I want a contact request');">Contact me</button>
Es ist sehr wichtig, das Kundenerlebnis des Verbrauchers zu bereichern, indem man AutoChat mitteilt, welches Auto er oder sie sich gerade ansieht.
Bei AutoChat verbringen wir einen großen Teil unserer Zeit damit, Integrationen mit VMS-Systemen (Vehicle Management System) zu erstellen. Wir tun dies, damit wir den aktuellen Lagerbestand eines Händlers erhalten. Wenn wir den Lagerbestand erhalten, können wir das Erlebnis für den Verbraucher auf folgende Weise bereichern:
-
Wir können Fragen zu dem Auto beantworten, das der Verbraucher gerade ansieht (einzelnes Auto).
-
Wir können dem Verbraucher helfen, das Auto zu finden, das er sucht (großer Bestand).
-
Wir können dem Verkäufer genau mitteilen, für welches Auto sich der Kunde interessiert.
-
Da das Auto an einen bestimmten Standort gebunden ist, können wir dem Verbraucher bei der Terminerstellung die passende Verfügbarkeit zur Auswahl anzeigen.
Falls wir die Fahrzeugkennung nicht von der Website erhalten oder das Fahrzeug aus irgendeinem Grund nicht in unserer Datenbank haben, greifen wir häufig auf eine sogenannte Fallback-Version eines bestimmten Ablaufs zurück. Dies ist eine vereinfachte Version des spezifischen Ablaufs und führt häufig zu einem weniger als optimalen Kundenerlebnis.
Sie können uns auf mehreren Wegen mitteilen, für welches Auto sich der Verbraucher interessiert:
-
Fügen Sie die Kennung in der AutoChat-Konfiguration hinzu
-
Fügen Sie der Website einen HTML-Tag hinzu (empfohlen)
-
Fügen Sie die Kennung in die CTA-Schaltfläche ein
Hinzufügen des Bezeichners über AutoChat Config
Du kannst uns die Kennung über die AutoChat-Konfiguration senden, in der du uns auch die spezifischen Anmeldeinformationen für den Assistenten übermittelst, der auf der Website installiert wird, und zwar wie folgt:
<script>
(function(){
var autochatConfig = {
assistantId: "INSERT ASSISTANTID",
accessToken: "INSERT ACCESSTOKEN",
locale: "NL", // or EN/FR
// To set up a link between the website and the car a consumer is looking at use one of these identification methods:
currentCarVin: "PLACE CAR VIN NUMBER HERE",
// - OR -
licensePlate: "PLACE CAR LICENSE PLATE NUMBER HERE",
// - OR -
stockNumber: "PLACE CAR STOCK NUMBER HERE"
};
var s=document.createElement("script");s.src="https://static.chatclient.autochat.ai/release/autochat.js?ver=1",s.async=!0,s.defer=!0,s.addEventListener("load",function(){autochat.init(autochatConfig)}),document.body.appendChild(s);
})()
</script>
Wichtig zu beachten ist, dass Sie immer nur eine Identifikationsmethode gleichzeitig verwenden können. Wenn wir mehrere Autos finden, senden wir immer ein leeres Ergebnis zurück, d. h. der Assistent weiß nicht, um welches Auto es sich handelt.
stockNumber stellt häufig eine interne Nummer dar, die aus dem Fahrzeugverwaltungssystem stammt.
Fügen Sie die Kennung über einen HTML-Tag hinzu
Alternativ können Sie uns die Fahrzeugkennung auch übermitteln, indem Sie diesen HTML-Tag an einer beliebigen Stelle auf der Fahrzeugdetailseite einfügen:
<div id="autochat-car-id" data-car-id="abc"></div>
Die Informationen im Tag müssen auf der Seite nicht sichtbar sein.
Fügen Sie die Kennung in die CTA-Schaltfläche ein
In manchen Fällen, beispielsweise wenn Sie auf einer Übersichtsseite für den Bestand einen CTA pro Auto installieren möchten, kann es hilfreich sein, pro CTA-Schaltfläche eine Autokennung zu implementieren. Dies ist ein Beispiel für eine Schaltfläche für eine Probefahrt, die die Autokennung enthält:
<button onclick="autochat.askQuestion('I want a testdrive appointment for this car', { vdp: true, currentCarVin: 'ZFA3120000JB11486' });">I want to testdrive this car</button>
Wenn Sie testen möchten, ob die Integration zwischen der Website und AutoChat erfolgreich erstellt wurde, können Sie Folgendes tun. Öffnen Sie eine Fahrzeugdetailseite und starten Sie einen Chat, indem Sie in der Chat-Blase auf „Frage stellen“ klicken. Wenn auf der rechten Seite der Chat-Oberfläche ein Auto angezeigt wird, wissen Sie, dass die Integration erfolgreich eingerichtet wurde.
Inventar-Feed:
Veröffentlichen Sie Ihren Fahrzeugbestand nahtlos in AutoChat.
In diesem Artikel wird erklärt, wie Sie Ihren Bestand von Wheelerdelta - Autodata in AutoChat veröffentlichen können. Da dies hauptsächlich von unseren niederländischen Kunden verwendet wird, sind die Screenshots auf Niederländisch.
Gehen Sie zunächst zum Hauptbildschirm
Wählen Sie „Einstellungen“
Wählen Sie „Internet koppelingen“
Wählen Sie „Anfragen“
Wählen Sie aus der Optionsliste AutoChat aus
Wählen Sie beide Optionen und klicken Sie auf „Anvagen“
Klicken Sie auf „Opslaan“
AutoChat ist jetzt verfügbar. Aktivieren Sie das Kontrollkästchen
Klicken Sie unten auf der Seite auf „Opslaan“.
Es ist wichtig, nach jeder Änderung auf „Opslaan“ zu klicken.
Die Anfrage ist nun in Bearbeitung. Sobald wir alles auf unserer Seite konfiguriert haben, ändert sich der Status auf „Aktiv“.
Nachdem alles eingerichtet ist, steht AutoChat als Veröffentlichungskanal zur Verfügung
Verfolgen Sie die Benutzerinteraktion mit Google Analytics
Erfahren Sie, wie Sie AutoChat-Daten mit Google Analytics verbinden, um wertvolle Einblicke in das Nutzerverhalten zu gewinnen, die Leistung zu optimieren und die Kundeninteraktionen auf der Website Ihres Autohauses zu verbessern.
Wir bieten zwei Methoden an, um unsere Daten mit Google Analytics zu verbinden:
-
Verwenden Sie Google Tag Manager
-
Verwenden Sie Google Analytics 4
Verbinden Sie AutoChat mit Google Tag Manager
GTM ermöglicht es Ihnen, Events mithilfe von Tags an Dritte zu verteilen. Dazu müssen Sie Daten in der sogenannten „Datenschicht“ bereitstellen. Die Syntax hierfür lautet:
dataLayer.push({
"event": "name_of_the_event",
"variable1": "value of variable1",
"variable2": "value of variable2",
});
Derzeit sendet AutoChat mehrere Ereignisse. Die Ereignisse finden Sie hier. Um AutoChat-Ereignisse über GTM abzuhören, müssen Sie die folgenden Schritte ausführen:
Fügen Sie ein benutzerdefiniertes HTML-Tag hinzu, das die AutoChat-Ereignislistener hinzufügt
-
Gehen Sie zu Ihrem GTM-Container.
-
Gehen Sie zu Tags und klicken Sie auf „Neu“.
-
Wählen Sie dann den Tag-Typ „Benutzerdefiniertes HTML“ aus.
-
Geben Sie dem Tag einen aussagekräftigen Namen, zum Beispiel „AutoChat – Ereignislistener“.
-
Fügen Sie den Trigger „Alle Seiten“ oder einen bestimmten Trigger hinzu, um ihn auf Seiten zu beschränken, auf denen AutoChat geladen wird.
-
Fügen Sie dann den folgenden Code in das HTML ein.
-
Speichern.
Um es etwas einfacher zu machen, hier zwei Beispiele:
<script>
window.addEventListener('autochat_lead_created', function (e) {
try {
dataLayer.push({
"event":e.type,
"autochat_event_details": e.detail.eventData
});
} catch(e){
//Your error handling if relevant
}
});
</script>
<script>
window.addEventListener('autochat_lead_created', function (e) {
try {
dataLayer.push({
"event":e.type,
"autochat_event_details": e.detail.eventData
});
} catch(e){
//Your error handling if relevant
}
});
window.addEventListener('autochat_chat_first_user_interaction', function (e) {
try {
dataLayer.push({
"event":e.type,
"autochat_event_details": e.detail.eventData
});
} catch(e){
//Your error handling if relevant
}
});
</script>
In Beispiel 2 sehen Sie, dass wir einen Listener für zwei Ereignisse hinzugefügt haben:
-
autochat_lead_erstellt
-
autochat_chat_erste_benutzerinteraktion
Im Code sehen Sie einen Try-Catch. Dort können Sie optional Ihre eigene Fehlerbehandlung einfügen. Ansonsten lassen Sie es so wie es ist.
Erstellen Sie die Variablen, um die Ereignisdaten zu nutzen
Neben Ereignissen stellt AutoChat zusätzliche Ereignisdaten bereit, die für Sie relevant sein können:
Variablenname |
Relevante Veranstaltungen |
Beschreibung |
---|---|---|
chatSessionId (veraltet) |
autochat_lead_erstellt |
Die eindeutige ID der aktuellen Chat-Sitzung, die der ID im Backend von AutoChat entspricht. Wird durch session_id ersetzt und zukünftig gelöscht. |
Termintyp |
autochat_lead_erstellt |
Dies ist die Art der Ernennung. |
Sitzungs-ID |
alle |
Dies ist die Sitzungs-ID einer Chat-Sitzung. Für alle Ereignisse in einem Chat ist dies derselbe Wert. |
Chattyp |
alle (ausschließen: autochat_lead_created) |
Dies ist der Chattyp – ähnlich wie Appointment_Type. |
Für jede der oben genannten Variablen können Sie die folgenden Schritte ausführen:
-
Gehen Sie zu Ihrem GTM-Container.
-
Gehen Sie zu Variablen und klicken Sie unter „Benutzerdefinierte Variablen“ auf „Neu“.
-
Wählen Sie „Datenschichtvariable“ als Variablentyp.
-
Geben Sie ihm einen passenden Namen. Beispiel: „AutoChat - #Variablenname#“.
-
Als Variablenname müssen Sie den Namen der AutoChat-Variable eintragen.
-
Klicken Sie auf Speichern.
Ein Beispiel sieht so aus:
Verknüpfen Sie die Ereignisse mit dem Auslöser
Der nächste Schritt besteht darin, Trigger zu erstellen, mit denen Sie Tags basierend auf den AutoChat-Ereignissen auslösen können. Befolgen Sie die folgenden Schritte für jedes AutoChat-Ereignis, das Sie als Trigger verwenden möchten:
-
Gehen Sie zu Ihrem GTM-Container.
-
Gehen Sie dann zu Triggern und klicken Sie auf „Neu“.
-
Wählen Sie den Triggertyp „Benutzerdefiniertes Ereignis“
-
Geben Sie ihm einen passenden Namen. Zum Beispiel „AutoChat – Lead erstellt“.
-
Verwenden Sie den AutoChat-Ereignisnamen als Ereignisnamen.
-
Klicken Sie auf Speichern.
Es sollte so aussehen:
Zum Abschluss kombinieren Sie Trigger und Variablen in Ihren Tags
Du hast nun alle Bausteine, um Tags auszulösen und mit Daten anzureichern. Ein Beispiel für GA4 sieht wie folgt aus:
-
Gehen Sie zu Ihrem GTM-Container.
-
Gehen Sie dann zu Tags und klicken Sie auf „Neu“.
-
Wählen Sie den Tag-Typ „Google Analytics: GA4-Ereignis“
-
Geben Sie ihm einen aussagekräftigen Namen. Beispiel: GA4 – AutoChat-Ereignisse.
-
Geben Sie Ihre Mess-ID ein oder verknüpfen Sie sie mit Ihrer Google-Tag-Konfiguration.
-
Füllen Sie {{Event} } als „Ereignisname“.
-
Gehen Sie dann zu „Ereignisparameter“ und fügen Sie die AutoChat-Variablen als Parameter hinzu.
-
Klicken Sie auf Speichern.
Das Ergebnis sieht ungefähr so aus:
Sie können jetzt einen beliebigen AutoChat-Ereignisauslöser hinzufügen und die Daten werden automatisch an GA4 gesendet. Sie müssen die Schritte „GA4 benutzerdefinierte Dimensionen“ befolgen, um die Ereignisparameter für die Berichterstellung zu aktivieren. Ein weiteres Beispiel für Google Ads:
GA4 Benutzerdefinierte Abmessungen
Um Berichte basierend auf den von Ihnen hinzugefügten Ereignisparametern zu erstellen, müssen Sie sogenannte „benutzerdefinierte Dimensionen“ konfigurieren. Dies können Sie wie folgt tun:
-
Gehen Sie zu Ihrem GA4-Property-Admin.
-
Gehen Sie dann zu „Benutzerdefinierte Definitionen“.
-
Gehen Sie dann zu „Benutzerdefinierte Dimension“ und klicken Sie auf „Benutzerdefinierte Dimension erstellen“.
-
Der Dimensionsname sollte etwas Beschreibendes sein, etwa „AutoChat-Öffnungstyp“.
-
Der Umfang ist „Ereignis“.
-
Der Event-Parameter ist der Variablenname, den Sie auch im GA4-Tag verwendet haben. Zum Beispiel „chat_open_type“.
Das sieht dann wie folgt aus:
Sobald diese Konfiguration abgeschlossen ist, können Sie die AutoChat-Dimensionen in Ihren „Explore“-Berichten nutzen.
Verbinden Sie AutoChat direkt mit Google Analytics 4
Um Daten direkt an GA4 zu senden, können Sie eine Tag-Management-Lösung oder die Googletag-Implementierung nutzen.
Weitere Informationen zu diesen Optionen finden Sie in der GA4-Dokumentation. Dieser Abschnitt konzentriert sich auf die Googletag-Implementierung.
Einrichten Ihres Googletags
Bevor Sie mit der Implementierung von Events fortfahren können, müssen Sie den Googletag auf Ihrer Website platzieren. Weitere Informationen finden Sie hier: https://support.google.com/analytics/answer/9304153 .
Verwenden Sie dieses Setup niemals parallel mit Google Tag Manager. Wenn Sie Google Tag Manager haben, verwenden Sie die Anleitung dazu.
Der Grundaufbau sieht wie folgt aus:
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-12345678"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'G-12345678');
</script>
Hinweis: Sie müssen G-12345678 durch Ihre eigene Mess-ID ersetzen. In der Dokumentation finden Sie weitere Informationen dazu, wie Sie Ihre Mess-ID finden.
Einrichten Ihrer AutoChat-Ereignisse
Nachdem die Grundlagen abgeschlossen sind, können Sie den folgenden Code zu Ihrer Website hinzufügen. Sie können das AutoChat-Ereignisverfolgungs-Snippet nach gtag('config', 'G-12345678'); hinzufügen, wie Sie unten sehen können.
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-12345678"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'G-12345678');
</script>
<script>
window.addEventListener('autochat_lead_created', function (e) {
try {
gtag('event', e.type, {
'chat_session_id': e.detail.eventData.chatSessionId,
'appointment_type': e.detail.eventData.appointment_type
});
} catch(e){
//Your error handling if relevant
}
});
window.addEventListener('autochat_chat_first_user_interaction', function (e) {
try {
gtag('event', e.type, {
'chat_session_id': e.detail.eventData.chatSessionId,
'appointment_type': e.detail.eventData.appointment_type
});
} catch(e){
//Your error handling if relevant
}
});
</script>
Im obigen Beispiel haben wir zwei Listener hinzugefügt:
-
autochat_lead_erstellt
-
autochat_chat_erste_benutzerinteraktion
Die Liste der verfügbaren Veranstaltungen finden Sie hier:
Der „e.type“ wird automatisch mit dem Namen des Ereignisses ausgefüllt. Zum Beispiel „autochat_lead_created“. Dies ist auch der Ereignisname, den Sie in GA4 sehen werden.
Anschließend findet man nach dem Eventnamen alle sogenannten Parameter. Im obigen Beispiel haben wir folgende zwei Eventparameter:
-
Chatsitzungs-ID
-
Termintyp
Eine Liste aller Event-Parameter finden Sie hier: in Kürze verfügbar .
Sie müssen nur noch die Ereignisparameter als benutzerdefinierte Dimensionen in GA4 erstellen. Weitere Informationen finden Sie im Abschnitt „Benutzerdefinierte Dimensionen in GA4“.
Nachdem Sie die Integration im AutoChat-Dashboard aktiviert haben, kann es hilfreich sein, benutzerdefinierte Dimensionen zu erstellen, um die Daten besser anzeigen/filtern zu können. Dieser Artikel zeigt Ihnen, wie das geht.
Gehen Sie zu https://analytics.google.com/analytics/web/#/ und klicken Sie auf „Admin“.
Wählen Sie das richtige Konto aus und klicken Sie auf Benutzerdefinierte Definitionen
Klicken Sie auf „Benutzerdefinierte Definition erstellen“
Wir empfehlen, mindestens diese beiden Definitionen zu erstellen:
Sie können nun bei der Anzeige der Daten die Dimensionen nutzen.
Dies ist eine Übersicht über die Informationen, die AutoChat mit Google Analytics teilt.
Name |
Wann |
Inhalt |
---|---|---|
autochat_chat_erste_benutzerinteraktion |
Hat eine Interaktion stattgefunden? Dies ist nicht dasselbe wie das Klicken auf eine CTA-Schaltfläche. Wir registrieren dieses Ereignis, wenn:
|
|
autochat_lead_erstellt |
Ein Lead wurde angelegt. Das bedeutet nicht, dass der Lead technisch auch im Leadmanagementsystem angelegt wurde. Wir registrieren dieses Ereignis, wenn der Besucher am Ende der Konversation in dem Moment auf „ja, das stimmt“ klickt, in dem wir nachfragen, ob seine eingegebenen Daten korrekt sind. |
|
autochat_ich_bin_interessiert |
Jedes Mal, wenn jemand einen „Ich bin interessiert“-Flow startet, senden wir dieses Ereignis. |
|
autochat_eine_frage_stellen |
Wenn die ChatGPT-Integration deaktiviert ist und ein Besucher einen Chat über „Frage stellen“ startet, senden wir dieses Ereignis. |
|
autochat_ask_a_question_ai |
Wenn die ChatGPT-Integration aktiviert ist und ein Besucher einen Chat über „Frage stellen“ startet, senden wir dieses Ereignis. |
|
autochat_frage_beantwortet_ai |
Jedes Mal, wenn ChatGPT antwortet, senden wir dieses Ereignis. |
|
autochat_stellen_sie_eine_frage_ai_vdp |
Wenn die ChatGPT-Integration aktiviert ist und ein Besucher auf einer Fahrzeugdetailseite einen Chat über „Frage stellen“ in der Chatblase startet, senden wir dieses Ereignis. In diesem Fall senden wir kein autochat_question_asked_ai. |
|
autochat_frage_beantwortet_ai_vdp |
Wenn die ChatGPT-Integration aktiviert ist und der Bot dem Besucher auf der Fahrzeugdetailseite eine Antwort gibt, senden wir dieses Ereignis. In diesem Fall senden wir kein autochat_question_answered_ai. |
|
Autochat_von_Frage_bis_Termin_Flow |
Wenn ein Verbraucher eine Unterhaltung über die Schaltfläche „Frage stellen“ in der Chat-Blase beginnt und irgendwann entweder auf einen Vorschlag klickt oder eine Anfrage eingibt, die ihn in einen unserer vordefinierten Abläufe führt, wie z. B. „Probefahrt buchen“ oder „Werkstatttermin buchen“, lösen wir dieses Ereignis aus. |
|
autochat_flow_started |
Wenn ein Besucher einen Chat startet oder von „Eine Frage stellen“ zu einem bestimmten Ablauf wechselt (er klickt entweder auf einen Vorschlag oder gibt eine Anfrage ein, die ihn zu einem unserer vordefinierten Abläufe führt, wie z. B. „Probefahrt buchen“ oder „Werkstatttermin buchen“), lösen wir dieses Ereignis aus. |
|
automatischer Chatablauf erfolgreich |
Wenn der Besucher den Chat erfolgreich beendet, beispielsweise wenn er einen Termin vereinbart oder eine Antwort von ChatGPT erhalten hat. |
|
autochat_workshop_forward |
Wenn keine direkte Integration mit dem Planungssystem der Organisation besteht, wird der Besucher möglicherweise auf eine bestimmte Seite weitergeleitet. Auf dieser Seite finden Sie Anweisungen, wie der Besucher selbst einen Termin vereinbaren kann. |
|
automatischer Chat wird beim Laden geöffnet |
Wir lösen dieses Ereignis aus, wenn ein Benutzer den Pfad der Seite besucht, die für den automatischen Start von AutoChat konfiguriert ist. |
Wenn LEF als Leadmanagement-System aktiviert ist, versenden wir bei erfolgreicher Lead-Erstellung folgende Informationen.
Eigentum |
Aftersales-Termin |
Verkaufstermin |
---|---|---|
LeadID |
✅ |
✅ |
LeadTyp |
Kundendienst |
Verkäufe |
Art der Leitung |
Aftersales-Termin |
Showroom-/Probefahrtbesuch |
Standortnummer |
✅ |
✅ |
Beschreibung |
AutoChat |
AutoChat |
Vorname |
✅ |
✅ |
Nachname |
✅ |
✅ |
Telefonnummer |
✅ |
✅ |
|
✅ |
✅ |
Weitere Informationen |
Das vollständige Chatprotokoll |
Das vollständige Chatprotokoll |
Bevorzugtes Fahrzeug |
NEIN |
✅ |
Machen |
NEIN |
✅ |
Modell |
NEIN |
✅ |
Version |
NEIN |
✅ |
URL, unter der der Chat stattgefunden hat |
NEIN |
✅ |
Fahrgestellnummer |
NEIN |
✅ |
Initiative |
|
Kunde |
Kennzeichen |
|
✅ |
Kraftstoffart |
|
✅ |
Baujahr |
|
✅ |
Fahrzeugtyp |
|
Neu, Gebraucht, Unbekannt |
Wenn die E-Mail-Integration aktiviert ist, erhalten Sie eine E-Mail, wenn ein Lead erfolgreich erstellt wurde.
Diese E-Mail hat einen visuellen Teil, der ungefähr so aussieht:
Es ist jedoch auch möglich, die Lead-Informationen auf Basis dieser E-Mail in ein anderes System zu importieren. Hierzu verwenden wir den JSON-Lead- Standard. Die E-Mail ist in HTML aufgebaut und in diesem HTML befindet sich ein „div“ mit der ID „jsonlead“. Dieses enthält die Lead-Informationen, die im JSON-Format wie folgt gespeichert sind:
{
"client": {
"phone": "2137212321",
"first_name": "John",
"last_name": "Doe",
"postal_code": "4800 AA",
"email": "john.doe@autochat.ai"
},
"sales_lead": {
"car": {
"type": "new",
"category": "car",
"stock_id": "dealership-internal-id",
"body_style": "sedan",
"make": "toyota",
"model": "corolla",
"version": "1.8 Hybrid Executive",
"year": 2020,
"price": 30000,
"license_plate": "kt-303-a",
"mileage": 100,
"doors": 5,
"vin": "vin-where-available",
"fuel": "hybrid_petrol",
"transmission": "automatic",
"horsepower": 120,
"color": "red",
"url": "https://appointment-context-url",
"engine_size": 1798
},
"appointment": {
"foreign_id": "our-uuid"
},
"dealer_location": "dealership-name"
},
"version": "1.0.0"
}
AutoChat API
Erfahren Sie, wie Sie Ihre Fahrzeugbestandstools mithilfe unserer API mit AutoChat verbinden, um Fahrzeuge nahtlos zu veröffentlichen und Ihr digitales System über alle verfügbaren Fahrzeuge zu informieren.
Stolzieren
Unsere Swagger-Dokumentation finden Sie hier: https://console.autochat.ai/api/docs.html
Umgebungen
Wir haben 2 Umgebungen:
-
Produktion: https://console.autochat.ai
-
Staging: https://staging.autochat.ai/api/cars
Authentifizierung
Nach Unterzeichnung einer Vereinbarung erhalten Sie Anmeldeinformationen für unsere API. Sie können unter dieser URL https://autochat-dev.eu.auth0.com/oauth/token ein Token anfordern (POST). Dies funktioniert sowohl für die Produktion als auch für die Inszenierung. Sie erhalten von uns eine Client-ID und ein Client-Geheimnis. Sie können ein Token folgendermaßen abrufen:
{
"client_id":"",
"client_secret":"",
"audience":"http://api.autochat.com/",
"grant_type":"client_credentials"
}
Die Antwort sieht ungefähr so aus:
{
"access_token": "xxxxxxxxxxxxxxxxxxxxxx",
"token_type": "Bearer"
}
Sie können jetzt das Bearer-Token im Header verwenden.
Bitte beachten Sie, dass das Token 24 Stunden gültig ist. Fordern Sie daher nicht für jede Anfrage ein neues Token an, sondern verwenden Sie es immer wieder, bis es nicht mehr gültig ist. Wenn wir eine hohe Anzahl an Token-Anfragen feststellen, kann Ihr Zugriff eingeschränkt werden.
Armaturenbrett
Es ist wichtig, dass in unserem Dashboard die richtige Bestandsintegration aktiviert ist. Wenn dies nicht der Fall ist, können Sie uns keine Autos über die API senden. Oftmals richten wir dies im Voraus für Sie ein.
Ein Auto schaffen
Wenn Sie ein neues Auto bei api/cars einstellen, müssen Sie gültige Informationen angeben. Dies ist ein Beispiel für ein Auto:
{
"bodyColor": "white",
"bodyType": "suv",
"currency": "EUR",
"dateOfFirstRegistration": "2022-09-16",
"dealershipId": "you get this from us",
"description": "A nice car",
"engineDisplacement": 2137,
"engineEmission": 191,
"engineKw": 74,
"fuelType": "diesel",
"images": [],
"internalId": "SEB-21347958",
"isTaxDeductible": true,
"licensePlate": "XD9913",
"brand": "bmw",
"model": "x6",
"options": [
"power_steering",
"passenger_airbag",
"tempomat",
"armrest",
"sliding_door",
"side_airbag",
"ac",
"dark_tinted_glass",
"seat_heating",
"abs",
"chassis_double_cabin",
"power_windows_front",
"fog_lights",
"heated_seats",
"radio_cd",
"multi_functional_steering_wheel",
"trailer_hitch",
"parking_assist_system_camera",
"radio",
"shift_paddles",
"start_stop_system",
"on_board_computer",
"navigation_system",
"cd_player",
"parking_assist_system_sensors_rear",
"central_door_lock_remote",
"board_computer",
"towbar",
"light_sensor",
"interior_mirror_automatically_dimmable",
"cruise_control",
"leather_steering_wheel",
"adaptive_headlights"],
"salesPrice": 15944.63,
"salesPriceExVat": 15944.63,
"tags": [],
"taxAmount": 9873,
"tradePrice": 159454.63,
"transmission": "manual",
"gears": 3,
"mileage": 2137,
"mileageUnit": "KM",
"version": "2.3 TDCI Diesel",
"vin": "WAVWGBFH3AN026569",
"numberOfDoors": 4,
"yearOfConstruction": 2019
}
Optionen für ein Auto definieren
Beim Zugriff auf api/options wird eine Liste aller verfügbaren Optionen angezeigt
{
"esaco_identifier": 0,
"name": "power_steering",
"prettyName": "Power steering",
"uuid": "02f50f11-f840-4ba0-8232-2ec459c3008f"
},
{
"esaco_identifier": 0,
"name": "keyless_central_door_lock",
"prettyName": "Keyless central door lock",
"uuid": "03d18842-0bb6-4aa0-8984-c5dd3ee4aa96"
},
{
"esaco_identifier": 0,
"name": "driver_drowsiness_detection",
"prettyName": "Driver drowsiness detection",
"uuid": "04204c98-9018-47c0-86bb-3dadbd6fabdb"
}
Bitte beachten Sie, dass diese Liste bei Staging und Produktion unterschiedlich sein kann. Außerdem müssen Sie die Option über die Namenseigenschaft und nicht über die UUID bereitstellen.
Bilder
Wenn für das Auto noch keine Bilder vorhanden sind, schließen Sie die Bildereigenschaft bitte mit einem leeren Array ein.