Dokumentation · Benutzerhandbuch
Tägliche Arbeitsabläufe
Dieses Dokument beschreibt die betrieblichen Arbeitsabläufe, die Administratoren und Garagen-Mitarbeiter regelmässig durchführen, wenn sie den Fahrzeugbestand über das ADP Car Market Hub-Plugin verwalten. Es umfasst die Überprüfung von Importen, die Kontrolle von Leads, die Validierung des Frontends und die Überwachung des Systemstatus.
Wann Sie dieses Dokument verwenden sollten
Lesen Sie dieses Dokument, wenn Sie:
- Für den täglichen oder wöchentlichen Betrieb einer Fahrzeugbörsen-Website verantwortlich sind, die mit diesem Plugin betrieben wird.
- Eine praktische Checkliste benötigen, um zu überprüfen, ob die Importe erfolgreich gelaufen sind, Leads empfangen werden und das Frontend den Bestand korrekt anzeigt.
- Verstehen möchten, worauf Sie achten müssen und wo Sie suchen müssen, wenn etwas nicht in Ordnung zu sein scheint.
Für die vollständige Konfigurations- und Einrichtungsanleitung lesen Sie das Administrator-Handbuch.
Übersicht
Unter normalen Betriebsbedingungen läuft das ADP Car Market Hub-Plugin weitgehend automatisch. Der geplante Importer ruft in konfigurierten Intervallen aktualisierte Fahrzeugdaten von der AutoScout24-API ab, lädt Bilder in einer Hintergrundwarteschlange herunter und hält den WordPress-Bestand mit dem Live-Inserat synchron.
Das Betriebspersonal sollte jedoch regelmässig überprüfen, ob:
- Die Importläufe erfolgreich abgeschlossen werden.
- Neue und aktualisierte Fahrzeuge im Frontend sichtbar sind.
- Kunden-Leads empfangen und verarbeitet werden.
- Das Plugin-Protokoll keine ungelösten Fehler enthält.
- Die Bildwarteschlange keinen nennenswerten Rückstau aufbaut.
Arbeitsablauf 1: Importstatus überprüfen
Führen Sie diese Prüfung täglich oder nach jedem geplanten Importlauf durch.
Schritte
- Melden Sie sich im WordPress-Admin-Dashboard an.
- Navigieren Sie zu ADP Car Market Hub → Dashboard.
- Überprüfen Sie die KPI-Zeile: - Prüfen Sie Fahrzeuge total, um zu bestätigen, dass die Anzahl des Bestands den Erwartungen entspricht. - Prüfen Sie Neu (letzte 7 Tage), um zu sehen, wie viele Fahrzeuge kürzlich hinzugefügt wurden.
- Überprüfen Sie das Diagramm Bestandstrend, um zu bestätigen, dass die Importläufe in der vergangenen Woche Ergebnisse geliefert haben.
- Überprüfen Sie den Bereich Aufmerksamkeit erforderlich auf handlungsrelevante Probleme, wie z. B. Fahrzeuge ohne Bilder oder Kurzbeschreibungen.
- Navigieren Sie zu ADP Car Market Hub → Import & Limits.
- Überprüfen Sie die auf dem Tab angezeigte letzte Importzeit und den letzten Importstatus. Bestätigen Sie, dass der jüngste Lauf ohne Fehler abgeschlossen wurde.
- Wenn die letzte Laufzeit unerwartet alt erscheint (z. B. mehr als 24 Stunden her bei einem stündlichen Zeitplan), prüfen Sie, ob der Cron läuft. Siehe den Arbeitsablauf Cron-Status überprüfen weiter unten.
Worauf zu achten ist
- Der Zeitstempel des letzten Imports sollte mit Ihrem konfigurierten Zeitplan übereinstimmen (z. B. ungefähr jede Stunde bei einem stündlichen Zeitplan).
- Die Anzahl der importierten Fahrzeuge sollte Ihren AutoScout24-Bestand widerspiegeln.
- Keine dauerhaften Fehlermeldungen auf dem Tab "Import & Limits".
Arbeitsablauf 2: Plugin-Protokoll überprüfen
Führen Sie diese Prüfung täglich durch, oder sofort, wenn ein vermuteter Importfehler auftritt.
Schritte
- Navigieren Sie zu ADP Car Market Hub → Logs.
- Überprüfen Sie das Panel Kürzliche Fehler oben auf der Seite. Dies zeigt die neuesten Protokolleinträge der Stufe "Error" aus den letzten 2'000 Zeilen der Protokolldatei.
- Überprüfen Sie das Panel Kürzliche Warnungen auf unkritische Probleme, die dennoch Aufmerksamkeit erfordern könnten.
- Wenn Fehler oder Warnungen vorhanden sind, notieren Sie deren Zeitstempel und Inhalt.
- Scrollen Sie nach unten zum Log-Viewer, um die rohe Protokolldatei zu sehen und nach dem Kontext bestimmter Einträge zu suchen.
- Passen Sie das Feld Zeilen an, wenn Sie mehr Verlauf sehen möchten, und klicken Sie dann auf Neu laden.
Häufige Protokollmuster, auf die Sie achten sollten
| Protokollmuster | Bedeutung |
|---|---|
[ERROR] mit "connection" oder "token" | API-Verbindungs- oder Authentifizierungsfehler |
[ERROR] mit "image" | Ein Bild-Download ist fehlgeschlagen |
[WARNING] mit "lock" | Ein Import wurde übersprungen, weil ein anderer Lauf noch aktiv war |
[INFO] mit "skipped" | Fahrzeuge wurden übersprungen, da sich ihre Daten nicht geändert haben (normales Verhalten) |
[INFO] mit "deleted" | Fahrzeuge wurden durch den Full Sync entfernt (überprüfen, falls unerwartet) |
Wenn Sie Fehler feststellen, die sich durch Überprüfung der Einstellungen nicht beheben lassen, exportieren Sie die Diagnosedatei über den Tab Tools und kontaktieren Sie den Support.
Arbeitsablauf 3: Leads überprüfen und verarbeiten
Führen Sie diese Prüfung täglich oder in einer für Ihr Anfragevolumen angemessenen Häufigkeit durch.
Schritte
- Navigieren Sie zu ADP Car Market Hub → Leads.
- Überprüfen Sie die Liste der Leads. Neue Leads haben den Status Neu.
- Für jeden neuen Lead: - Überprüfen Sie den Kundennamen, die E-Mail-Adresse, die Telefonnummer und die Nachricht. - Notieren Sie, auf welches Fahrzeug sich die Anfrage bezieht. Die Inseratsreferenz verlinkt auf die AutoScout24-Detailseite, sofern verfügbar. - Kontaktieren Sie den Kunden über Ihren normalen Verkaufsprozess. - Nachdem Sie den Kunden kontaktiert haben, ändern Sie den Lead-Status auf Kontaktiert. - Nach Abschluss der Verkaufsinteraktion ändern Sie den Status je nach Bedarf auf Geschlossen oder Spam.
- Wenn Sie Leads mit einem anderen System teilen müssen (z. B. einem CRM), klicken Sie auf CSV exportieren, um alle derzeit sichtbaren Leads als CSV-Datei herunterzuladen. Wenden Sie zuerst Suchfilter an, wenn Sie nur eine Teilmenge exportieren möchten.
- Löschen Sie Leads, die als Spam bestätigt wurden oder nicht mehr benötigt werden, um die Liste übersichtlich zu halten.
Hinweise
- Änderungen des Lead-Status werden sofort gespeichert, wenn Sie einen neuen Status auswählen.
- Der CSV-Export umfasst alle Leads, die dem aktuellen Such-/Filterstatus entsprechen, oder alle Leads, wenn kein Filter aktiv ist.
- Leads werden als WordPress-Beiträge gespeichert. Sie werden nicht automatisch an externe Systeme weitergeleitet, es sei denn, Sie haben separat einen Webhook oder eine Integration konfiguriert.
- Probefahrtanfragen, die über die Probefahrt-Funktion gesendet werden, werden ebenfalls als Leads erfasst, sofern die Probefahrt-Funktion aktiviert ist.
Arbeitsablauf 4: Systemzustand und Cron-Status überprüfen
Führen Sie diese Prüfung wöchentlich durch, oder sofort nach einem vermuteten Planungsfehler.
Schritte
- Navigieren Sie zu ADP Car Market Hub → System & Help.
- Überprüfen Sie die Indikatoren der Umgebungsprüfung: - PHP-Version – muss 8.1 oder höher sein. - Memory Limit – 256 MB oder mehr wird empfohlen. - Maximale Ausführungszeit – 60 Sekunden oder mehr wird empfohlen. - Uploads-Verzeichnis – muss für Bildimporte beschreibbar sein. - cURL und OpenSSL – müssen für API-Aufrufe vorhanden sein. - GD oder Imagick – erforderlich, wenn die WebP-Konvertierung aktiviert ist.
- Überprüfen Sie den Indikator Cron-Zeitplan-Status: - Bei Verwendung von WP-Cron zeigt dies an, ob ein geplantes Ereignis registriert ist und wann der nächste Lauf erwartet wird. - Bei Verwendung des Server-Crons bestätigen Sie, dass Ihr externer Cronjob separat konfiguriert ist und läuft.
- Überprüfen Sie den Status der Bildwarteschlange: - Eine kleine Warteschlangengrösse (0–50) ist normal. - Eine Warteschlangengrösse über 1'000 löst ein Warnsymbol aus. Dies kann darauf hindeuten, dass der Bildwarteschlangen-Worker nicht läuft oder im Rückstand ist. - Wenn die Warteschlange gross ist, verwenden Sie die Schaltfläche Bildwarteschlange jetzt ausführen, um sie sofort abzuarbeiten.
- Überprüfen Sie das Ergebnis des API-Verbindungstests. Klicken Sie auf die Test-Schaltfläche, falls verfügbar, um zu bestätigen, dass die API mit den aktuellen Zugangsdaten erreichbar ist.
- Wenn sich ein Indikator in einem Warnzustand (gelb) oder Fehlerzustand (rot) befindet, lesen Sie den entsprechenden Abschnitt im Administrator-Handbuch oder den Abschnitt zur Fehlerbehebung weiter unten.
Arbeitsablauf 5: Frontend-Bestand validieren
Führen Sie diese Prüfung nach jedem grösseren Importlauf oder wöchentlich im normalen Betrieb durch.
Schritte
- Öffnen Sie die Fahrzeug-Archivseite Ihrer Website in einem Browser (nicht im WordPress-Admin angemeldet, oder in einem privaten/Inkognito-Fenster, um die öffentliche Ansicht zu sehen).
- Überprüfen Sie, ob die Fahrzeuge im Archiv-Raster mit Bildern, Titeln, Preisen und wichtigen Spezifikationen angezeigt werden.
- Wenden Sie ein oder mehrere Filter-Steuerelemente an (z. B. Filterung nach Marke oder Treibstoffart) und bestätigen Sie, dass die Ergebnisse korrekt aktualisiert werden.
- Klicken Sie auf ein einzelnes Fahrzeug, um dessen Detailseite zu öffnen.
- Überprüfen Sie, ob die Detailseite Folgendes anzeigt: - Mindestens ein Bild (oder die Bildergalerie, wenn mehrere Bilder importiert wurden). - Die Tabelle mit den Fahrzeugspezifikationen (Marke, Modell, Jahr, Kilometerstand, Preis, Motor usw.). - Die Ausstattungsliste (falls zutreffend). - Die Fahrzeugbeschreibung. - Das Kontaktformular. - Den Finanzierungsrechner (falls aktiviert). - Das Probefahrtformular (falls aktiviert).
- Senden Sie eine Testanfrage über das Kontaktformular und bestätigen Sie: - Die Dankesbestätigung wird auf der Seite angezeigt. - Ein Lead erscheint innerhalb weniger Sekunden unter ADP Car Market Hub → Leads. - Die Benachrichtigungs-E-Mail geht an die konfigurierte Empfängeradresse ein (sofern der E-Mail-Versand auf Ihrem Server funktioniert).
- Wenn Fahrzeuge im Archiv fehlen oder die Detailseite unvollständig ist, überprüfen Sie den Tab "Logs" auf Fehler und verifizieren Sie den Beitragsstatus des Fahrzeugs unter CMH Cars → All Cars.
Beitragsstatus des Fahrzeugs überprüfen
- Navigieren Sie in der WordPress-Admin-Seitenleiste zu CMH Cars → All Cars.
- Suchen Sie nach dem spezifischen Fahrzeugtitel oder verwenden Sie die Status-Links (Alle / Veröffentlicht / Entwurf) über der Liste.
- Bestätigen Sie, dass der Beitrag veröffentlicht ist (Status: Veröffentlicht).
- Wenn sich der Beitrag im Status Entwurf befindet, veröffentlichen Sie ihn entweder manuell oder ändern Sie den Standard-Beitragsstatus in den Einstellungen für zukünftige Importe auf
publish.
Arbeitsablauf 6: Manuellen Import auslösen
Verwenden Sie diesen Arbeitsablauf, wenn Sie den Bestand ausserhalb des automatischen Zeitplans sofort aktualisieren müssen, beispielsweise nachdem Sie neue Fahrzeuge zu Ihrem AutoScout24-Konto hinzugefügt haben.
Schritte
- Navigieren Sie zu ADP Car Market Hub → Import & Limits.
- Klicken Sie auf die Schaltfläche Jetzt auslösen, um sofort einen Importlauf zu starten.
- Für einen vollständigen Import mit Fortschrittsüberwachung verwenden Sie den Batch-Wizard: - Der Fortschrittsbalken zeigt die verarbeiteten Fahrzeuge, die geschätzte verbleibende Zeit und die aktuelle Aktion an. - Sie können den Assistenten jederzeit pausieren, fortsetzen oder abbrechen.
- Nach Abschluss des Imports überprüfen Sie die Statuszusammenfassung auf die Anzahl der hinzugefügten, aktualisierten oder übersprungenen Fahrzeuge.
- Überprüfen Sie die Ergebnisse, indem Sie das Dashboard und die Archivseite im Frontend kontrollieren.
Hinweise
- Manuelle Auslöser und der automatische Cron-Planer teilen sich dieselbe Importsperre. Wenn bereits ein geplanter Lauf aktiv ist, während Sie auf Jetzt auslösen klicken, wird der manuelle Auslöser übersprungen.
- Über den Batch-Wizard gestartete Importläufe verarbeiten standardmässig ein Fahrzeug nach dem anderen. Dies verhindert Timeout-Fehler auf Servern mit restriktiven Ausführungszeitlimiten.
Arbeitsablauf 7: Fahrzeuge mit Qualitätsproblemen prüfen
Führen Sie diese Prüfung regelmässig durch, um die Qualität des Bestands aufrechtzuerhalten.
Schritte
- Navigieren Sie zu ADP Car Market Hub → Dashboard.
- Überprüfen Sie den Bereich Fahrzeug-Bereitschaft, der Folgendes hervorhebt: - Fahrzeuge ohne Bilder. - Fahrzeuge mit ungewöhnlich kurzen Beschreibungen.
- Klicken Sie bei jedem betroffenen Fahrzeug auf den einzelnen Fahrzeugbeitrag, um die Ursache zu untersuchen.
- Wenn Bilder fehlen: - Prüfen Sie, ob die Bildwarteschlange einen Rückstau aufweist (System & Help → Status der Bildwarteschlange). - Führen Sie die Bildwarteschlange bei Bedarf manuell aus. - Überprüfen Sie den Tab "Logs" auf Bild-Download-Fehler.
- Wenn Beschreibungen kurz sind oder fehlen: - Überprüfen Sie das Originalinserat auf AutoScout24. - Wenn der AI Assistant aktiviert ist, verwenden Sie ihn, um eine Beschreibung für das Fahrzeug zu generieren. - Alternativ können Sie den Fahrzeugbeitrag manuell bearbeiten, um die Beschreibung hinzuzufügen oder zu verbessern.
Betriebliche Hinweise
- Dashboard-Caching: Dashboard-Daten werden für ca. 3 Minuten zwischengespeichert. Laden Sie die Seite neu, um nach einem Import die aktuellsten Daten zu sehen.
- Änderungserkennung: Der Importer verwendet Inhalts- und Bild-Hashes, um unveränderte Fahrzeuge zu überspringen. Eine hohe Anzahl von "übersprungenen" Einträgen im Protokoll ist normal und bedeutet, dass der Import effizient arbeitet.
- Mehrere Seller IDs: Wenn mehrere Seller IDs konfiguriert sind, läuft der Import nacheinander für jeden Verkäufer. Fehler bei einem Verkäufer blockieren die Importe für andere Verkäufer nicht.
- Ausführlichkeit des Importprotokolls: Die ausführliche Protokollierung schreibt, sofern aktiviert, sehr detaillierte Einträge pro Fahrzeug in das Protokoll. Dies ist nützlich für die Fehlersuche, erhöht jedoch die Protokollgrösse. Deaktivieren Sie diese Option im normalen Betrieb.
Fehlerbehebung
| Symptom | Wahrscheinliche Ursache | Überprüfung |
|---|---|---|
| Import lief, aber die Anzahl der Fahrzeuge hat sich nicht geändert | Alle Fahrzeuge waren unverändert (keine Datenaktualisierungen auf AutoScout24) | Normal. Überprüfen Sie die Protokolle auf "übersprungene" Einträge. |
| Import lief, aber einige Fahrzeuge fehlen | Standard-Beitragsstatus ist draft oder die Fahrzeuge wurden aus AutoScout24 entfernt | Beitragsstatus in den Einstellungen prüfen; prüfen, ob die Vollsynchronisation aktiviert ist |
| Lead erhalten, aber keine E-Mail-Benachrichtigung | WordPress E-Mail-Zustellung ist nicht konfiguriert oder defekt | Testen Sie wp_mail(); prüfen Sie dies mit dem Hosting-Anbieter oder installieren Sie ein SMTP-Plugin |
| Bildwarteschlange wächst, nimmt aber nicht ab | Der Worker für die Bildwarteschlange (WP-Cron-Hook) wird nicht ausgelöst | Cron-Status prüfen; "Bildwarteschlange jetzt ausführen" als manuellen Workaround verwenden |
| Cron-Zeitplan wird als "nicht geplant" angezeigt | Das WP-Cron-Ereignis wurde gelöscht (Deaktivierung/Reaktivierung setzt es zurück) | Deaktivieren und reaktivieren Sie das Plugin; oder wechseln Sie zum Server-Cron |
| Frontend zeigt nach dem Import keine Fahrzeuge an | Standard-Beitragsstatus ist draft | Fahrzeuge manuell veröffentlichen oder den Standardstatus auf publish ändern |
| Einsendungen des Kontaktformulars erstellen keine Leads | Kontaktformular erreicht den Server nicht (AJAX-Fehler, Weiterleitungsproblem) | Überprüfen Sie die Browser-Konsole auf Fehler; stellen Sie sicher, dass die Formular-Aktions-URL korrekt ist |