Referenz zu Import & Limits

Dieses Dokument ist eine Referenz für die Seite Import & Limits des ADP Car Market Hub-Plugins (CMH Center → 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.

Diese Seite ist der einzelne zentrale Importzeitplan (Cron-Hook as24ci_scheduled_import), der jede verbundene Datenquelle steuert. AutoScout24, mobile.de und carcuro laufen ausschliesslich über diesen Zeitplan; die automatischen Feed- und E-Mail-Quellen bieten zusätzlich ihr eigenes Intervall. Verbinden und konfigurieren Sie die Quellen selbst auf der Seite Connections.

Übersicht

Die Seite ist in die folgenden Karten unterteilt:

1. Aktueller Importstatus – 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 Verkäufer-IDs direkt sichtbar.
2. Letzter Durchlauf + Manueller Import – Metriken des letzten Imports und ein geführter Assistent, um einen Import bei Bedarf zu starten.
3. Automatisierungseinstellungen – 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; bietet eine saubere REST-Trigger-URL (ohne Secret in der URL), einen separaten Block für den Authentifizierungs-Header (Authorization: Bearer <token>) und Beispiel-Cron-Befehle.
5. Bildverarbeitung und Stabilität – Limits pro Durchlauf und Umschalter für die Bildwarteschlange, 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, der steuert, ob Fahrzeuge, die an der Quelle nicht mehr vorhanden sind, gelöscht werden.

Anforderungen oder Voraussetzungen

• Mindestens eine verbundene Datenquelle auf der Seite Connections (für AutoScout24 funktionierende API-Zugangsdaten und mindestens eine Seller ID).
• 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 CMH Center → 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 verbleibende Zeit (ETA) und eine Tabelle mit den Zahlen für eingefügte, aktualisierte, übersprungene, fehlerhafte und durch Full-Sync gelöschte Einträge.
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 Automatisierungseinstellungen die Option WordPress Cron.
2. Aktivieren Sie Importe automatisch über WordPress Cron ausführen.
3. Wählen Sie eine Importfrequenz 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 Automatisierungseinstellungen 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 (wobei das Token im Authorization: Bearer-Header gesendet wird) 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 den Authentifizierungs-Header aus der Karte. Kopieren Sie den Header sofort – das Token wird nur für etwa 15 Minuten angezeigt, danach wird nur noch ein Einweg-Hash gespeichert und Sie müssen das Token neu generieren, um es wieder zu sehen.
4. Verwenden Sie die Beispiel-Cron-Befehle als Ausgangspunkt (diese senden das Token bereits im Header) und passen Sie die Frequenz an Ihre Bedürfnisse an.
5. Klicken Sie auf Import & Limits-Einstellungen speichern.
6. Um das Secret zu rotieren, klicken Sie auf Token generieren und aktualisieren Sie Ihren Server-Cron-Eintrag mit dem neuen Header.

Bildverarbeitung für Stabilität konfigurieren

1. Stellen Sie unter Bildverarbeitung und Stabilität die Fahrzeuge pro Durchlauf ein (0 bedeutet kein Limit; 50–80 wird für grosse Kataloge empfohlen).
2. Lassen Sie Bildwarteschlange aktivieren eingeschaltet, damit nur das erste Bild sofort geladen wird und der Rest asynchron verarbeitet wird.
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. Aktivieren/deaktivieren Sie Bilder importieren, um zu steuern, ob Bildanhänge heruntergeladen werden.
4. Aktivieren/deaktivieren Sie optional Bilder in WebP konvertieren 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 CMH Center → Import & Limits und suchen Sie die Karte Wiedereinstellungs-Erkennung.
2. Lassen Sie Wiedereinstellungs-Erkennung aktivieren eingeschaltet (sie ist standardmässig aktiv).
3. Speichern. Wenn ein Fahrzeug ab jetzt 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 (Gefahrenzone)

1. Erstellen Sie ein Backup Ihrer Datenbank und Ihres Upload-Verzeichnisses.
2. Aktivieren Sie in der Gefahrenzone die Option Full Sync aktivieren und bestätigen Sie den Warnhinweis.
3. Wenn Full Sync aktiviert ist, wird ein Fahrzeug, das aus AutoScout24 verschwindet, beim nächsten Durchlauf dauerhaft gelöscht, einschliesslich seiner importierten Bilder und Beitragsbilder. Es gibt keine Schonfrist und kein Zurückhalten durch Soft-Delete.
4. Speichern.

---

Konfigurationsreferenz

Aktueller Import-Status

Am oberen Bildschirmrand zeigt ein dynamischer Satz an, ob automatische Importe derzeit aktiv sind (und ob sie über den Server-Cron oder WP-Cron laufen) oder deaktiviert sind. Darunter befinden sich vier KPI-Kacheln:

Letzter Durchlauf

Die Zusammenfassung Letzter Durchlauf meldet die Kennzahlen des jüngsten Imports: eingefügt, aktualisiert, übersprungen und Fehler. Wenn Full Sync aktiviert ist, kann sie für Fahrzeuge, die sich nicht mehr auf AutoScout24 befinden, auch einen Zähler für Gelöscht (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)

Veraltet: Der Endpunkt akzeptiert das Token aus Gründen der Abwärtskompatibilität auch weiterhin als ?token=<secret> Query-Parameter, aber dies legt das Geheimnis in Server-, Proxy- oder CDN-Logs offen und sollte vermieden werden. Bevorzugen Sie den Authorization: Bearer Header.

Bildverarbeitung und Stabilität

Import-Standardwerte

Erkennung von Wiedereinstellungen

Gefahrenzone

Wie die Erkennung von Wiedereinstellungen 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 niedrigeren 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 aktivem Full Sync – den Verlauf des Autos zurücksetzen.

Wenn die Erkennung von Wiedereinstellungen 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 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 bisher 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, 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 wieder eingestellten Fahrzeug aufgezeichnet wird:

• Preisverlauf – jede Preisänderung (und der ursprüngliche Preis) wird als datierter Eintrag gespeichert, sodass ein Muster von Löschen-und-günstiger-Wiedereinstellen 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 nachgetragen), 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 an (▼ Preissenkung / ▲ Preissteigerung).
• 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 as24ci_vehicle_relisted Aktion ($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 as24ci_enable_relisting_detection Filter ein- oder ausschalten.

---

Wie der Full Sync Fahrzeuge entfernt

Der Full Sync wird nur angewendet, wenn er in der Danger Zone aktiviert ist. Wenn ein Fahrzeug von der AutoScout24-API nicht mehr zurückgegeben wird, löscht der Full Sync es sofort beim nächsten Durchlauf – es gibt keine Kulanzzeit und kein Zurückhalten durch Soft-Delete:

1. Beim ersten Durchlauf, bei dem das Fahrzeug fehlt, wird es dauerhaft gelöscht, einschliesslich seiner importierten Bilder und Beitragsbilder.
2. Als Sicherheitsmassnahme wird der Full Sync komplett übersprungen, wenn die API eine leere Fahrzeugliste zurückgibt, sodass ein temporärer Ausfall nicht den gesamten Katalog löschen kann.

Wenn ein entferntes Fahrzeug später wieder eingestellt wird, wird es als neues Fahrzeug erneut importiert. Die Wiedereinstellungs-Erkennung (Abgleich über die Listing ID oder die VIN) hält die öffentliche URL und den Preisverlauf stabil, wenn ein bestehendes Fahrzeug aktualisiert wird, kann aber kein Fahrzeug wiederherstellen, das der Full Sync bereits gelöscht hat.

Betriebliche Hinweise

• Dies ist ein einziger Zeitplan für jede Quelle. AutoScout24, mobile.de, carcuro, der automatische Feed und der E-Mail-Posteingang werden alle über diesen zentralen Zeitplan gesteuert; die Feed- und E-Mail-Quellen können zusätzlich in ihrem eigenen Intervall ausgeführt werden, das unter Connections eingestellt ist. Ein manueller Import kann hier jederzeit gestartet werden.
• Das Umschalten auf den Server-Cron deaktiviert das WP-Cron-Ereignis des Plugins automatisch, 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 und der Header bereitstehen, wenn Sie sie benötigen. Im WP-Cron-Modus wird kein Token automatisch generiert und der Header wird ausgeblendet; wechseln Sie zum 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 Logs und auf der Seite System & Hilfe.
• Die Bildwarteschlange ist unabhängig vom Limit für 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).
• Das Cron-Token, die REST-Trigger-URL, der Authentifizierungs-Header und die in der Admin-Benutzeroberflä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 zuvor.
• Der Full Sync löscht aus der Quelle entfernte Fahrzeuge sofort und ohne Kulanzzeit. Wenn der Full Sync deaktiviert ist, werden in der API fehlende Fahrzeuge einfach behalten.

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 zum Server-Cron, um eine zuverlässige Ausführung zu gewährleisten.
• Der REST-Trigger gibt 401/403 zurück. Das Token im Authorization: Bearer-Header (oder im veralteten Parameter token=) stimmt nicht überein. Kopieren Sie den Authentifizierungs-Header erneut aus dem Admin-Bereich oder generieren Sie das Token neu.
• PHP-Timeouts während des Imports. Verringern Sie den Wert für Fahrzeuge pro Durchlauf (versuchen Sie es mit 50), lassen Sie Bildwarteschlange aktivieren eingeschaltet und erwägen Sie, die Server-Werte für max_execution_time und memory_limit zu erhöhen, falls 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 Logs.
• Die WebP-Konvertierung hat keine Auswirkung. Stellen Sie sicher, dass PHP GD oder Imagick auf dem Server WebP unterstützt. Überprüfen Sie dies auf der Seite System & Hilfe.
• Der Full Sync hat unerwartet Fahrzeuge entfernt. Der 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 den 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 wieder eingestelltes 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 die Zusammenführung bewusst nicht automatisch durch; beheben Sie das Duplikat manuell.

Verwandte Dokumente

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