Dokumentation · Erste Schritte

Checkliste für den Live-Gang

Dieses Dokument ist die Checkliste für die Produktionsbereitschaft von ADP Car Market Hub. Es fasst alle übergreifenden Punkte zusammen, die überprüft werden sollten, bevor automatische Importe auf der Live-WordPress-Website eines Kunden aktiviert werden, damit der Start vorhersehbar und umkehrbar ist.

Es ergänzt die Ersteinrichtung, anstatt sie zu ersetzen: Die Ersteinrichtung beschreibt Schritt für Schritt, wie das Plugin konfiguriert wird; dieses Dokument beschreibt, wie verifiziert wird, dass die Konfiguration für den Wechsel in den Live-Betrieb sicher ist.

Wann dieses Dokument zu verwenden ist

Verwenden Sie dieses Dokument, wenn Sie:

Eine Agentur oder ein Implementierungspartner sind, der kurz davor steht, eine neue ADP Car Market Hub-Bereitstellung für einen Kunden freizugeben.
Ein WordPress-Administrator sind, der eine validierte Staging-Konfiguration auf eine Produktions-Website überträgt.
Ein Hosting-Team sind, das dafür verantwortlich ist, zu bestätigen, dass die Produktionsumgebung für geplante Importe dimensioniert und konfiguriert ist.
Ein Betriebsverantwortlicher sind, der einen kontrollierten Relaunch nach einer Servermigration, einer Domainänderung, einer Zertifikatserneuerung oder einem größeren Plugin-Update durchführt.

Die Zielgruppe ist technisch: ein WordPress-Administrator mit vollem Back-Office-Zugriff, der (falls zutreffend) mit dem Hosting-Anbieter und dem Inhaber des AutoScout24-API-Zugangs für das Autohaus zusammenarbeitet.

Übersicht

Ein Produktions-Live-Gang für ADP Car Market Hub ist keine einzelne Aktion – die Aktivierung automatischer Importe ist der letzte Schritt in einer Kette, die von folgenden Faktoren abhängt:

Bereitschaft der Hosting- und PHP-Umgebung.
Korrekte API-Zugangsdaten im Besitz des Autohauses.
Ein erfolgreicher, wiederholbarer Verbindungstest und mindestens ein erfolgreicher Testimport.
Ein Frontend, das anhand echter, importierter Fahrzeugdaten überprüft wurde.
Rechtliche, Datenschutz- und Einwilligungseinstellungen, die mit den veröffentlichten Richtlinien des Autohauses übereinstimmen.
Ein dokumentierter Rollback-Pfad, falls nach dem Start etwas fehlschlägt.

Die folgende Checkliste ist nach Themen gruppiert. Jeder Punkt sollte entweder abgehakt oder mit einer dokumentierten Begründung ausdrücklich akzeptiert werden, bevor die Website für echten Traffic mit Live-Importen geöffnet wird.

Voraussetzungen vor der Bearbeitung der Checkliste

Stellen Sie sicher, dass alle folgenden Punkte erfüllt sind, bevor Sie diese Checkliste öffnen:

Das Plugin ist auf der Produktions-Website installiert und aktiviert (siehe Installationsanleitung).
Eine konfigurierte Staging-Umgebung ist vorhanden und dieselbe Konfiguration wurde auf der Produktionsumgebung repliziert (siehe Staging to Live Migration).
Die API-Zugangsdaten für das Konto des Autohauses sind über einen sicheren Kanal verfügbar (siehe Einrichtung der API-Zugangsdaten, AutoScout24 API Setup, External API Credentials).
Die Website verfügt über ein aktuelles, wiederherstellbares Backup, das die Datenbank und wp-content/ umfasst.
Die Beteiligten (Autohaus, Agentur, Hosting) haben sich auf ein Zeitfenster für den Live-Gang geeinigt, in dem die ersten Importe überwacht werden sollen.

Schritt-für-Schritt-Anleitung

Arbeiten Sie die Abschnitte der Reihe nach durch. Aktivieren Sie die automatische Planung erst, wenn jeder zutreffende Punkt bestätigt wurde.

1. Umgebung und Infrastruktur

[ ] WordPress erfüllt die Mindestversion des Plugins (Requires at least: 6.2) und PHP erfüllt das Minimum (Requires PHP: 8.1). Siehe Technische Systemanforderungen.
[ ] Erforderliche PHP-Erweiterungen sind vorhanden: openssl, curl, mbstring, json und entweder gd oder imagick. Siehe PHP and Database Requirements.
[ ] Ausgehende HTTPS-Verbindungen zum konfigurierten AutoScout24-API-Host sind durch die Hosting-Firewall und jede WAF vor der Website erlaubt. Siehe API-, Netzwerk- und SSL-Anforderungen.
[ ] Das CA-Bundle des Servers vertraut der Zertifikatskette des API-Hosts (keine SSL/TLS-Validierungsfehler während des Verbindungstests).
[ ] Das Verzeichnis wp-content/uploads/ ist für den Webserver-Benutzer beschreibbar, und wp-content/uploads/as24ci-logs/ ist für die Plugin-Protokollierung erstellt oder erstellbar.
[ ] Es ist ausreichend Speicherplatz für die geplante Medienbibliothek vorhanden (importierte Fahrzeugbilder, einschließlich aller WebP-Varianten, falls die Konvertierung aktiviert ist).
[ ] Die Serverressourcen (Arbeitsspeicher, maximale Ausführungszeit, Datenbank) sind für den erwarteten Katalog dimensioniert. Siehe Hosting-Anforderungen.
[ ] Alle Einträge auf der Checkliste vor der Installation sind bestätigt.
[ ] Car Market Hub → System & Help zeigt keine roten Badges.

2. Plugin-Konfiguration

[ ] Die Lizenz wurde unter Car Market Hub → Settings (Karte „License Activation“) aktiviert. Die Admin-Tabs des Plugins zeigen nicht mehr den Bildschirm „License required“, was bestätigt, dass die Premium-Bereiche freigeschaltet sind. Siehe Ersteinrichtung.
[ ] Die Haupteinstellungen des Plugins unter Car Market Hub → Settings wurden gespeichert und spiegeln die Produktionsumgebung wider, nicht die Staging-Umgebung.
[ ] API Base URL, Seller ID (eine oder mehrere), Client ID und Client Secret sind in der Datenquelle AutoScout24 unter Car Market Hub → Universal Import (der zentrale Knotenpunkt für alle Datenquellen) eingetragen. Das Client Secret wird verschlüsselt gespeichert. Wenn der Bestand des Autohauses aus einer anderen Live-Quelle wie carcuro stammt, bestätigen Sie, dass diese Quelle dort stattdessen als Connected markiert ist. Siehe Universal Import Reference.
[ ] Die Standardwährung (unter General Settings auf Settings) entspricht der Preiswährung des Autohauses.
[ ] Bildoptionen (ob Bilder importiert werden sollen, maximale Anzahl von Bildern pro Fahrzeug, optionale WebP-Konvertierung und -Qualität) sind bewusst eingestellt und wurden nicht auf unbestätigten Standardwerten belassen.
[ ] Der Standard-Beitragsstatus und der Standard-Beitragsautor für neu importierte Fahrzeuge sind für die Produktion geeignet.
[ ] Die Option Default pages ist entweder aktiviert (sodass die Seiten Cars, Compare Cars und Favorites erstellt werden) oder wird explizit durch die eigenen Seiten des Autohauses unter Verwendung der dokumentierten Shortcodes gelöst.
[ ] Filter, Mappings, Design und Styles sowie alle Layout-Anpassungen wurden anhand echter, importierter Fahrzeugdaten überprüft – nicht anhand von Platzhalter-Inhalten.

3. API-Verbindung

[ ] Der API-Verbindungstest unter Car Market Hub → Tools wird auf der Live-Website mit den Live-API-Zugangsdaten erfolgreich abgeschlossen. Siehe Verbindungstest.
[ ] Wenn mehrere Seller IDs konfiguriert sind, wurde ein Dry Run (Testlauf) unter Tools ausgeführt und liefert Daten für jede konfigurierte Seller ID.
[ ] In den Car Market Hub → Logs erscheinen für den letzten Verbindungstest und Testlauf keine Authentifizierungs-, Autorisierungs- oder SSL-Fehler.
[ ] Die Zugangsdaten in der Produktion sind nicht dieselben temporären Werte, die während der frühen Staging-Tests verwendet wurden; rotierte Produktions-Zugangsdaten wurden, falls zutreffend, erneut getestet.

4. Testimporte und Datenqualität

[ ] Mindestens ein manueller Import eines einzelnen Fahrzeugs über Car Market Hub → Car Importer war erfolgreich, einschließlich der Bildanhänge.
[ ] Ein vollständiger manueller Import über den Batch-Wizard unter Car Market Hub → Import & Limits wurde fehlerfrei abgeschlossen. Der Batch-Wizard unterstützt bei Bedarf das Pausieren, Fortsetzen und Abbrechen.
[ ] Die Anzahl der importierten Fahrzeuge entspricht den Erwartungen für die konfigurierten Seller IDs (Abgleich mit dem AutoScout24-Bestand des Autohauses).
[ ] Eine repräsentative Stichprobe importierter Fahrzeuge wurde überprüft auf: Titel, Preis, Währung, Kilometerstand, Ausstattungsliste, Bildanzahl und Bildreihenfolge.
[ ] Full Sync wird erst aktiviert, nachdem der Testimport bestätigt hat, dass alle erwarteten Fahrzeuge korrekt ankommen. Full Sync löscht dauerhaft lokale Fahrzeug-Beiträge und deren Bilder für alle Angebote, die nicht mehr von der API zurückgegeben werden.

5. Planung und Hintergrundverarbeitung

[ ] Das gewünschte automatische Importintervall (stündlich, alle 6 Stunden, zweimal täglich, täglich oder benutzerdefiniert) wurde gewählt und entspricht den Erwartungen des Autohauses an die Datenaktualisierung.
[ ] Wenn WP-Cron auf dem Host unzuverlässig ist (z. B. weil die Seitenaufrufe zu selten sind oder der Host interne Cron-Jobs drosselt), ist ein echter Server-Cron-Job für den token-gesicherten REST-Endpunkt des Plugins konfiguriert. Siehe Server Cron Setup und Cron-Jobs und Hintergrundverarbeitung.
[ ] Die Bild-Warteschlange (image queue) ist aktiviert, um Cron-Durchläufe bei großen Katalogen innerhalb der PHP-Timeouts zu halten. Der Warteschlangenstatus unter System & Help zeigt nach dem Testimport einen gesunden Fortschritt.
[ ] Die Einstellungen für die Cron-Robustheit (maximale Anzahl von Fahrzeugen pro Cron-Durchlauf) sind auf den Katalog und die PHP-Ausführungslimits des Hosts abgestimmt.
[ ] Das Verhalten des Token-Caches wurde überprüft: Ein neuer Test nach der Rotation der Zugangsdaten ist erfolgreich (bei Bedarf kann der Token-Cache unter Tools geleert werden).

6. Frontend und Kundenerfahrung

[ ] Die Archivseite Cars wird mit echten Fahrzeugen korrekt dargestellt, einschließlich Filtern, Paginierung, Sortierung und Bild-Thumbnails.
[ ] Mindestens eine einzelne Fahrzeugseite wurde vollständig überprüft: Galerie, Fahrzeug-Detailtabelle, Ausstattungsliste, Preisformatierung, Kontaktformular (mit der Einwilligungserklärung) und alle aktivierten optionalen Funktionen (Finanzierungsrechner, Probefahrt-Formular, Social Sharing).
[ ] Eine Einsendung über ein Test-Kontaktformular erscheint unter Car Market Hub → Leads und löst die konfigurierte Empfänger-E-Mail aus.
[ ] Wenn Suchaufträge (Search Alerts) aktiviert sind, wurde ein Test-Abonnement abgeschlossen, einschließlich der Double-Opt-In-Bestätigungs-E-Mail. Siehe Search Alerts Double Opt-In.
[ ] Wenn der AI Assistant aktiviert ist, wurden die KI-generierten Texte für mindestens ein Fahrzeug überprüft und sind für die Veröffentlichung geeignet.
[ ] Übersetzungen / Sprach-Strings im Frontend entsprechen der Sprache der Website; fehlende Strings wurden über den standardmäßigen WordPress-Übersetzungs-Workflow korrigiert. Siehe Translation and PoEdit Guide.

7. Rechtliches, Datenschutz und Einwilligung

[ ] Die Website verfügt über eine veröffentlichte Datenschutzerklärung, die die vom Plugin erfassten Daten abdeckt (Kontaktformulardaten, optionale Analytics-Ereignisse, optionale Suchauftrag-Abonnements). Siehe GDPR / DSGVO Notes und Data Storage Overview.
[ ] Die Beschriftung des Einwilligungs-Kontrollkästchens im Kontaktformular, der Pflichtfeld-Status und die sichtbaren Felder unter Car Market Hub → Leads stimmen mit der Datenschutzerklärung des Autohauses überein. Siehe Lead Data and Consent.
[ ] Wenn die Probefahrt-Buchung aktiviert ist, entsprechen die verfügbaren Wochentage, das tägliche Zeitfenster, die Slot-Dauer und die Sperrtage der tatsächlichen Verfügbarkeit des Autohauses.
[ ] Das Autohaus hat akzeptiert, dass importierte Lead- und Suchauftragsdaten in der WordPress-Datenbank gespeichert werden, und ist für alle Aufbewahrungs- oder Exportverpflichtungen nach geltendem Recht selbst verantwortlich.

8. Performance, Caching und SEO

[ ] Jeder Seiten- oder Objekt-Cache (serverseitiger Cache, CDN, Caching-Plugin) wurde so konfiguriert, dass das Fahrzeugarchiv und die Einzelfahrzeugseiten nach jedem Import aktuelle Daten anzeigen und Admin-Anfragen nicht aus dem Cache bedient werden.
[ ] Wenn ein CDN Bilder aus wp-content/uploads/ bereitstellt, sind Bild-Purges oder kurze Cache-Laufzeiten eingerichtet, damit neu importierte Bilder zeitnah sichtbar werden.
[ ] Die Website ist unter der endgültigen Live-Domain über HTTPS erreichbar, und die Optionen WordPress Site Address / WordPress Address verweisen auf diese Domain.
[ ] Die Website ist nicht auf „Suchmaschinen davon abhalten, diese Website zu indexieren“ eingestellt (es sei denn, dies ist die ausdrückliche Absicht des Autohauses).
[ ] Eine XML-Sitemap ist vorhanden (bereitgestellt durch den WordPress-Core oder durch ein SEO-Plugin) und die neuen Fahrzeug-URLs folgen der kanonischen Struktur des Autohauses.
[ ] In der Live-Konfiguration verbleiben keine Staging-URLs, Test-E-Mail-Adressen oder Test-Einwilligungstexte.

9. Betrieb, Überwachung und Support

[ ] Car Market Hub → Logs wurde geöffnet und das Rotationsverhalten ist verstanden. Das Protokollverzeichnis wp-content/uploads/as24ci-logs/ ist beschreibbar. Siehe Logging and Monitoring.
[ ] Ein Zeitplan für Routineprüfungen wurde mit dem Kunden vereinbart: tägliche Lead- und Importprüfung (Daily Operation), Weekly Maintenance und Monthly Maintenance.
[ ] Import Monitoring und Image Queue Maintenance werden von der Person verstanden, die die Website betreiben wird.
[ ] Ein Backup- und Wiederherstellungsverfahren ist dokumentiert und wurde mindestens einmal getestet. Siehe Backup and Restore.
[ ] Der Update-Kanal des Plugins ist vereinbart (Admin-Upload einer neuen ZIP-Datei oder SFTP-Austausch des Plugin-Ordners) und entspricht dem Update Process.
[ ] Ein dokumentierter Rollback-Plan existiert: wie die Planung deaktiviert wird, wie das Plugin ohne Datenverlust deaktiviert wird und wie bei Bedarf ein Backup wiederhergestellt wird.
[ ] Der tägliche Betrieb wurde über die Rollen und Berechtigungen des Plugins an die entsprechenden Benutzer delegiert. Siehe Access Control and Capabilities.
[ ] Kontaktwege für den Support sind auf Kundenseite dokumentiert: Wer kümmert sich um WordPress-Probleme, wer kümmert sich um das Hosting, wer ist Inhaber des AutoScout24-API-Kontos und wie erfolgt im Bedarfsfall eine Eskalation an AD Promotion.
[ ] Die Informationen, die zum Eröffnen eines Support-Tickets benötigt werden, sind im Voraus bekannt. Siehe Support Information Checklist.

10. Letzte Schritte vor dem Live-Gang

Erst wenn jeder zutreffende Punkt oben abgehakt ist:

Führen Sie den Verbindungstest auf der Live-Website als letzte Plausibilitätsprüfung erneut aus.
Aktivieren Sie die automatischen Importe unter Car Market Hub → Import & Limits mit dem gewählten Intervall.
Stoßen Sie einen Import manuell an (oder warten Sie auf den ersten geplanten Durchlauf) und beobachten Sie die Logs, bis er abgeschlossen ist.
Überprüfen Sie das Frontend auf der Live-Domain erneut, einschließlich einer echten Kontaktformular-Einsendung und, falls zutreffend, eines echten Suchauftrag-Abonnements.
Übergeben Sie das System an die vereinbarte Überwachungsroutine und informieren Sie den Kunden, dass die Importe nun live sind.

Konfigurations-Referenz

Dieses Dokument führt keine neuen Einstellungen ein; es verweist nur auf die an anderer Stelle dokumentierte Konfiguration. Die relevantesten Seiten sind:

API-Verbindungsfelder und Datenquellen: siehe Einrichtung der API-Zugangsdaten und die Universal Import Reference.
Importplanung und Limits: siehe Ersteinrichtung (Schritt 5) und Cron-Jobs und Hintergrundverarbeitung.
Lead- und Einwilligungsfelder: siehe Lead Data and Consent.
Server-Cron und externe Trigger: siehe Server Cron Setup.

Betriebliche Hinweise

Reversibilität. Das Deaktivieren des automatischen Zeitplans unter Import & Limits stoppt neue Importe, ohne bereits importierte Fahrzeuge zu entfernen. Das Deaktivieren des Plugins deaktiviert seine Funktionen, behält jedoch importierte Fahrzeuge, Optionen, Leads und Analytics-Daten in der Datenbank. Daten werden bei der Deinstallation nur dann entfernt, wenn die entsprechende Bereinigungseinstellung aktiviert ist. Siehe Deinstallation und Datenbereinigung.
Full Sync beim Start. Es ist im Allgemeinen sicherer, den Live-Gang mit deaktiviertem Full Sync zu starten, einen vollständigen Importzyklus zu beobachten und Full Sync erst dann zu aktivieren, wenn der importierte Bestand konsistent vollständig ist. Eine vorzeitige Aktivierung von Full Sync kann Fahrzeuge dauerhaft löschen, die lediglich in einer vorübergehenden API-Antwort fehlten. Überprüfen Sie dieses Verhalten im Zweifelsfall in der aktuellen Plugin-Version vor der Veröffentlichung.
Domain- und URL-Änderungen. Wenn die Website auf einer neuen Domain live geschaltet wird (z. B. beim Wechsel von staging.example.com zu www.example.com), stellen Sie sicher, dass die WordPress-URLs, jegliche Caching-Ebene und alle externen Dienste, die auf die Website verlinken, aufeinander abgestimmt sind, bevor Sie Importe aktivieren. Siehe Migration von Staging zu Live.
Stille Live-Gänge. Bei sensiblen Live-Gängen sollten Sie in Erwägung ziehen, automatische Importe außerhalb der Geschäftszeiten zu aktivieren und den ersten Cron-Zyklus über die Ansicht Protokolle zu beobachten, bevor Kunden die neuen Seiten erreichen können.
Übergabe der Dokumentation. Stellen Sie dem Kunden die relevanten Seiten aus dem Benutzerhandbuch und dem Bereich Betrieb und Wartung zur Verfügung, damit er die täglichen Arbeitsabläufe versteht, für die er die Verantwortung übernimmt.

Fehlerbehebung

Symptom beim Live-Gang	Wahrscheinliche Ursache	Was zu prüfen ist
Verbindungstest schlägt auf der Live-Umgebung fehl, war aber auf der Staging-Umgebung erfolgreich.	Die Live-Zugangsdaten weichen ab, das Live-Netzwerk ist restriktiver oder der Live-Server verfügt über ein anderes CA-Bundle.	Tragen Sie die Zugangsdaten erneut ein, bestätigen Sie ausgehende HTTPS-Verbindungen zum API-Host mit dem Hosting-Anbieter und prüfen Sie SSL-Fehler. Siehe Verbindungstest und API-Verbindungsfehler.
Geplante Importe starten nach Aktivierung des Zeitplans nicht.	WP-Cron ist auf dem Host deaktiviert oder gedrosselt.	Konfigurieren Sie einen Server-Cron-Job für den REST-Endpunkt des Plugins. Siehe Einrichtung des Server-Crons und Cron-Fehler.
Der erste Live-Import löscht Fahrzeuge, die eigentlich noch existieren sollten.	Full Sync wurde aktiviert, bevor der importierte Bestand als vollständig bestätigt wurde.	Deaktivieren Sie Full Sync, stellen Sie die betroffenen Fahrzeuge aus dem Backup wieder her und aktivieren Sie Full Sync erst wieder, nachdem Sie einen vollständigen, fehlerfreien Importzyklus beobachtet haben.
Fahrzeugseiten werden ohne Bilder gerendert oder Bilder erscheinen nur nach und nach.	Die Bildwarteschlange wird im Hintergrund verarbeitet (erwartet) oder PHP-Timeouts unterbrechen die Downloads.	Überwachen Sie den Status der Bildwarteschlange unter System & Hilfe; lösen Sie Bildwarteschlange jetzt ausführen aus. Siehe Fehler beim Bildimport und Wartung der Bildwarteschlange.
Lead-E-Mails werden nicht zugestellt.	Die Website kann keine E-Mails senden, die Empfängeradresse ist falsch oder der Host blockiert ausgehendes SMTP.	Überprüfen Sie die Empfänger-E-Mail-Adresse unter Leads und die Konfiguration für ausgehende E-Mails der Website. Siehe E-Mail- und Lead-Fehler.
Gecachte Seiten zeigen weiterhin den alten Fahrzeugbestand an.	Der Seitencache oder das CDN liefert veraltete Inhalte aus.	Konfigurieren Sie eine Cache-Invalidierung oder kürzere TTLs für die betroffenen URLs.
Besucher landen nach dem Live-Gang auf Staging-URLs.	Veraltete Links, fehlerhafte WordPress-Website-URL oder DNS-Einträge noch nicht propagiert.	Bestätigen Sie die Optionen für WordPress-Adresse und WordPress-Adresse und überprüfen Sie die DNS-Propagierung für die Live-Domain.

Für eine umfassendere symptombasierte Diagnose siehe den Bereich Fehlerbehebung.