Fahrzeug-Import-Workflow

Dieses Dokument beschreibt, wie Sie Fahrzeugangebote aus der AutoScout24-API mit dem ADP Car Market Hub-Plugin in WordPress importieren. Es behandelt sowohl manuelle Importmethoden als auch den automatischen geplanten Import sowie Importoptionen, Änderungserkennung, Bildverarbeitung und den Full Sync.

Wann Sie dieses Dokument lesen sollten

Lesen Sie dieses Dokument, wenn Sie:

• Zum ersten Mal oder bei Bedarf einen Fahrzeugimport durchführen oder überwachen müssen.
• Den Unterschied zwischen manuellem Import, dem Batch-Wizard und dem geplanten (automatischen) Import verstehen möchten.
• Fehler beim Import oder unerwartete Ergebnisse beheben müssen.
• Verstehen möchten, wie das Plugin mit aktualisierten Angeboten, Bildern und entfernten Fahrzeugen umgeht.

Für eine kurze tägliche Überprüfung des Importstatus siehe Tägliche Arbeitsabläufe.

---

Übersicht

Das Plugin ruft Fahrzeugangebote aus der AutoScout24-API für alle konfigurierten Seller IDs ab und speichert jedes Angebot als WordPress-Beitrag des Custom Post Type as24ci_car. Fahrzeug-Metadaten (Preis, Kilometerstand, Spezifikationen, Ausstattung, Bilder) werden in den Post-Metadaten und einer eigenen benutzerdefinierten Datenbanktabelle gespeichert.

Es gibt drei Möglichkeiten, einen Import auszulösen:

1. Einzelner Fahrzeugimport – Importieren oder reimportieren Sie ein einzelnes Angebot über den Reiter „Car Importer“.
2. Batch-Wizard – Führen Sie manuell einen vollständigen Import aller Angebote mit Live-Fortschrittsüberwachung aus. Geeignet für den ersten Import oder eine erzwungene vollständige Aktualisierung.
3. Automatischer geplanter Import – Läuft in einem konfigurierten Intervall über WP-Cron oder einen externen Server-Cron. Die empfohlene Methode für die laufende Synchronisation.

Alle drei Wege nutzen dieselbe zugrundeliegende Importlogik: Verbindung zur API herstellen, Angebote für jeden konfigurierten Verkäufer abrufen, mit der lokalen Kopie anhand von Inhalts-Hashes vergleichen und nach Bedarf WordPress-Beiträge erstellen oder aktualisieren.

---

Anforderungen oder Voraussetzungen

• Gültige API-Zugangsdaten (API Base URL, Seller ID(s), Client ID, Client Secret, Token URL und Audience) müssen vor jedem Import unter ADP Car Market Hub → Einstellungen eingegeben und gespeichert werden.
• Die WordPress-Website muss in der Lage sein, ausgehende HTTPS-Verbindungen zum konfigurierten API-Endpunkt herzustellen.
• Für Bildimporte muss das WordPress-Uploads-Verzeichnis beschreibbar sein.
• Mindestens eine Seller ID muss konfiguriert sein. Das Plugin liest die Option as24ci_seller_ids (kommagetrennte Liste von IDs).

---

Schritt-für-Schritt-Anleitung

Importieren eines einzelnen Fahrzeugs

1. Navigieren Sie zu ADP Car Market Hub → Car Importer.
2. Die Tabelle Ausstehende Fahrzeuge listet die über die API verfügbaren Angebote auf, die noch nicht in WordPress importiert wurden.
3. Suchen Sie das Fahrzeug, das Sie importieren möchten.
4. Klicken Sie neben dem Angebot auf Importieren.
5. Die Seite wird neu geladen und das Fahrzeug erscheint oben in der Tabelle Importierte Fahrzeuge.
6. Um ein bereits importiertes Fahrzeug zu aktualisieren (z. B. nach einer Preisänderung auf AutoScout24), suchen Sie es in der Tabelle Importierte Fahrzeuge und klicken Sie auf Re-importieren.

Ausführen des Batch-Wizards (manueller Vollimport)

Der Batch-Wizard ist die empfohlene Methode für den ersten vollständigen Import aller Angebote und für die Durchführung einer erzwungenen Aktualisierung außerhalb des regulären Zeitplans.

1. Navigieren Sie zu ADP Car Market Hub → Import & Limits.
2. Klicken Sie auf die Schaltfläche Jetzt auslösen.
3. Der Batch-Wizard startet und zeigt einen Live-Fortschrittsbalken mit folgenden Informationen an: - Insgesamt zu verarbeitende Fahrzeuge. - Bisher verarbeitete Fahrzeuge. - Voraussichtliche verbleibende Zeit. - Aktuelle Aktion (Einfügen, Aktualisieren oder Überspringen).
4. Der Assistent verarbeitet standardmäßig ein Fahrzeug nach dem anderen (adaptive Batch-Größe: 1–5 Fahrzeuge pro Schritt). Dies verhindert PHP-Ausführungszeitfehler auf Shared-Hosting-Umgebungen.
5. Verwenden Sie die Schaltfläche Pause, um den Import vorübergehend anzuhalten. Klicken Sie auf Fortsetzen, um fortzufahren.
6. Verwenden Sie die Schaltfläche Abbrechen, um den Import zu stoppen. Bereits im aktuellen Durchlauf verarbeitete Fahrzeuge verbleiben in WordPress.
7. Nach Abschluss des Assistenten zeigt eine Zusammenfassung die Anzahl der eingefügten, aktualisierten, übersprungenen Fahrzeuge sowie eventuelle Fehler an.

Konfigurieren und Ausführen geplanter automatischer Importe

Für eine laufende Synchronisierung aktivieren Sie den automatischen Zeitplaner:

1. Navigieren Sie zu ADP Car Market Hub → Import & Limits.
2. Aktivieren Sie Automatischer Import (das Kontrollkästchen oder den Schalter auf dem Reiter).
3. Wählen Sie das Importintervall: - Stündlich - Alle 6 Stunden - Zweimal täglich - Täglich - Benutzerdefiniert (mindestens 15 Minuten – konfigurieren Sie den Minutenwert im Feld für das benutzerdefinierte Intervall)
4. Legen Sie für tägliche und zweimal tägliche Zeitpläne optional die Startzeit fest.
5. Speichern Sie die Automatisierungseinstellungen.
6. Der WP-Cron von WordPress löst nun Importe im konfigurierten Intervall aus, sobald die Website Besucher empfängt.

Für Live-Websites wird ein Server-Cron empfohlen:

1. Stellen Sie den Cron-Modus auf dem Reiter „Import & Limits“ auf Server-Cron.
2. Kopieren Sie die angezeigte Cron-Endpunkt-URL (die URL enthält ein Sicherheits-Token).
3. Fügen Sie einen serverseitigen Cron-Job hinzu (z. B. über crontab), der die Endpunkt-URL mit curl oder wget im gewünschten Intervall aufruft.
4. Wenn Sie das Token neu generieren (Import & Limits → Token neu generieren), aktualisieren Sie Ihren Cron-Job mit der neuen URL.

---

Wie Importe funktionieren

Änderungserkennung

Der Importer berechnet und speichert für jedes importierte Fahrzeug einen Inhalts-Hash und einen Bild-Hash. Bei nachfolgenden Importläufen wird ein Fahrzeug übersprungen, wenn sich keiner der beiden Hashes geändert hat. Dies hält die Importläufe schnell, insbesondere bei großen Beständen, bei denen die meisten Fahrzeuge unverändert sind.

Wenn ein Angebot auf AutoScout24 aktualisiert wird (z. B. eine Preisänderung oder neue Bilder), stimmen die Hashes nicht mehr überein und das Fahrzeug wird in WordPress aktualisiert.

Import-Ergebnis-Codes

Jedes während eines Importlaufs verarbeitete Fahrzeug wird in eine von vier Kategorien eingeteilt:

Die Importzusammenfassung auf dem Reiter „Import & Limits“ und im Batch-Wizard zeigt diese Zahlen nach jedem Durchlauf an.

Bildimport und die Bildwarteschlange

• Wenn Bilder importieren in den Einstellungen aktiviert ist, lädt der Importer Fahrzeugbilder von der API herunter und hängt sie an den WordPress-Beitrag an.
• Max. Bilder pro Fahrzeug (Einstellungen) begrenzt, wie viele Bilder pro Angebot heruntergeladen werden (0 = unbegrenzt).
• Bildwarteschlangen-Modus (standardmäßig für Cron-/REST-Importe aktiviert): Bei geplanten Importen wird zunächst nur das erste Bild pro Fahrzeug sofort heruntergeladen. Alle verbleibenden Bilder werden in eine dauerhafte Hintergrundwarteschlange eingereiht und asynchron vom Bildwarteschlangen-Worker verarbeitet, der etwa alle 5 Minuten läuft. Dies verhindert PHP-Ausführungszeitüberschreitungen bei großen Importen.
• Der Bildwarteschlangen-Worker verarbeitet bis zu 30 Bilder pro Batch.
• Die aktuelle Warteschlangengröße und der Worker-Status sind auf dem Reiter System & Hilfe einsehbar.
• Um die Bildwarteschlange sofort abzuarbeiten, klicken Sie auf dem Reiter „System & Hilfe“ auf Bildwarteschlange jetzt ausführen.
• WebP-Konvertierung: Wenn in den Einstellungen aktiviert und GD oder Imagick verfügbar ist, werden Bilder beim Herunterladen in das WebP-Format konvertiert. Die Qualitätsstufe ist konfigurierbar (1–100, Standard 80).

Importsperre

Das Plugin verwendet eine Transient-basierte Laufsperre mit einer Gültigkeitsdauer (TTL) von ca. 40 Minuten. Wenn bereits ein Importlauf aktiv ist, während ein zweiter Trigger eingeht (über WP-Cron, Server-Cron oder eine manuelle Schaltfläche), wird der zweite Trigger übersprungen und eine Meldung „bereits aktiv“ protokolliert. Wenn die Sperre veraltet ist (älter als die TTL), wird sie automatisch aufgehoben, damit der nächste Durchlauf starten kann.

Full Sync

Wenn Full Sync auf dem Reiter „Import & Limits“ aktiviert ist, vergleicht der Importer die von der API zurückgegebenen Angebots-IDs mit allen Fahrzeugbeiträgen in WordPress. Jeder lokale Beitrag, dessen Angebots-ID nicht im aktuellen Remote-Angebot enthalten ist, wird dauerhaft gelöscht – einschließlich aller angehängten Bilder.

• Aktivieren Sie den Full Sync nur, wenn Sie möchten, dass der Bestand in WordPress exakt das Live-Angebot von AutoScout24 widerspiegelt.
• Löschungen durch den Full Sync werden im Plugin-Protokoll mit den entsprechenden sync_deleted-Zahlen erfasst.
• Wenn der Full Sync deaktiviert ist, verbleiben von AutoScout24 entfernte Fahrzeuge in WordPress, bis sie manuell gelöscht werden.

Status von Fahrzeugbeiträgen

Importierte Fahrzeuge werden mit dem unter Einstellungen → Standard-Beitragsstatus (publish oder draft) konfigurierten Beitragsstatus erstellt. Wenn ein Fahrzeug bei einem späteren Importlauf aktualisiert wird, ändert sich sein Beitragsstatus nicht – ein veröffentlichter Beitrag bleibt veröffentlicht.

---

Konfigurations-Referenz

---

Betriebshinweise

• Mehrere Seller IDs: Der Importer läuft für jede konfigurierte Seller ID separat. Ein Fehler bei einem Verkäufer stoppt nicht die Importe für andere Verkäufer.
• Cron-Stabilität: Der Import-Runner erhöht das PHP-Ausführungszeitlimit bei Cron-/REST-gesteuerten Läufen auf 300 Sekunden. Auf Hosting-Umgebungen, die set_time_limit() einschränken, zeigt dies möglicherweise keine Wirkung.
• Batch-Wizard-Batchgröße: Der Assistent passt seine Batchgröße (1–5 Fahrzeuge pro Schritt) an, um innerhalb sicherer Ausführungszeitgrenzen zu bleiben.
• Manuelles Auslösen bei aktivem Cron: Wenn der automatische Cron läuft, während Sie auf „Jetzt auslösen“ klicken, wird der manuelle Trigger aufgrund der Laufsperre übersprungen. Warten Sie, bis der aktuelle Lauf beendet ist, oder heben Sie die Sperre auf.
• Import-Protokoll: Alle Importereignisse (API-Aufrufe, eingefügte/aktualisierte/übersprungene Fahrzeuge, Fehler pro Fahrzeug, Bild-Downloads) werden in das Plugin-Protokoll geschrieben. Details finden Sie unter ADP Car Market Hub → Logs.
• Ausführliche Protokollierung: Wenn aktiviert, enthält das Protokoll detaillierte Angaben zu jedem Fahrzeug und Bild. Deaktivieren Sie dies im Live-Betrieb, um das Protokollwachstum zu begrenzen.

---

---

Fehlerbehebung

---

Zugehörige Dokumente

• Tägliche Arbeitsabläufe
• Administrator-Handbuch
• Lead-Management-Workflow
• Benutzerhandbuch