Dokumentation · Erste Schritte

Go-Live-Checkliste

Dieses Dokument ist die Checkliste für die Produktionsreife 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 überprüft wird, ob 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 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 Produktionswebsite ü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-Provider 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 explizit akzeptiert werden, bevor die Website für den echten Datenverkehr mit Live-Importen freigegeben wird.

Anforderungen vor dem Durcharbeiten der Checkliste

Bestätigen Sie, dass alle folgenden Punkte erfüllt sind, bevor Sie diese Checkliste öffnen:

Das Plugin ist auf der Produktionswebsite installiert und aktiviert (siehe Installationsanleitung).
Eine konfigurierte Staging-Umgebung ist vorhanden und dieselbe Konfiguration wurde auf der Produktion repliziert (siehe Migration von Staging zu Live).
Die API-Zugangsdaten für das Konto der Garage sind über einen sicheren Kanal verfügbar (siehe Einrichtung der API-Zugangsdaten, AutoScout24 API-Einrichtung, Externe API-Zugangsdaten).
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 Datenbankanforderungen.
[ ] 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 Mediathek 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 & Hilfe zeigt keine roten Badges.

2. Plugin-Konfiguration

[ ] Die Lizenz wurde unter Car Market Hub → Einstellungen (Karte "Lizenzaktivierung") aktiviert. Die Admin-Tabs des Plugins zeigen nicht mehr den Bildschirm "Lizenz erforderlich", was bestätigt, dass die Premium-Bereiche freigeschaltet sind. Siehe Erste Einrichtung.
[ ] Die Haupteinstellungen des Plugins unter Car Market Hub → Einstellungen wurden gespeichert und spiegeln die Produktionsumgebung wider, nicht das Staging.
[ ] API-Basis-URL, Seller ID (eine oder mehrere), Client ID und Client Secret sind unter Einstellungen ausgefüllt.
[ ] Die Standardwährung 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 unbestätigten Standardwerten belassen.
[ ] Der Standard-Beitragsstatus und der Standard-Beitragsautor für neu importierte Fahrzeuge sind für die Produktion geeignet.
[ ] Die Option Standardseiten ist entweder aktiviert (sodass die Seiten Fahrzeuge, Fahrzeuge vergleichen und Favoriten erstellt werden) oder wird explizit durch die eigenen Seiten der Garage unter Verwendung der dokumentierten Shortcodes gehandhabt.
[ ] Filter, Mappings, Design und Stile 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 Produktions-API-Zugangsdaten erfolgreich abgeschlossen. Siehe Verbindungstest.
[ ] Wenn mehrere Seller IDs konfiguriert sind, wurde ein Testlauf unter Tools ausgeführt und liefert Daten für jede konfigurierte Seller ID.
[ ] In Car Market Hub → Protokolle 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 → Fahrzeug-Importer war erfolgreich, einschliesslich der Bildanhänge.
[ ] Ein vollständiger manueller Import über den Batch-Assistenten unter Car Market Hub → Import & Limits wurde fehlerfrei abgeschlossen. Der Batch-Assistent 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 der Garage).
[ ] Eine repräsentative Stichprobe importierter Fahrzeuge wurde überprüft auf: Titel, Preis, Währung, Kilometerstand, Ausstattungsliste, Bildanzahl und Bildreihenfolge.
[ ] Der Full Sync wird erst aktiviert, nachdem der Testimport bestätigt hat, dass alle erwarteten Fahrzeuge korrekt ankommen. Der 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 für den mit einem Token gesicherten REST-Endpunkt des Plugins konfiguriert. Siehe Einrichtung des Server-Cronjobs und Cron und Hintergrundverarbeitung.
[ ] Die Bildwarteschlange ist aktiviert, um Cron-Ausführungen bei grossen Katalogen innerhalb der PHP-Timeouts zu halten. Der Warteschlangenstatus unter System & Hilfe zeigt nach dem Testimport einen gesunden Fortschritt.
[ ] Die Einstellungen für die Cron-Robustheit (maximale Anzahl Fahrzeuge 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 Löschen des Token-Caches unter Tools).

6. Frontend und Kundenerlebnis

[ ] Die Archivseite Fahrzeuge wird mit echten Fahrzeugen korrekt dargestellt, einschliesslich Filter, Seitennummerierung, Sortierung und Bild-Vorschaubildern.
[ ] Mindestens eine einzelne Fahrzeugseite wurde durchgehend überprüft: Galerie, Fahrzeugdetailtabelle, Ausstattungsliste, Preisformatierung, Kontaktformular (mit der Einverständnis-Checkbox) und allfällige aktivierte optionale 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 abgeschlossen. Siehe Suchabos Double-Opt-In.
[ ] Wenn der AI Assistant aktiviert ist, wurden die KI-generierten Ausgaben für mindestens ein Fahrzeug überprüft und sind für die Veröffentlichung akzeptabel.
[ ] Übersetzungen / Sprach-Strings im Frontend entsprechen der Sprache der Website; fehlende Strings wurden über den standardmässigen WordPress-Übersetzungs-Workflow korrigiert. Siehe Übersetzungs- und PoEdit-Anleitung.

7. Rechtliches, Datenschutz und Einwilligung

[ ] Die Website verfügt über eine veröffentlichte Datenschutzerklärung, die die vom Plugin erhobenen Daten abdeckt (Kontaktformulardaten, optionale Analyse-Ereignisse, optionale Suchabo-Anmeldungen). Siehe Hinweise zur DSGVO und Übersicht zur Datenspeicherung.
[ ] Die Beschriftung der Einverständnis-Checkbox des Kontaktformulars, der Pflichtfeld-Status und die sichtbaren Felder unter Car Market Hub → Leads entsprechen der Datenschutzerklärung der Garage. Siehe Lead-Daten und Einwilligung.
[ ] 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 von wp-content/uploads/ bereitstellt, sind Bild-Bereinigungen 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 Website-Adresse / WordPress-Adresse 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 durch 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 → Protokolle wurde geöffnet und das Rotationsverhalten ist bekannt. Das Protokollverzeichnis wp-content/uploads/as24ci-logs/ ist beschreibbar. Siehe Protokollierung und Überwachung.
[ ] Ein Zeitplan für Routineprüfungen wurde mit dem Kunden vereinbart: tägliche Lead- und Importprüfung (Täglicher Betrieb), Wöchentliche Wartung und Monatliche Wartung.
[ ] Import-Überwachung und Wartung der Bildwarteschlange sind denjenigen bekannt, die die Website betreiben werden.
[ ] Ein Backup- und Wiederherstellungsverfahren ist dokumentiert und wurde mindestens einmal getestet. Siehe Backup und Wiederherstellung.
[ ] Der Update-Kanal des Plugins ist vereinbart (Admin-Upload einer neuen ZIP-Datei oder SFTP-Austausch des Plugin-Ordners) und entspricht dem Update-Prozess.
[ ] 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 Zugriffskontrolle und Berechtigungen.
[ ] Die Kontaktwege für den Support sind auf Kundenseite dokumentiert: Wer ist für WordPress-Probleme zuständig, wer für 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 Checkliste für Support-Informationen.

10. Letzte Schritte vor dem Go-Live

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.
Stossen Sie einen Import manuell an (oder warten Sie auf den ersten geplanten Durchlauf) und beobachten Sie die Protokolle, bis er abgeschlossen ist.
Überprüfen Sie das Frontend auf der Produktionsdomain erneut, einschliesslich des Absendens eines echten Kontaktformulars 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.

Konfigurationsreferenz

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

API-Verbindungsfelder: siehe Einrichtung der API-Zugangsdaten.
Importplanung und -limits: siehe Erste Einrichtung (Schritt 5) und Cron und Hintergrundverarbeitung.
Lead- und Einwilligungsfelder: siehe Lead-Daten und Einwilligung.
Server-Cron und externe Trigger: siehe Einrichtung des Server-Cronjobs.

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 Analysedaten in der Datenbank. Daten werden bei der Deinstallation nur gelöscht, wenn die entsprechende Bereinigungsoption 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, 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 ausserhalb der Geschäftszeiten zu aktivieren und den ersten Cron-Zyklus über die Ansicht Protokolle zu überwachen, bevor Kunden die neuen Seiten aufrufen können.
Dokumentationsübergabe. Stellen Sie dem Kunden die relevanten Seiten aus dem Benutzerhandbuch und dem Bereich Betrieb und Wartung zur Verfügung, damit er den täglichen Arbeitsablauf versteht, für den 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 Staging erfolgreich.	Die Live-Zugangsdaten weichen ab, das Live-Netzwerk ist restriktiver oder der Live-Server verfügt über ein anderes CA-Bundle.	Zugangsdaten erneut eingeben, ausgehendes HTTPS zum API-Host mit dem Hosting-Anbieter bestätigen und SSL-Fehler überprüfen. 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-Cronjob 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 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 die Cache-Invalidierung oder kürzere TTLs für die betroffenen URLs.
Besucher landen nach dem Live-Gang auf Staging-URLs.	Veraltete Links, falsche WordPress-Website-URL oder DNS noch nicht propagiert.	Bestätigen Sie die Optionen für WordPress Website-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.