Dokumentation · Benutzerhandbuch

Tägliche Arbeitsabläufe

Dieses Dokument beschreibt die betrieblichen Arbeitsabläufe, die Administratoren und Autohaus-Mitarbeiter regelmäßig 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 und wo Sie suchen müssen, wenn etwas nicht in Ordnung zu sein scheint.

Für eine vollständige Konfigurations- und Einrichtungsanleitung siehe 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äßig überprüfen, ob:

  1. Die Importläufe erfolgreich abgeschlossen werden.
  2. Neue und aktualisierte Fahrzeuge im Frontend sichtbar sind.
  3. Kunden-Leads empfangen und verarbeitet werden.
  4. Das Plugin-Protokoll keine ungelösten Fehler enthält.
  5. Die Bildwarteschlange keinen nennenswerten Rückstau ansammelt.

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 ADP Car Market Hub → Dashboard.
  3. Überprüfen Sie die KPI-Zeile: - Prüfen Sie Fahrzeuge gesamt, 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 alle behebbaren Probleme, wie z. B. Fahrzeuge ohne Bilder oder Kurzbeschreibungen.
  6. Navigieren Sie zu ADP Car Market Hub → 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 fehlerfrei abgeschlossen wurde.
  8. 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-Job 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 Fehlerhinweise 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

  1. Navigieren Sie zu ADP Car Market Hub → Logs.
  2. Überprüfen Sie den Bereich Kürzliche Fehler oben auf der Seite. Dieser zeigt die neuesten Protokolleinträge mit Fehler-Status aus den letzten 2.000 Zeilen der Protokolldatei.
  3. Überprüfen Sie den Bereich 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 Protokolldatei zu sehen und nach dem Kontext bestimmter Einträge zu suchen.
  6. Passen Sie das Feld Zeilen an, wenn Sie mehr Historie sehen möchten, und klicken Sie dann auf Neu laden.

Häufige Protokollmuster, auf die Sie achten sollten

ProtokollmusterBedeutung
[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 nicht durch Überprüfen der Einstellungen behoben werden können, exportieren Sie die Diagnose-Datei aus dem 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

  1. Navigieren Sie zu ADP Car Market Hub → 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 Vertriebsprozess. - Nachdem Sie den Kunden kontaktiert haben, ändern Sie den Lead-Status auf Kontaktiert. - Nach Abschluss der Verkaufsinteraktion ändern Sie den Status entsprechend 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 derzeit 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: Systemgesundheit und Cron-Status überprüfen

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

Schritte

  1. Navigieren Sie zu ADP Car Market Hub → System & Help.
  2. Überprüfen Sie die Indikatoren der Umgebung-Prü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 Bild-Importe 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 der nächste Lauf erwartet wird. - Bei Verwendung eines Server-Crons bestätigen Sie, dass Ihr externer Cron-Job separat konfiguriert ist und ausgeführt wird.
  4. Überprüfen Sie den Status der Bildwarteschlange: - Eine kleine Warteschlangengröße (0–50) ist normal. - Eine Warteschlangengröße ü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 groß 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 Test-Schaltfläche, falls verfügbar, um zu bestätigen, dass die API mit den aktuellen Zugangsdaten erreichbar ist.
  6. Wenn sich ein Indikator in einem Warn- (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ößeren Importlauf oder wöchentlich im normalen Betrieb durch.

Schritte

  1. Öffnen Sie die Fahrzeug-Archivseite Ihrer Website in einem Browser (nicht als 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 Kraftstoffart) 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, 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. - Der Finanzierungsrechner (falls aktiviert). - Das Probefahrt-Formular (falls aktiviert).
  6. Senden Sie eine Test-Anfrage ü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 (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 in der WordPress-Admin-Seitenleiste zu CMH Cars → All Cars.
  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 in den Einstellungen für zukünftige Importe auf publish.

Arbeitsablauf 6: Manuellen Import auslösen

Verwenden Sie diesen Arbeitsablauf, wenn Sie den Bestand außerhalb des automatischen Zeitplans sofort aktualisieren müssen, beispielsweise nachdem Sie neue Fahrzeuge zu Ihrem AutoScout24-Konto hinzugefügt haben.

Schritte

  1. Navigieren Sie zu ADP Car Market Hub → Import & Limits.
  2. Klicken Sie auf die Schaltfläche Jetzt auslösen, um sofort einen 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 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 initiierte Importläufe verarbeiten standardmäßig ein Fahrzeug nach dem anderen. Dies verhindert Timeout-Fehler auf Servern mit restriktiven Ausführungszeitlimits.

Arbeitsablauf 7: Fahrzeuge mit Qualitätsproblemen prüfen

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

Schritte

  1. Navigieren Sie zu ADP Car Market Hub → 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 → Status der Bildwarteschlange). - Führen Sie die Bildwarteschlange bei Bedarf manuell aus. - Überprüfen Sie den Tab „Logs“ auf Bild-Download-Fehler.
  5. Wenn Beschreibungen kurz sind oder fehlen: - Überprüfen Sie das Original-Inserat auf AutoScout24. - Wenn der KI-Assistent 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 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 nicht die Importe für andere Verkäufer.
  • Ausführlichkeit des Import-Protokolls: 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öße. Deaktivieren Sie diese Option im normalen Betrieb.


Fehlerbehebung

SymptomWahrscheinliche UrsacheÜberprüfung
Import wurde ausgeführt, aber die Fahrzeuganzahl hat sich nicht geändertAlle Fahrzeuge waren unverändert (keine Datenaktualisierungen auf AutoScout24)Normal. Überprüfen Sie die Protokolle auf "übersprungene" Einträge.
Import wurde ausgeführt, aber einige Fahrzeuge fehlenStandard-Beitragsstatus ist draft oder die Fahrzeuge wurden aus AutoScout24 entferntÜberprüfen Sie den Beitragsstatus in den Einstellungen; prüfen Sie, ob die Vollsynchronisierung aktiviert ist
Lead erhalten, aber keine E-Mail-BenachrichtigungWordPress E-Mail-Zustellung ist nicht konfiguriert oder fehlerhaftTesten Sie wp_mail(); wenden Sie sich an Ihren Hosting-Anbieter oder installieren Sie ein SMTP-Plugin
Bildwarteschlange wächst, nimmt aber nicht abDer Worker für die Bildwarteschlange (WP-Cron-Hook) wird nicht ausgelöstÜberprüfen Sie den Cron-Status; nutzen Sie "Bildwarteschlange 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 anStandard-Beitragsstatus ist draftVeröffentlichen Sie Fahrzeuge manuell oder ändern Sie den Standardstatus auf publish
Einsendungen 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

Zugehörige Dokumente