Arbeitsablauf für den Fahrzeugimport

Dieses Dokument beschreibt, wie Sie Fahrzeugdaten 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, die Änderungserkennung, die Bildverarbeitung und den Full Sync.

Wann Sie dieses Dokument verwenden 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 Fahrzeugen, Bildern und gelöschten Fahrzeugen umgeht.

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

---

Übersicht

Das Plugin ruft Fahrzeugdaten von der AutoScout24-API für alle konfigurierten Seller-IDs ab und speichert jedes Fahrzeug 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 Fahrzeug über den Reiter „Car Importer“.
2. Batch-Wizard – Führen Sie manuell einen vollständigen Import aller Fahrzeuge 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 zugrunde liegende Importlogik: Verbindung zur API herstellen, Fahrzeuge für jede konfigurierte Garage 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-Basis-URL, Seller-ID(s), Client ID, Client Secret, Token-URL und Audience) müssen unter ADP Car Market Hub → Einstellungen eingegeben und gespeichert werden, bevor ein Import ausgeführt werden kann.
• Die WordPress-Website muss in der Lage sein, ausgehende HTTPS-Verbindungen zum konfigurierten API-Endpunkt herzustellen.
• Für den Bildimport muss das Uploads-Verzeichnis von WordPress 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 Fahrzeuge auf, die noch nicht in WordPress importiert wurden.
3. Suchen Sie das Fahrzeug, das Sie importieren möchten.
4. Klicken Sie neben dem Eintrag 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 Fahrzeuge und für die Durchführung einer erzwungenen Aktualisierung ausserhalb 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 an mit: - Gesamtzahl der zu verarbeitenden Fahrzeuge. - Bisher verarbeitete Fahrzeuge. - Voraussichtliche verbleibende Zeit. - Aktuelle Aktion (Einfügen, Aktualisieren oder Überspringen).
4. Der Assistent verarbeitet standardmässig ein Fahrzeug nach dem anderen (adaptive Batch-Grösse: 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 allfällige Fehler an.

Konfigurieren und Ausführen geplanter automatischer Importe

Für eine laufende Synchronisation aktivieren Sie die automatische Planung:

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. Bei täglichen und zweimal täglichen Zeitplänen können Sie optional die Startzeit festlegen.
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 mittels 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 grossen Beständen, bei denen die meisten Fahrzeuge unverändert sind.

Wenn ein Fahrzeug auf AutoScout24 aktualisiert wird (z. B. bei einer Preisänderung oder neuen Bildern), 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 Fahrzeug heruntergeladen werden (0 = unbegrenzt).
• Bildwarteschlangen-Modus (standardmässig für Cron-/REST-Importe aktiviert): Bei geplanten Importen wird nur das erste Bild pro Fahrzeug sofort heruntergeladen. Alle weiteren Bilder werden einer dauerhaften Hintergrundwarteschlange hinzugefügt und asynchron vom Bildwarteschlangen-Worker verarbeitet, der etwa alle 5 Minuten läuft. Dies verhindert PHP-Ausführungszeitüberschreitungen bei grossen Importen.
• Der Bildwarteschlangen-Worker verarbeitet bis zu 30 Bilder pro Durchgang.
• Die aktuelle Grösse der Warteschlange und der Status des Workers 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ültigkeit (TTL) von ca. 40 Minuten. Wenn bereits ein Import läuft und 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 Fahrzeug-IDs mit allen Fahrzeug-Beiträgen in WordPress. Jeder lokale Beitrag, dessen ID nicht im aktuellen Remote-Bestand enthalten ist, wird dauerhaft gelöscht – einschliesslich aller angehängten Bilder.

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

Status von Fahrzeug-Beiträgen

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

---

Konfigurationsreferenz

---

Betriebliche Hinweise

• Mehrere Seller-IDs: Der Importer läuft für jede konfigurierte Seller-ID separat. Ein Fehler bei einer Garage stoppt die Importe für andere Garagen nicht.
• Cron-Robustheit: 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össe: Der Assistent passt seine Batch-Grösse (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 Durchlauf beendet ist, oder heben Sie die Sperre auf.
• Importprotokoll: Alle Importereignisse (API-Aufrufe, eingefügte/aktualisierte/übersprungene/fehlerhafte Fahrzeuge, Bild-Downloads) werden in das Plugin-Protokoll geschrieben. Details finden Sie unter ADP Car Market Hub → Protokolle.
• 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

---

Verwandte Dokumente

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