Dokumentation · Betrieb und Wartung

Täglicher Betrieb

Dieses Dokument beschreibt die routinemässigen täglichen Kontrollen, die ein Website-Administrator oder ein Garagen-Manager durchführen sollte, um sicherzustellen, dass das ADP Car Market Hub-Plugin auf einer produktiven WordPress-Website ordnungsgemäss funktioniert.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn Sie für den täglichen Betrieb einer Live-Website verantwortlich sind, die das Plugin verwendet, um Fahrzeugangebote von AutoScout24 zu importieren und anzuzeigen. Diese Kontrollen sind so konzipiert, dass sie schnell durchgeführt werden können und Probleme abfangen, bevor sie sich auf Besucher oder Leads auswirken.

Übersicht

Das Plugin führt Importaufträge automatisch über WP-Cron oder einen externen Server-Cron aus, lädt Fahrzeugbilder asynchron über eine Bild-Queue herunter und speichert Besucherereignisse sowie Kundenanfragen in der WordPress-Datenbank. Die täglichen Kontrollen stellen sicher, dass diese Hintergrundprozesse wie erwartet laufen und sich keine Fehler angesammelt haben.

Das WordPress-Admin-Panel bietet einen Dashboard-Tab und einen Logs-Tab, die die relevantesten Betriebsdaten an einem Ort zusammenführen.

Anforderungen

  • Administrator-Konto mit der Berechtigung manage_as24_imports, die WordPress-Administratoren bei der Plugin-Aktivierung erteilt wird.
  • Zugriff auf WordPress Admin → ADP Car Market Hub (das Plugin-Admin-Menü).

Tägliche Kontrollen

1. Letzten Importlauf bestätigen

  1. Öffnen Sie ADP Car Market Hub → Dashboard.
  2. Suchen Sie die KPI-Zeile. Sie zeigt die Gesamtzahl der importierten Fahrzeuge, die in den letzten sieben Tagen neu hinzugefügten Fahrzeuge und den Zeitstempel des letzten Importlaufs an.
  3. Überprüfen Sie, ob der Zeitstempel des letzten Imports dem erwarteten Zeitplan entspricht. Wenn der Import seit dem letzten erwarteten Intervall nicht ausgeführt wurde, überprüfen Sie die Automatisierungseinstellungen oder die Cron-Konfiguration.
  4. Für weitere Details öffnen Sie ADP Car Market Hub → Import & Limits und überprüfen Sie die Zeit unter Letzter Lauf sowie den Status des letzten Laufs (eingefügt, aktualisiert, übersprungen, Fehler).

2. Auf Importfehler prüfen

  1. Öffnen Sie ADP Car Market Hub → Logs.
  2. Das Panel Kürzliche Fehler zeigt die neuesten Einträge mit dem Status "Error" aus der aktuellen Log-Datei. Falls Fehler vorhanden sind, lesen Sie diese und untersuchen Sie die Ursache.
  3. Das Panel Kürzliche Warnungen zeigt Einträge mit dem Status "Warning", die auf einen eingeschränkten Betrieb hinweisen können (z. B. teilweise Bildfehler oder API-Rate-Limit-Antworten).
  4. Ein leeres Fehler-Panel ist der erwartete fehlerfreie Zustand.

3. Neue Leads überprüfen

  1. Öffnen Sie ADP Car Market Hub → Leads (oder navigieren Sie zum Leads-Tab im Plugin-Admin-Bereich).
  2. Überprüfen Sie alle Leads mit dem Status Neu, die seit dem Vortag eingegangen sind.
  3. Weisen Sie bearbeiteten Leads einen Status zu (Kontaktiert, Geschlossen oder Spam), damit die Warteschlange übersichtlich bleibt.
  4. Überprüfen Sie, ob die Lead-Benachrichtigungs-E-Mails zugestellt wurden, indem Sie den Posteingang der konfigurierten Empfängeradresse prüfen. Der Empfänger wird unter Einstellungen → Lead-Empfänger-E-Mail festgelegt.

4. Bild-Queue überprüfen

  1. Öffnen Sie ADP Car Market Hub → System & Help.
  2. Suchen Sie den Bereich für die Bild-Queue. Wenn die Bild-Queue aktiviert ist, werden die verbleibenden Bilder nach jedem Import asynchron verarbeitet. Ein kleiner Rückstau in der Warteschlange ist normal. Ein sehr grosser oder stagnierender Rückstau (der Tab "System & Help" zeigt eine Warnung an, wenn die Warteschlange den konfigurierten Schwellenwert überschreitet) kann darauf hindeuten, dass der Cron-Hook für die Bild-Queue nicht ausgelöst wird.
  3. Wenn die Warteschlangengrösse unerwartet hoch ist, verwenden Sie die Schaltfläche Bild-Queue jetzt auslösen im Tab "Import & Limits", um sie manuell zu verarbeiten, und überprüfen Sie anschliessend die Cron-Einrichtung.

5. API-Verbindung prüfen

  1. Öffnen Sie ADP Car Market Hub → System & Help.
  2. Die Zeile zum Verbindungsstatus bestätigt, ob das Plugin die AutoScout24-API mit den aktuell konfigurierten Zugangsdaten erreichen kann.
  3. Der Status Verbunden mit AutoScout24 – Token gültig und API erreichbar ist der erwartete fehlerfreie Zustand.
  4. Wenn der Status einen Fehler anzeigt, überprüfen Sie die Einstellungen für Client ID, Client Secret und Seller ID unter ADP Car Market Hub → Settings.

Konfigurationsreferenz

EinstellungsortRelevante OptionZweck
Tab "Import & Limits"Auto Import AktiviertAktiviert oder deaktiviert automatische, geplante Importe
Tab "Import & Limits"ZeitplanImportfrequenz (stündlich, alle 6 Stunden, zweimal täglich, täglich oder benutzerdefiniertes Intervall)
Tab "Import & Limits"Max. Fahrzeuge pro DurchlaufBegrenzt die Anzahl der in einem einzelnen Cron-Durchlauf verarbeiteten Fahrzeuge (0 = unbegrenzt)
Tab "Import & Limits"Bild-Queue-ModusWenn aktiviert, wird nur das erste Bild sofort heruntergeladen; die restlichen Bilder werden in die Warteschlange eingereiht
Tab "Settings"Lead-Empfänger-E-MailE-Mail-Adresse für Lead-Benachrichtigungen überschreiben
Tab "Logs"Ausführliche ProtokollierungWenn aktiviert, wird für jedes Fahrzeug und jede Bildaktion eine Zeile protokolliert

Betriebshinweise

  • Das Plugin verwendet eine temporäre Sperre (as24ci_cron_import_running), um überschneidende Importläufe zu verhindern. Wenn ein vorheriger Durchlauf unerwartet abgebrochen wurde, wird die Sperre nach Ablauf ihrer TTL (40 Minuten) automatisch aufgehoben.
  • Die Log-Datei wird im WordPress-Uploads-Verzeichnis unter as24ci-logs/adp-car-market-hub.log gespeichert. Das Verzeichnis ist durch eine .htaccess-Datei und eine stille index.php vor öffentlichem Webzugriff geschützt.
  • Log-Dateien werden automatisch rotiert, wenn sie 10 MB überschreiten. Rotierte Archive werden nach 7 Tagen gelöscht.
  • Die Daten im Dashboard-Tab werden für drei Minuten zwischengespeichert. Wenn Sie gerade einen manuellen Import ausgelöst haben, warten Sie einige Minuten, bevor Sie die Zahlen überprüfen.

Fehlerbehebung

SymptomWahrscheinliche UrsachePrüfung
Letzte Importzeit ist älter als erwartetWP-Cron wird nicht ausgelöst oder Website hat wenig TrafficÜberprüfen Sie den Cron-Modus im Tab "System & Help"; ziehen Sie den Wechsel zu einem Server-Cron in Betracht
Fehler im Log nach einem ImportAPI-Zugangsdaten abgelaufen oder ungültig, oder NetzwerkproblemÜberprüfen Sie den API-Verbindungsstatus im Tab "System & Help"; überprüfen Sie die Zugangsdaten in den Einstellungen
Keine neuen Leads trotz BesucheraktivitätKontaktformular nicht konfiguriert oder E-Mail-Zustellung schlägt fehlTesten Sie das Kontaktformular manuell; überprüfen Sie die Einstellung für die Lead-Empfänger-E-Mail
Bild-Queue wächst, nimmt aber nicht abCron-Hook für die Bild-Queue läuft nichtLösen Sie die Bild-Queue manuell über den Tab "Import & Limits" aus; überprüfen Sie den Server-Cron oder den Zustand von WP-Cron
Dashboard-Zahlen wirken veraltetTemporärer Cache (Transient)Warten Sie drei Minuten, bis der dreiminütige Cache abläuft, und laden Sie die Seite dann neu

Verwandte Dokumente