Dokumentation · Erste Schritte

Go-Live-Checkliste

Dieses Dokument ist die Checkliste für die Produktionsbereitschaft von ADP Car Market Hub. Es fasst alle übergreifenden Punkte zusammen, die bestätigt 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 Erste Einrichtung, anstatt sie zu ersetzen: Die Erste Einrichtung 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, die/der eine neue ADP Car Market Hub-Bereitstellung für einen Kunden freigeben möchte.
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 grossen Plugin-Update durchführt.

Die Zielgruppe ist technisch: ein WordPress-Administrator mit vollem Back-Office-Zugriff, der (falls zutreffend) mit dem Hosting-Anbieter und der Person zusammenarbeitet, die den AutoScout24-API-Zugriff für die Garage besitzt.

Übersicht

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

Bereitschaft der Hosting- und PHP-Umgebung.
Korrekte API-Zugangsdaten im Besitz der Garage.
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 der Garage ü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 mit Live-Importen für den echten Datenverkehr freigegeben wird.

Anforderungen vor der Bearbeitung der Checkliste

Bestätigen Sie, 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 Produktion repliziert (siehe Staging to Live Migration).
Die API-Zugangsdaten für das Konto der Garage 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 (Garage, Agentur, Hosting) haben sich auf ein Go-Live-Zeitfenster 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 ist.

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- und Datenbank-Anforderungen.
[ ] Ausgehender HTTPS-Verkehr zum konfigurierten AutoScout24-API-Host ist 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 das Plugin-Logging erstellt oder erstellbar.
[ ] Es ist genügend Speicherplatz für die geplante Medienbibliothek vorhanden (importierte Fahrzeugbilder, einschliesslich allfälliger 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 Erste Schritte.
[ ] Die Haupteinstellungen des Plugins unter Car Market Hub → Settings wurden gespeichert und spiegeln die Produktionsumgebung wider, nicht das Staging.
[ ] 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 Hub für alle Datenquellen) eingetragen. Das Client Secret wird verschlüsselt gespeichert. Wenn der Fahrzeugbestand der Garage aus einer anderen Live-Quelle wie carcuro stammt, bestätigen Sie stattdessen, dass diese Quelle dort als Connected markiert ist. Siehe Universal Import Reference.
[ ] Die Standardwährung (unter General Settings bei Settings) entspricht der Preiswährung der Garage.
[ ] Die Bildoptionen (ob Bilder importiert werden sollen, maximale Anzahl Bilder pro Fahrzeug, optionale WebP-Konvertierung und -Qualität) sind bewusst gesetzt und nicht auf ungeprüften Standardwerten belassen worden.
[ ] 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 der Garage unter Verwendung der dokumentierten Shortcodes gelöst.
[ ] Filter, Mappings, Design und Styles sowie allfällige 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 produktiven 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 zurück.
[ ] In den Car Market Hub → Logs erscheinen für den jüngsten 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 den Car Market Hub → Car Importer war erfolgreich, einschliesslich 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 realen AutoScout24-Bestand der Garage).
[ ] Eine repräsentative Stichprobe der importierten 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 lokale Fahrzeug-Beiträge und deren Bilder dauerhaft für alle Angebote, die von der API nicht mehr 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 der Garage an die Datenaktualisierung.
[ ] Wenn WP-Cron auf dem Host unzuverlässig ist (beispielsweise weil die Seitenaufrufe zu selten sind oder der Host interne Cronjobs drosselt), ist ein echter Server-Cronjob auf den token-gesicherten REST-Endpunkt des Plugins konfiguriert. Siehe Server Cron Setup und Cron und Hintergrundverarbeitung.
[ ] Die Bildwarteschlange (image queue) ist aktiviert, um Cron-Läufe bei grossen Katalogen innerhalb der PHP-Timeouts zu halten. Der Warteschlangenstatus unter System & Help zeigt nach dem Testimport einen gesunden Fortschritt.
[ ] Die Einstellungen zur Cron-Robustheit (maximale Anzahl Fahrzeuge pro Cron-Lauf) 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 Kundenerlebnis

[ ] Die Archivseite Cars wird mit echten Fahrzeugen korrekt dargestellt, einschliesslich Filtern, Seitennummerierung, Sortierung und Bild-Thumbnails.
[ ] Mindestens eine einzelne Fahrzeugseite wurde durchgehend überprüft: Galerie, Fahrzeugdetailtabelle, Ausstattungsliste, Preisformatierung, Kontaktformular (mit der Einwilligung-Checkbox) und alle aktivierten optionalen Funktionen (Finanzierungsrechner, Probefahrt-Formular, Social Sharing).
[ ] Das Absenden eines Test-Kontaktformulars erscheint unter Car Market Hub → Leads und löst die konfigurierte Empfänger-E-Mail aus.
[ ] Wenn Suchabos aktiviert sind, wurde eine Test-Anmeldung einschliesslich der Double-Opt-In-Bestätigungs-E-Mail erfolgreich durchgeführt. Siehe Search Alerts Double Opt-In.
[ ] Wenn der AI Assistant aktiviert ist, wurden die KI-generierten Texte bei mindestens einem Fahrzeug überprüft und sind für die Veröffentlichung freigegeben.
[ ] Übersetzungen / Sprach-Strings im Frontend entsprechen der Sprache der Website; fehlende Strings wurden über den standardmässigen 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 erhobenen Daten abdeckt (Kontaktformulardaten, optionale Analytics-Ereignisse, optionale Suchabo-Anmeldungen). Siehe GDPR / DSGVO Notes und Data Storage Overview.
[ ] Die Beschriftung der Einwilligung-Checkbox des Kontaktformulars, der Pflichtfeld-Status und die sichtbaren Felder unter Car Market Hub → Leads stimmen mit der Datenschutzerklärung der Garage ü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 der Garage.
[ ] Die Garage hat zur Kenntnis genommen, dass importierte Lead- und Suchabo-Daten in der WordPress-Datenbank gespeichert werden, und ist für allfällige Aufbewahrungs- oder Exportpflichten 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 einzelnen Fahrzeugseiten nach jedem Import aktuelle Daten anzeigen und Admin-Anfragen nicht aus dem Cache bedient werden.
[ ] Wenn ein CDN Bilder aus wp-content/uploads/ ausliefert, sind Bild-Purges oder kurze Cache-Laufzeiten eingerichtet, damit neu importierte Bilder zeitnah sichtbar werden.
[ ] Die Website ist auf der endgültigen Produktionsdomain über HTTPS erreichbar, und die Optionen WordPress Site Address / WordPress Address weisen auf diese Domain.
[ ] Die Website ist nicht auf "Suchmaschinen davon abhalten, diese Website zu indexieren" eingestellt (ausser dies ist die ausdrückliche Absicht der Garage).
[ ] Eine XML-Sitemap ist vorhanden (bereitgestellt durch den WordPress-Core oder ein SEO-Plugin) und die neuen Fahrzeug-URLs folgen der kanonischen Struktur der Garage.
[ ] In der Produktionskonfiguration 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 bekannt. Das Log-Verzeichnis 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 sind der Person, die die Website betreiben wird, bekannt.
[ ] 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 im Bedarfsfall 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.
[ ] Die Support-Wege sind auf Kundenseite dokumentiert: Wer ist für WordPress-Probleme zuständig, wer betreut das Hosting, wer besitzt das AutoScout24-API-Konto und wie erfolgt im Bedarfsfall eine Eskalation an AD Promotion.
[ ] Die für die Eröffnung eines Support-Tickets benötigten Informationen sind im Voraus bekannt. Siehe Support Information Checklist.

10. Letzte Schritte zum Go-Live

Erst wenn jeder zutreffende Punkt oben abgehakt ist:

Führen Sie den Verbindungstest auf der Live-Website als letzte Funktionsprüfung erneut aus.
Aktivieren Sie die automatischen Importe unter Car Market Hub → Import & Limits mit dem gewählten Intervall.
Stossen Sie einen Import manuell an (oder warten Sie auf den ersten geplanten Lauf) und beobachten Sie die Logs, bis er abgeschlossen ist.
Überprüfen Sie das Frontend auf der Produktionsdomain erneut, einschliesslich einer echten Kontaktformular-Übermittlung und, falls zutreffend, einer echten Suchabo-Anmeldung.
Ü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 Erste Schritte (Schritt 5) und Cron 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 dessen Funktionen, behält jedoch importierte Fahrzeuge, Optionen, Leads und Analytics-Daten in der Datenbank. Daten werden bei der Deinstallation nur gelöscht, wenn die entsprechende Bereinigungsoption aktiviert ist. Siehe Uninstall and Data Cleanup.
Full Sync beim Start. Es ist generell 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, alle Caching-Ebenen und alle externen Dienste, die auf die Website verlinken, aufeinander abgestimmt sind, bevor Sie Importe aktivieren. Siehe Staging to Live Migration.
Stille Live-Gänge. Bei sensiblen Live-Gängen sollten Sie in Erwägung ziehen, automatische Importe ausserhalb der Geschäftszeiten zu aktivieren und den ersten Cron-Zyklus über die Ansicht Logs zu beobachten, bevor Kunden die neuen Seiten aufrufen können.
Dokumentationsübergabe. Stellen Sie dem Kunden die relevanten Seiten aus dem Benutzerhandbuch und dem Abschnitt Operations and Maintenance zur Verfügung, damit er die täglichen Arbeitsabläufe versteht, für die er die Verantwortung übernimmt.

Fehlerbehebung

Symptom beim Go-Live	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.	Geben 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 Connection Errors.
Geplante Importe starten nach der Aktivierung des Zeitplans nicht.	WP-Cron ist auf dem Host deaktiviert oder gedrosselt.	Konfigurieren Sie einen Server-Cronjob für den REST-Endpunkt des Plugins. Siehe Server Cron Setup und Cron Errors.
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 & Help; stossen Sie Run image queue now manuell an. Siehe Image Import Errors und Image Queue Maintenance.
Lead-E-Mails werden nicht zugestellt.	Die Website kann keine E-Mails senden, die Empfängeradresse ist falsch oder der Host blockiert ausgehenden SMTP-Verkehr.	Überprüfen Sie die Empfänger-E-Mail-Adresse unter Leads und die Konfiguration für den ausgehenden Mailversand der Website. Siehe Email and Lead Errors.
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 noch nicht propagiert.	Überprüfen Sie die Optionen für WordPress-Adresse und WordPress-Adresse und verifizieren Sie die DNS-Propagierung für die Live-Domain.

Für eine umfassendere symptombasierte Diagnose lesen Sie bitte den Abschnitt Troubleshooting.