Referenz für Import und Limits

Dieses Dokument ist eine Referenz für den Bildschirm Import & Limits des ADP Car Market Hub-Plugins (Car Market Hub → Import & Limits). Es behandelt die Trigger-Methode, den automatischen Zeitplan, den manuellen Import-Assistenten, die Einrichtung des Server-Cron-Jobs, Limits für die Bildverarbeitung, Import-Standardwerte und die Option für die Full Sync-Gefahrenzone.

Wann Sie dieses Dokument verwenden sollten

Verwenden Sie diese Referenz, wenn Sie zum ersten Mal automatische Importe einrichten, zwischen WordPress Cron und einem echten Server-Cron-Job wechseln, die Importleistung für große Fahrzeugbestände optimieren oder Full Sync aktivieren, um Fahrzeuge zu entfernen, die offline genommen wurden.

Übersicht

Der Bildschirm ist in die folgenden Karten unterteilt:

1. Aktueller Import-Status — ein dynamischer Zusammenfassungssatz, der angibt, ob automatische Importe aktiv sind (über Server-Cron oder WP-Cron) oder deaktiviert sind, plus vier KPI-Kacheln: Importierte Fahrzeuge, Konfigurierte Händler, Ausstehende Bilder und Fehler beim letzten Durchlauf. Ein Umschalter IDs anzeigen / IDs ausblenden macht die konfigurierten Seller-IDs direkt im Text sichtbar.
2. Letzter Durchlauf + Manueller Import — Metriken des letzten Imports und ein geführter Assistent, um einen Import bei Bedarf zu starten.
3. Automatisierungs-Einstellungen — Wählen Sie die Trigger-Methode (WordPress Cron oder Server-Cron) und konfigurieren Sie den Zeitplan.
4. Einrichtung des Server-Cron-Jobs — nur im Server-Cron-Modus sichtbar; stellt die REST-Trigger-URL, das geheime Token und Beispiel-Cron-Befehle bereit.
5. Bildverarbeitung und Stabilität — Limits pro Durchlauf und Umschalter für die Bild-Warteschlange, um PHP-Timeouts zu vermeiden.
6. Import-Standardwerte — Standardwerte, die auf neu importierte Fahrzeuge angewendet werden, einschließlich Bildern und WebP-Konvertierung.
7. Wiedereinstellungs-Erkennung — erkennt Fahrzeuge, die gelöscht und unter einer neuen AutoScout24 Listing ID (gleiche Fahrgestellnummer/VIN) wieder eingestellt wurden, um Duplikate zu verhindern, die öffentliche URL stabil zu halten und eine Preishistorie zu verfolgen.
8. Gefahrenzone — Full Sync-Umschalter sowie die Option für Soft-Delete / Kulanzzeitraum, die steuert, wie entfernte Fahrzeuge behandelt werden.

Anforderungen oder Voraussetzungen

• Funktionierende API-Zugangsdaten und mindestens eine konfigurierte Seller ID in den Einstellungen.
• Für den Server-Cron-Modus: die Möglichkeit, Cron-Jobs in Ihrer Hosting-Umgebung hinzuzufügen, sowie die Möglichkeit, WordPress REST-URLs vom Server aus aufzurufen.
• Für Full Sync: Ein aktuelles Backup wird dringend empfohlen.

Schritt-für-Schritt-Anleitung

Einen manuellen Import ausführen

1. Öffnen Sie Car Market Hub → Import & Limits.
2. Klicken Sie in der Karte Letzter Durchlauf / Manueller Import auf Import jetzt starten.
3. Der Bereich des Assistenten erscheint und zeigt eine Statusmeldung, einen Fortschrittsbalken, die geschätzte verbleibende Zeit (ETA) und eine Tabelle mit den Zahlen für eingefügte, aktualisierte, übersprungene, fehlerhafte und durch Full Sync gelöschte Fahrzeuge.
4. Verwenden Sie bei Bedarf Pause, Fortsetzen oder Abbrechen. Wenn bei einem späteren Besuch eine pausierte Warteschlange erkannt wird, wird eine Schaltfläche Fortsetzen angezeigt.

Zu WordPress Cron wechseln und automatische Importe planen

1. Wählen Sie in den Automatisierungs-Einstellungen die Option WordPress Cron.
2. Aktivieren Sie Importe automatisch über WordPress Cron ausführen.
3. Wählen Sie eine Import-Häufigkeit aus den verfügbaren WP-Cron-Zeitplänen.
4. Legen Sie für Täglich oder Zweimal täglich eine Startzeit im 24-Stunden-Format HH:MM fest. Für das benutzerdefinierte Intervall legen Sie das Intervall (Minuten, mind. 15) fest.
5. Klicken Sie auf Import & Limits Einstellungen speichern.

Zu Server-Cron wechseln

1. Wählen Sie in den Automatisierungs-Einstellungen die Option Server-Cron. Das Plugin deaktiviert seinen WordPress-Cron-Zeitplan, wenn dieser Modus aktiv ist.
2. Die Karte Einrichtung des Server-Cron-Jobs erscheint mit zwei Schritten: - Schritt 1: Fügen Sie define( 'DISABLE_WP_CRON', true ); zu wp-config.php hinzu. - Schritt 2: Fügen Sie zwei Server-Cron-Jobs hinzu — einen zum Aufrufen der REST-Trigger-URL und einen, um wp-cron.php für die Bildverarbeitung am Laufen zu halten.
3. Wenn noch kein Token existiert, klicken Sie auf Token generieren (im Server-Cron-Modus wird normalerweise automatisch eines erstellt). Kopieren Sie dann die REST-Trigger-URL und das Geheime Token aus der Karte. Kopieren Sie die URL sofort — sie wird nur für etwa 15 Minuten angezeigt, danach wird sie ausgeblendet, bis Sie das Token neu generieren.
4. Verwenden Sie die Beispiel-Cron-Befehle als Ausgangspunkt und passen Sie die Häufigkeit an Ihre Bedürfnisse an.
5. Klicken Sie auf Import & Limits Einstellungen speichern.
6. Um das Geheimnis zu rotieren, klicken Sie auf Token neu generieren und aktualisieren Sie Ihren Server-Cron-Eintrag mit der neuen URL.

Bildverarbeitung für Stabilität konfigurieren

1. Stellen Sie unter Bildverarbeitung und Stabilität die Option Fahrzeuge pro Durchlauf ein (0 bedeutet kein Limit; 50–80 wird für große Kataloge empfohlen).
2. Lassen Sie Bild-Warteschlange aktivieren eingeschaltet, damit nur das erste Bild sofort geladen wird und die restlichen asynchron verarbeitet werden.
3. Speichern.

Standardwerte für neu importierte Fahrzeuge festlegen

1. Wählen Sie unter Import-Standardwerte den Standard-Beitragsstatus (Veröffentlichen oder Entwurf).
2. Wählen Sie optional einen Standard-Beitragsautor; wählen Sie (keep current user), um das bestehende Verhalten beizubehalten.
3. Schalten Sie Bilder importieren um, um zu steuern, ob Bildanhänge heruntergeladen werden sollen.
4. Schalten Sie optional Bilder in WebP konvertieren um und wählen Sie eine WebP-Qualität zwischen 10% und 100% in 5%-Schritten (empfohlen 75–85%).
5. Legen Sie die Maximale Anzahl an Bildern pro Inserat fest (0 = kein Limit), um die Anzahl der pro Fahrzeug heruntergeladenen Bilder zu begrenzen.
6. Speichern.

Wiedereinstellungs-Erkennung aktivieren

1. Öffnen Sie Car Market Hub → Import & Limits und suchen Sie die Karte Wiedereinstellungs-Erkennung.
2. Lassen Sie Wiedereinstellungs-Erkennung aktivieren eingeschaltet (sie ist standardmäßig aktiviert).
3. Speichern. Wenn ab jetzt ein Fahrzeug unter einer neuen AutoScout24 Listing ID, aber mit derselben Fahrgestellnummer (VIN) wieder eingestellt wird, wird es mit dem bestehenden Fahrzeug zusammengeführt (kein Duplikat), der neue Preis wird angewendet, die öffentliche URL bleibt erhalten und eine Preishistorie sowie ein Wiedereinstellungs-Zähler werden aufgezeichnet.

Full Sync aktivieren und festlegen, wie entfernte Fahrzeuge behandelt werden (Gefahrenzone)

1. Erstellen Sie ein Backup Ihrer Datenbank und Ihres Upload-Verzeichnisses.
2. Schalten Sie in der Gefahrenzone die Option Full Sync aktivieren ein und bestätigen Sie den Warnhinweis.
3. Entscheiden Sie, wie entfernte Fahrzeuge behandelt werden sollen: - Soft-Delete (empfohlen, Standard): Lassen Sie Entfernte Fahrzeuge zurückhalten (Soft-Delete) aktiviert. Ein Fahrzeug, das aus AutoScout24 verschwindet, wird ausgeblendet (auf Entwurf gesetzt) und für den von Ihnen konfigurierten Kulanzzeitraum (Tage) aufbewahrt (Standard 30). Wenn es innerhalb dieses Zeitraums wieder eingestellt wird, wird es an Ort und Stelle wiederhergestellt — gleiche Seite, URL und Preishistorie. Erst nach Ablauf des Kulanzzeitraums wird es durch eine tägliche Bereinigung dauerhaft gelöscht. - Sofortiges Löschen: Schalten Sie Entfernte Fahrzeuge zurückhalten (Soft-Delete) aus. Ein entferntes Fahrzeug wird beim nächsten Durchlauf dauerhaft gelöscht, einschließlich seiner importierten und hervorgehobenen Bilder.
4. Speichern.

Konfigurations-Referenz

Aktueller Import-Status

Oben auf dem Bildschirm gibt ein dynamischer Satz an, ob automatische Importe derzeit aktiv sind (und ob sie über Server-Cron oder WP-Cron laufen) oder deaktiviert sind. Darunter befinden sich vier KPI-Kacheln:

Letzter Durchlauf

Die Zusammenfassung des Letzten Durchlaufs meldet die Metriken des jüngsten Imports: eingefügt, aktualisiert, übersprungen und Fehler. Wenn Full Sync aktiviert ist, kann sie für Fahrzeuge, die nicht mehr auf AutoScout24 vorhanden sind, auch einen Zurückgehalten-Zähler (Fahrzeuge, die während ihres Kulanzzeitraums als Entwürfe ausgeblendet wurden, wenn Soft-Delete aktiviert ist) und einen Gelöscht-Zähler (dauerhaft entfernte Fahrzeuge) ausweisen.

Trigger-Methode

WordPress Cron-Einstellungen (nur sichtbar, wenn WordPress Cron ausgewählt ist)

Server-Cron-Einstellungen (nur sichtbar, wenn Server-Cron ausgewählt ist)

Bildverarbeitung und Stabilität

Import-Standardwerte

Wiedereinstellungs-Erkennung

Gefahrenzone

---

---

Wie die Wiedereinstellungs-Erkennung und die Preishistorie funktionieren

Einige Autohäuser frischen ihr AutoScout24-Ranking auf, indem sie ein Inserat löschen und neu erstellen. AutoScout24 vergibt dann eine neue Listing ID, oft mit einem niedrigeren Preis, während das physische Auto dieselbe VIN (Fahrzeugidentifikationsnummer) behält. Da der Importer Fahrzeuge normalerweise über die Listing ID abgleicht, würde ein solches Wiedereinstellen andernfalls ein Duplikat erstellen oder – bei aktivem Full Sync – die Historie des Autos zurücksetzen.

Wenn die Wiedereinstellungs-Erkennung aktiviert ist, funktioniert der Import wie folgt:

1. Der Importer versucht zunächst, das eingehende Inserat anhand seiner AutoScout24 Listing ID abzugleichen (wie bisher).
2. Wenn keine Übereinstimmung gefunden wird, weicht er auf den Abgleich über die normalisierte VIN aus (in Großbuchstaben, nicht-alphanumerische Zeichen entfernt). Eine VIN, die leer oder zu kurz ist, um vertrauenswürdig zu sein, wird ignoriert, sodass sich Inserate ohne VIN genau wie bisher verhalten.
3. Wenn genau ein vorhandenes Fahrzeug diese VIN besitzt, wird es direkt aktualisiert: Die neue Listing ID und der neue Preis werden angewendet, und der öffentliche Slug/die URL wird unverändert beibehalten, sodass Links und SEO erhalten bleiben. Es wird kein Duplikat erstellt.
4. Wenn die VIN mehrdeutig ist (bereits bei mehr als einem Fahrzeug vorhanden), führt das Plugin keine automatische Zusammenführung durch – es bleibt auf der sicheren Seite und lässt die Datensätze unberührt.

Was bei einem wiederhergestellten Fahrzeug aufgezeichnet wird:

• Preishistorie – jede Preisänderung (und der Anfangspreis) wird als datiertes Ereignis gespeichert, sodass ein Lösch-und-günstiger-Wiedereinstell-Muster sichtbar wird.
• Vorherige AutoScout24 Listing IDs – die Kette von Listing IDs, die das Auto bisher hatte.
• Zuerst gesehen – das ursprüngliche Importdatum bleibt erhalten (und wird für bestehende Fahrzeuge rückwirkend ausgefüllt), sodass die Standzeit (Days-on-Lot) korrekt bleibt.
• Wiedereinstellungs-Zähler und die neueste Preisdifferenz.

Wo Sie es sehen:

• Spalte in der Fahrzeugliste – eine Spalte Wiedereinstellung zeigt ein Re-listed n×-Badge und die neueste Preisänderung (▼ Preissenkung / ▲ Preissteigerung).
• Fahrzeug-Editor – eine Box Wiedereinstellung & Preishistorie listet das Datum des ersten Erscheinens, die vorherigen Listing IDs und die vollständige Preishistorie auf.

Entwickler können sich in die Action as24ci_vehicle_relisted ($post_id, $previous_listing_id, $current_listing_id, $delta) einklinken, um eine Integration mit anderen Systemen vorzunehmen, und die gesamte Funktion über den Filter as24ci_enable_relisting_detection ein- oder ausschalten.

Wie Soft Delete und die Kulanzzeit funktionieren

Soft Delete (weiches Löschen) greift nur, wenn Full Sync aktiviert ist. Es ändert das Verhalten, wenn ein Fahrzeug nicht mehr von der AutoScout24-API zurückgegeben wird:

1. Beim ersten Durchlauf, bei dem das Fahrzeug fehlt, wird es ausgeblendet – sein Beitragsstatus wird auf Entwurf gesetzt (vom öffentlichen Frontend entfernt) und das Entfernungsdatum wird aufgezeichnet. Es wird nicht gelöscht.
2. Das Fahrzeug wird für die konfigurierte Kulanzzeit (Standard: 30 Tage) aufbewahrt.
3. Wenn dasselbe Fahrzeug innerhalb der Kulanzzeit erneut importiert wird – abgeglichen über die Listing ID oder die VIN (siehe Wiedereinstellungs-Erkennung) –, wird es direkt wiederhergestellt: Der ursprüngliche Beitrag, die URL und die Preishistorie bleiben erhalten, und es wird wieder auf seinen vorherigen Status zurückgesetzt.
4. Ein täglicher Bereinigungs-Cron-Job löscht Fahrzeuge, deren Kulanzzeit abgelaufen ist, dauerhaft (wobei importierte Bilder und Beitragsbilder entfernt werden), sodass sich nichts unbegrenzt ansammelt.

Dies schließt die Lücke, wenn ein Fahrzeug in einem Synchronisationszyklus entfernt und erst in einem späteren wieder eingestellt wird: Bei einem sofortigen (harten) Löschen wäre der ursprüngliche Beitrag bereits verloren, aber mit Soft Delete wird er weiterhin als Entwurf vorgehalten und kann wiederhergestellt werden.

Der Fahrzeug-Editor zeigt bei einem zurückgehaltenen Fahrzeug einen Hinweis an, zum Beispiel „Entfernt aus AutoScout24 am … – geplant für die dauerhafte Löschung am …, sofern nicht wieder eingestellt.“ Entwickler können dieses Verhalten mit dem Filter as24ci_enable_soft_delete anpassen.

Betriebshinweise

• Der Wechsel zu Server Cron schaltet das WP-Cron-Ereignis des Plugins automatisch ab, sodass derselbe Zeitplan nicht doppelt ausgeführt wird.
• Das Cron-Token wird beim ersten Aufruf der Seite nur im Server-Cron-Modus automatisch generiert, sodass die Trigger-URL bereitsteht, wenn Sie sie benötigen. Im WP-Cron-Modus wird kein Token automatisch generiert und die Trigger-URL wird ausgeblendet; wechseln Sie zu Server Cron (oder klicken Sie auf Token generieren), um eines zu erstellen.
• Die WebP-Konvertierung erfolgt auf dem Server. Wenn die erforderliche PHP-Erweiterung nicht vorhanden ist, wird die Konvertierung stillschweigend übersprungen – überprüfen Sie dies in den Protokollen und auf der Seite „System & Hilfe“.
• Die Bildwarteschlange ist unabhängig vom Limit „Fahrzeuge pro Durchlauf“. Beide können gleichzeitig aktiv sein.
• Die Begrenzung „Fahrzeuge pro Durchlauf“ gilt für geplante Importe. Der manuelle Import-Assistent kann automatisch mehrere Batches nacheinander durchlaufen, bis der gesamte Bestand verarbeitet ist.
• Das Speichern über eine der Schaltflächen innerhalb der einzelnen Karten speichert das gesamte Formular Import & Limits (das Formular erstreckt sich über mehrere Karten).
• Das Cron-Token, die REST-Trigger-URL und die in der Admin-Oberfläche angezeigten Beispiel-Cron-Befehle sind umgebungsspezifisch. Kopieren Sie keine Werte aus der Dokumentation; kopieren Sie sie immer von Ihrer Live-Oberfläche.
• Die Wiedereinstellungs-Erkennung benötigt eine VIN, um ein wieder eingestelltes Fahrzeug zusammenzuführen. Inserate ohne VIN werden nur über die Listing ID abgeglichen und verhalten sich wie bisher.
• Soft Delete wird nur wirksam, wenn Full Sync aktiviert ist. Wenn Full Sync deaktiviert ist, werden aus der API fehlende Fahrzeuge einfach behalten.
• Die Bereinigung der Kulanzzeit für Soft Delete läuft einmal täglich über den WordPress-Cron-Job. Auf Websites mit sehr geringem Traffic (WP-Cron-Modus) werden abgelaufene Fahrzeuge möglicherweise etwas später als zum exakten Ablaufdatum gelöscht.

Fehlerbehebung

• Der Zeitplan wird nie ausgeführt (WP-Cron-Modus). Der WordPress-Cron-Job wird nur ausgelöst, wenn die Website besucht wird. Wechseln Sie bei Websites mit geringem Traffic zu Server Cron, um eine zuverlässige Ausführung zu gewährleisten.
• Der REST-Trigger gibt 401/403 zurück. Das Token in der URL stimmt nicht überein. Kopieren Sie die URL erneut aus dem Admin-Bereich oder generieren Sie das Token neu.
• PHP-Timeouts während des Imports. Senken Sie den Wert für Fahrzeuge pro Durchlauf (versuchen Sie es mit 50), lassen Sie Bildwarteschlange aktivieren eingeschaltet und ziehen Sie in Erwägung, die Server-Werte für max_execution_time und memory_limit zu erhöhen, sofern Ihr Host dies zulässt.
• Bilder werden nicht heruntergeladen. Stellen Sie sicher, dass Bilder importieren aktiviert ist und das Uploads-Verzeichnis beschreibbar ist. Überprüfen Sie die Protokolle.
• Die WebP-Konvertierung hat keine Auswirkung. Stellen Sie sicher, dass PHP GD oder Imagick auf dem Server WebP-Unterstützung bietet. Überprüfen Sie dies auf der Seite „System & Hilfe“.
• Full Sync hat unerwartet Fahrzeuge entfernt. Full Sync löscht alles, was in der API-Antwort fehlt. Wenn Sie auch manuelle Bearbeitungen vornehmen, stellen Sie die Daten aus einem Backup wieder her und deaktivieren Sie Full Sync.
• Der manuelle Import startet nicht. Suchen Sie in der Browser-Konsole nach AJAX-Fehlern und überprüfen Sie, ob das Dashboard eine fehlerfreie API-Verbindung meldet.
• Dasselbe Auto erscheint doppelt, nachdem ein Autohaus es neu eingestellt hat. Aktivieren Sie die Wiedereinstellungs-Erkennung, damit das neue Inserat anhand der VIN mit dem bestehenden Fahrzeug zusammengeführt wird. Beachten Sie, dass ein Fahrzeug, dessen Inserat keine VIN hat, nicht automatisch zusammengeführt werden kann.
• Ein wieder eingestelltes Auto wurde nicht zusammengeführt. Das Inserat hat keine VIN oder die VIN existiert bereits bei mehr als einem Fahrzeug (mehrdeutig). Im Falle einer Mehrdeutigkeit führt das Plugin bewusst keine automatische Zusammenführung durch; beheben Sie das Duplikat manuell.
• Ein entferntes Auto ist immer noch als Entwurf vorhanden. Das ist das Soft Delete, welches das Fahrzeug während seiner Kulanzzeit zurückhält. Es wird automatisch wiederhergestellt, wenn das Auto wieder eingestellt wird, und nach Ablauf der Kulanzzeit dauerhaft gelöscht. Um entfernte Fahrzeuge stattdessen sofort zu löschen, deaktivieren Sie Entfernte Fahrzeuge zurückhalten (Soft Delete) in der Danger Zone.
• Zurückgehaltene Fahrzeuge werden nie bereinigt. Die Bereinigung läuft täglich über WP-Cron. Wechseln Sie bei Websites mit geringem Traffic zu Server Cron oder überprüfen Sie, ob WP-Cron ausgelöst wird (System & Hilfe).

Verwandte Dokumente

• Einstellungs-Referenz
• Fahrzeug-Importer Referenz
• Protokoll-Referenz
• System- und Hilfe-Referenz
• Tools-Referenz