Referenz zu Import & Limits

Dieses Dokument ist eine Referenz für die Ansicht 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-Crons, die Limits für die Bildverarbeitung, die Import-Standardwerte und die Option der 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-Cronjob wechseln, die Importleistung für grosse Bestände optimieren oder Full Sync aktivieren, um Fahrzeuge zu entfernen, die offline genommen wurden.

Übersicht

Die Ansicht 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 Verkäufer, Ausstehende Bilder und Fehler beim letzten Durchlauf. Ein Umschalter IDs anzeigen / IDs ausblenden macht die konfigurierten Seller-IDs direkt in der Zeile 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. Server-Cron-Einrichtung — 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, einschliesslich Bildern und WebP-Konvertierung.
7. Wiedereinstellungs-Erkennung — erkennt Fahrzeuge, die gelöscht und unter einer neuen AutoScout24 Listing ID (gleiche VIN) wieder eingestellt wurden, um Duplikate zu verhindern, die öffentliche URL stabil zu halten und einen Preisverlauf zu verfolgen.
8. Gefahrenzone — Full Sync-Umschalter sowie die Option für Soft-Delete / Kulanzfrist, 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, Cronjobs 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 Pausieren, 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 Server-Cron-Einrichtung 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-Cronjobs 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. Legen Sie unter Bildverarbeitung und Stabilität die Fahrzeuge pro Durchlauf fest (0 bedeutet kein Limit; 50–80 wird für grosse 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 ein und wählen Sie eine WebP-Qualität zwischen 10% und 100% in 5%-Schritten (empfohlen werden 75–85%).
5. Legen Sie die Max. Bilder 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ässig aktiv).
3. Speichern. Wenn ab jetzt ein Fahrzeug unter einer neuen AutoScout24 Listing ID, aber mit derselben 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 ein Preisverlauf 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 Uploads-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) eingeschaltet. Ein Fahrzeug, das aus AutoScout24 verschwindet, wird ausgeblendet (auf Entwurf gesetzt) und für die von Ihnen konfigurierte Kulanzfrist (Tage) aufbewahrt (Standard 30). Wenn es innerhalb dieses Zeitraums wieder eingestellt wird, wird es an Ort und Stelle wiederhergestellt — gleiche Seite, URL und Preisverlauf. Erst nach Ablauf der Kulanzfrist 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, einschliesslich seiner importierten Bilder und Beitragsbilder.
4. Speichern.

Konfigurations-Referenz

Aktueller Import-Status

Oben auf dem Bildschirm zeigt 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 sind, auch einen Zurückgehalten-Zähler (Fahrzeuge, die während ihrer Kulanzfrist als Entwürfe ausgeblendet wurden, wenn Soft-Delete aktiv ist) und einen Gelöscht-Zähler (dauerhaft entfernte Fahrzeuge) ausgeben.

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 der Preisverlauf funktionieren

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

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

1. Der Importer versucht zuerst, das eingehende Inserat anhand seiner AutoScout24 Listing ID abzugleichen (wie bisher).
2. Wenn keine Übereinstimmung gefunden wird, weicht er auf den Abgleich per normalisierter VIN aus (in Grossbuchstaben, 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 zuvor verhalten.
3. Wenn genau ein bestehendes Fahrzeug diese VIN hat, wird es direkt aktualisiert: Die neue Listing ID und der neue Preis werden angewendet, und der öffentliche Slug/die URL wird unverändert beibehalten, damit 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 wiedereingestellten Fahrzeug aufgezeichnet wird:

• Preisverlauf – jede Preisänderung (und der Anfangspreis) wird als datiertes Ereignis gespeichert, sodass ein Muster aus Löschen und günstigerem Wiedereinstellen sichtbar wird.
• Vorherige AutoScout24 Listing IDs – die Kette von Listing IDs, die das Auto 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 / ▲ Preiserhöhung).
• Fahrzeug-Editor – eine Box Wiedereinstellung & Preisverlauf listet das Datum des ersten Erscheinens, die vorherigen Listing IDs und den vollständigen Preisverlauf auf.

Entwickler können sich in die Action as24ci_vehicle_relisted ($post_id, $previous_listing_id, $current_listing_id, $delta) einhängen, um eine Integration mit anderen Systemen zu realisieren, und die gesamte Funktion mit dem Filter as24ci_enable_relisting_detection ein- oder ausschalten.

Wie das Soft-Delete und die Haltefrist funktionieren

Soft-Delete (sanftes Löschen) wird nur angewendet, wenn Full Sync aktiviert ist. Es ändert, was mit einem Fahrzeug passiert, das von der AutoScout24 API nicht mehr 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 Haltefrist (Standard: 30 Tage) aufbewahrt.
3. Wenn dasselbe Fahrzeug innerhalb der Haltefrist 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 der Preisverlauf bleiben erhalten, und es wird wieder auf seinen vorherigen Status zurückgesetzt.
4. Ein täglicher Bereinigungs-Cron löscht Fahrzeuge, deren Haltefrist abgelaufen ist, dauerhaft (wobei importierte Bilder und Beitragsbilder entfernt werden), damit sich nichts unbegrenzt ansammelt.

Dies schliesst 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 weg, aber mit Soft-Delete wird er weiterhin als Entwurf gehalten und kann wiederhergestellt werden.

Der Fahrzeug-Editor zeigt bei einem gehaltenen 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 steuern.

Betriebliche Hinweise

• Der Wechsel zu Server Cron deaktiviert das WP-Cron-Ereignis des Plugins automatisch, sodass derselbe Zeitplan nicht doppelt ausgeführt wird.
• Der Cron-Token wird beim ersten Rendern der Seite nur im Server-Cron-Modus automatisch generiert, sodass die Trigger-URL bereit ist, wenn Sie sie benötigen. Im WP-Cron-Modus wird kein Token automatisch generiert und die Trigger-URL ist ausgeblendet; wechseln Sie zu Server Cron (oder klicken Sie auf Token generieren), um einen 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 Logs und auf der Seite „System & Hilfe“.
• Die Bilder-Warteschlange 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 abarbeiten, bis der gesamte Bestand verarbeitet ist.
• Das Speichern über eine der Schaltflächen in den einzelnen Cards speichert das gesamte Formular Import & Limits (das Formular erstreckt sich über mehrere Cards).
• Der 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 wiedereingestelltes 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 Fahrzeuge, die in der API fehlen, einfach behalten.
• Die Bereinigung der Haltefrist für Soft-Delete läuft einmal täglich über den WordPress Cron. Auf Websites mit sehr wenig Traffic (WP-Cron-Modus) werden abgelaufene Fahrzeuge möglicherweise etwas später als zum genauen Ablaufdatum gelöscht.

Fehlerbehebung

• Der Zeitplan wird nie ausgeführt (WP-Cron-Modus). Der WordPress Cron wird nur ausgelöst, wenn die Website besucht wird. Wechseln Sie bei Websites mit wenig Traffic zu Server Cron für eine zuverlässige Ausführung.
• Der REST-Trigger gibt 401/403 zurück. Der Token in der URL stimmt nicht überein. Kopieren Sie die URL erneut aus dem Admin-Bereich oder generieren Sie den Token neu.
• PHP-Timeouts während des Imports. Verringern Sie Fahrzeuge pro Durchlauf (versuchen Sie es mit 50), lassen Sie Bilder-Warteschlange aktivieren eingeschaltet und ziehen Sie in Erwägung, die Server-Werte für max_execution_time und memory_limit zu erhöhen, falls Ihr Hoster 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 Logs.
• Die WebP-Konvertierung hat keine Wirkung. Vergewissern Sie sich, 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 eine Sicherung wieder her und deaktivieren Sie Full Sync.
• Der manuelle Import startet nicht. Suchen Sie in der Browserkonsole nach AJAX-Fehlern und überprüfen Sie, ob das Dashboard eine fehlerfreie API-Verbindung meldet.
• Dasselbe Auto erscheint doppelt, nachdem eine Garage 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 wiedereingestelltes Auto wurde nicht zusammengeführt. Das Inserat hat keine VIN oder die VIN existiert bereits bei mehr als einem Fahrzeug (mehrdeutig). Im mehrdeutigen Fall 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, das das Fahrzeug während seiner Haltefrist aufbewahrt. Es wird automatisch wiederhergestellt, wenn das Auto wieder eingestellt wird, und nach Ablauf der Haltefrist dauerhaft gelöscht. Um entfernte Fahrzeuge stattdessen sofort zu löschen, deaktivieren Sie Entfernte Fahrzeuge aufbewahren (Soft-Delete) in der Danger Zone.
• Gehaltene Fahrzeuge werden nie bereinigt. Die Bereinigung läuft täglich via WP-Cron. Wechseln Sie bei Websites mit wenig Traffic zu Server Cron oder überprüfen Sie, ob WP-Cron ausgelöst wird (System & Hilfe).

Verwandte Dokumente

• Einstellungs-Referenz
• Referenz zum Fahrzeug-Importer
• Logs-Referenz
• System- und Hilfe-Referenz
• Tools-Referenz