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 Durchsicht 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 eine 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 aktualisierte Fahrzeugdaten von der verbundenen Live-Quelle (der AutoScout24-API, mobile.de oder carcuro) im zentralen Intervall ab, lädt Bilder in einer Hintergrund-Warteschlange herunter und hält den WordPress-Bestand mit dem Live-Inserat synchron.

Das Betriebspersonal sollte jedoch regelmässig überprüfen, ob:

  1. Importläufe erfolgreich abgeschlossen werden.
  2. Neue und aktualisierte Fahrzeuge im Frontend sichtbar sind.
  3. Kundenanfragen (Leids) empfangen und verarbeitet werden.
  4. Das Plugin-Log keine ungelösten Fehler enthält.
  5. 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

  1. Melden Sie sich im WordPress-Admin-Dashboard an.
  2. Navigieren Sie zu CMH Center → Dashboard.
  3. Überprüfen Sie die KPI-Zeile: - Prüfen Sie Fahrzeuge total, um zu bestätigen, dass die Bestandszahl den Erwartungen entspricht. - Prüfen Sie Neu (letzte 7 Tage), um zu sehen, wie viele Fahrzeuge kürzlich hinzugefügt wurden.
  4. Überprüfen Sie das Diagramm Bestandstrend, um zu bestätigen, dass die Importläufe in der vergangenen Woche Ergebnisse geliefert haben.
  5. Überprüfen Sie den Bereich Handlungsbedarf auf behebbare Probleme, wie z. B. Fahrzeuge ohne Bilder oder Kurzbeschreibungen.
  6. Navigieren Sie zu CMH Center → Import & Limits.
  7. Ü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.
  8. Wenn die letzte Laufzeit unerwartet alt erscheint (z. B. mehr als 24 Stunden her bei einem stündlichen Zeitplan), überprüfen Sie, ob der Cron-Job läuft. Siehe den Arbeitsablauf Checking the cron status 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-Log überprüfen

Führen Sie diese Prüfung täglich durch oder sofort, wenn ein vermuteter Importfehler auftritt.

Schritte

  1. Navigieren Sie zu CMH Center → Logs.
  2. Überprüfen Sie das Panel Kürzliche Fehler oben auf der Seite. Dies zeigt die neuesten Log-Einträge mit dem Status "Error" aus den letzten 2'000 Zeilen der Log-Datei.
  3. Überprüfen Sie das Panel Kürzliche Warnungen auf unkritische Probleme, die dennoch Aufmerksamkeit erfordern könnten.
  4. Wenn Fehler oder Warnungen vorhanden sind, notieren Sie deren Zeitstempel und Inhalt.
  5. Scrollen Sie nach unten zum Log-Viewer, um die rohe Log-Datei zu sehen und nach dem Kontext bestimmter Einträge zu suchen.
  6. Passen Sie das Feld Zeilen an, wenn Sie mehr Verlauf sehen möchten, und klicken Sie dann auf Neu laden.

Häufige Log-Muster, auf die Sie achten sollten

Log-MusterBedeutung
[ERROR] mit "connection" oder "token"API-Verbindungs- oder Authentifizierungsfehler
[ERROR] mit "image"Ein Bild-Download ist fehlgeschlagen
[WARNING] mit "lock"Ein Import wurde übersprungen, da 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 Diagnose-Datei aus dem Tab Tools und kontaktieren Sie den Support.


Arbeitsablauf 3: Leads überprüfen und bearbeiten

Führen Sie diese Prüfung täglich oder in einer für Ihr Anfragevolumen angemessenen Häufigkeit durch.

Schritte

  1. Navigieren Sie zu CMH Center → Leads.
  2. Überprüfen Sie die Liste der Leads. Neue Leads haben den Status Neu.
  3. 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.
  4. Wenn Sie Leads mit einem anderen System teilen müssen (z. B. einem CRM), klicken Sie auf CSV exportieren, um alle aktuell sichtbaren Leads als CSV-Datei herunterzuladen. Wenden Sie zuerst Suchfilter an, wenn Sie nur eine Teilmenge exportieren möchten.
  5. 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.
  • Probefahrt-Anfragen, die über die Probefahrt-Funktion gesendet werden, werden ebenfalls als Leads erfasst, sofern die Probefahrt-Funktion aktiviert ist.


Arbeitsablauf 4: Systemstatus und Cron-Status überprüfen

Führen Sie diese Prüfung wöchentlich oder sofort nach einem vermuteten Planungsfehler durch.

Schritte

  1. Navigieren Sie zu CMH Center → System & Help.
  2. Überprüfen Sie die Indikatoren der Umgebungsprüfung: - PHP-Version – muss 8.1 oder neuer sein. - Memory Limit – 256 MB oder mehr wird empfohlen. - Maximale Ausführungszeit (Maximum execution time) – 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.
  3. Überprüfen Sie den Indikator Cron-Zeitplan-Status: - Bei Verwendung von WP-Cron zeigt dies an, ob ein geplantes Ereignis registriert ist und wann die nächste Ausführung erwartet wird. - Bei Verwendung eines Server-Crons bestätigen Sie, dass Ihr externer Cron-Job konfiguriert ist und separat läuft.
  4. Überprüfen Sie den Bildwarteschlangen-Status: - 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.
  5. Überprüfen Sie das Ergebnis des API-Verbindungstests. Klicken Sie auf die Testschaltfläche, falls verfügbar, um zu bestätigen, dass die API mit den aktuellen Zugangsdaten erreichbar ist.
  6. Wenn ein Indikator einen Warn- (gelb) oder Fehlerstatus (rot) anzeigt, lesen Sie den entsprechenden Abschnitt im Administrator-Handbuch oder den Abschnitt zur Fehlerbehebung weiter unten.

Arbeitsablauf 5: Validierung des Frontend-Bestands

Führen Sie diese Prüfung nach jedem grösseren Importlauf oder wöchentlich im normalen Betrieb durch.

Schritte

  1. Ö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).
  2. Überprüfen Sie, ob die Fahrzeuge im Archiv-Raster mit Bildern, Titeln, Preisen und wichtigen Spezifikationen angezeigt werden.
  3. Wenden Sie ein oder mehrere Filter-Steuerelemente an (z. B. Filterung nach Marke oder Kraftstofftyp) und bestätigen Sie, dass die Ergebnisse korrekt aktualisiert werden.
  4. Klicken Sie auf ein einzelnes Fahrzeug, um dessen Detailseite zu öffnen.
  5. Überprüfen Sie, ob die Detailseite Folgendes anzeigt: - Mindestens ein Bild (oder die Bildergalerie, falls mehrere Bilder importiert wurden). - Die Fahrzeug-Spezifikationstabelle (Marke, Modell, Jahr, Kilometerstand, Preis, Motor usw.). - Die Ausstattungsliste (falls zutreffend). - Die Fahrzeugbeschreibung. - Das Kontaktformular. - Den Finanzierungsrechner (falls aktiviert). - Das Probefahrt-Formular (falls aktiviert).
  6. Senden Sie ein Test-Kontaktformular ab und bestätigen Sie: - Die Dankesbestätigung wird auf der Seite angezeigt. - Ein Lead erscheint innerhalb weniger Sekunden unter CMH Center → Leads. - Die Benachrichtigungs-E-Mail geht bei der konfigurierten Empfängeradresse ein (sofern der E-Mail-Versand auf Ihrem Server funktioniert).
  7. 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.

Fahrzeug-Beitragsstatus überprüfen

  1. Navigieren Sie zu CMH Cars → All Cars in der WordPress-Admin-Seitenleiste.
  2. Suchen Sie nach dem spezifischen Fahrzeugtitel oder verwenden Sie die Status-Links (Alle / Veröffentlicht / Entwurf) über der Liste.
  3. Bestätigen Sie, dass der Beitrag veröffentlicht ist (Status: Veröffentlicht).
  4. Wenn sich der Beitrag im Status Entwurf befindet, veröffentlichen Sie ihn entweder manuell oder ändern Sie den Standard-Beitragsstatus unter Import & Limits → Import Defaults auf publish für zukünftige Importe.

Arbeitsablauf 6: Manuellen Import auslösen

Verwenden Sie diesen Arbeitsablauf, wenn Sie den Bestand ausserhalb des automatischen Zeitplans sofort aktualisieren müssen, beispielsweise nach dem Hinzufügen neuer Fahrzeuge zu Ihrem AutoScout24-Konto.

Schritte

  1. Navigieren Sie zu CMH Center → Import & Limits.
  2. Klicken Sie auf die Schaltfläche Import jetzt starten, um einen sofortigen Importlauf zu starten.
  3. 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.
  4. Nach Abschluss des Imports überprüfen Sie die Statuszusammenfassung auf die Anzahl der hinzugefügten, aktualisierten oder übersprungenen Fahrzeuge.
  5. Überprüfen Sie die Ergebnisse, indem Sie das Dashboard und die Frontend-Archivseite kontrollieren.

Hinweise

  • Manuelle Auslöser und der automatische Cron-Zeitplan teilen sich dieselbe Importsperre. Wenn bereits ein geplanter Lauf aktiv ist, während Sie auf Import jetzt starten klicken, wird der manuelle Auslöser übersprungen.
  • Über den Batch-Wizard initiierte Importläufe verarbeiten standardmässig ein Fahrzeug nach dem anderen. Dies verhindert Timeout-Fehler auf Servern mit restriktiven Ausführungszeitlimits.

Arbeitsablauf 7: Prüfung auf Fahrzeuge mit Qualitätsproblemen

Führen Sie diese Prüfung regelmässig durch, um die Qualität des Bestands aufrechtzuerhalten.

Schritte

  1. Navigieren Sie zu CMH Center → Dashboard.
  2. Überprüfen Sie den Bereich Fahrzeug-Bereitschaft, der Folgendes hervorhebt: - Fahrzeuge ohne Bilder. - Fahrzeuge mit ungewöhnlich kurzen Beschreibungen.
  3. Klicken Sie bei jedem betroffenen Fahrzeug auf den einzelnen Fahrzeugbeitrag, um die Ursache zu untersuchen.
  4. Wenn Bilder fehlen: - Prüfen Sie, ob die Bildwarteschlange einen Rückstau aufweist (System & Help → Bildwarteschlangen-Status). - Führen Sie die Bildwarteschlange bei Bedarf manuell aus. - Überprüfen Sie den Tab "Logs" auf Fehler beim Herunterladen von Bildern.
  5. Wenn Beschreibungen kurz sind oder fehlen: - Überprüfen Sie das Original-Inserat 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 nach einem Import neu, um 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 Log 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 jede Garage ab. Fehler bei einer Garage blockieren die Importe für andere Garagen nicht.
  • Ausführlichkeit des Import-Logs: Die ausführliche Protokollierung schreibt, sofern aktiviert, sehr detaillierte Einträge pro Fahrzeug in das Log. Dies ist nützlich für die Fehlersuche, erhöht jedoch die Log-Grösse. Deaktivieren Sie sie im normalen Betrieb.


Fehlerbehebung

SymptomWahrscheinliche UrsacheÜberprüfung
Import wurde ausgeführt, aber die Anzahl der Fahrzeuge hat sich nicht geändertAlle Fahrzeuge waren unverändert (keine Datenaktualisierungen auf AutoScout24)Normal. Überprüfen Sie die Logs auf "übersprungene" Einträge.
Import wurde ausgeführt, aber einige Fahrzeuge fehlenDer Standard-Beitragsstatus ist draft, oder die Fahrzeuge wurden an der Live-Quelle entfernt (AutoScout24, mobile.de oder carcuro)Überprüfen Sie den Beitragsstatus unter Import & Limits → Import-Standardwerte; prüfen Sie, ob die Vollsynchronisation aktiviert ist
Lead erhalten, aber keine E-Mail-BenachrichtigungDer E-Mail-Versand über WordPress ist nicht konfiguriert oder fehlerhaftTesten Sie wp_mail(); prüfen Sie dies mit Ihrem Hosting-Anbieter oder installieren Sie ein SMTP-Plugin
Warteschlange für Bilder wächst, nimmt aber nicht abDer Image-Queue-Worker (WP-Cron-Hook) wird nicht ausgelöstÜberprüfen Sie den Cron-Status; nutzen Sie "Bild-Warteschlange jetzt ausführen" als manuellen Workaround
Cron-Zeitplan wird als "nicht geplant" angezeigtDas 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 anDer Standard-Beitragsstatus ist draftVeröffentlichen Sie Fahrzeuge manuell oder ändern Sie den Standardstatus auf publish
Übermittlungen des Kontaktformulars erstellen keine LeadsDas 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

Verwandte Dokumente