Preflight-Setup

Letzte Aktualisierung: 1. August 2026

Um Preflight ausführen zu können, muss es in Ihrer Authoring-Umgebung eingerichtet werden. Sie können Preflight für den universellen Editor, die dokumentbasierte Bearbeitung, den AEM Sites-Seiteneditor oder Adobe Managed Services einrichten, damit Sie Preflight-Prüfungen auf Ihren Seiten durchführen können, bevor sie veröffentlicht werden.

Aktivieren des Benutzerzugriffs

Um Preflight zu verwenden, stellen Sie sicher, dass Ihr Benutzer mindestens einem der folgenden AEM Sites Optimizer-Produktprofile in Adobe Admin Console zugewiesen ist:

AEM Sites Optimizer – Benutzende automatisch vorschlagen
AEM Sites Optimizer – Benutzende automatisch optimieren

Preflight aktivieren

Universeller Editor

Gehen Sie wie folgt vor, um Preflight im universellen Editor einzurichten:

Öffnen Sie den Extension Manager unter:
https://experience.adobe.com/#/@org/aem/extension-manager/universal-editor
Suchen Sie die Erweiterung AEM Sites Optimizer Preflight.
Die Systemadmins der Organisation müssen diese Erweiterung aktivieren.
Nachdem die Erweiterung aktiviert ist, öffnen Sie eine Seite im universellen Editor, z. B.:
https://author-p12345-e123456.adobeaemcloud.com/ui#/@org/aem/universal-editor/canvas/author-p12345-e123456.adobeaemcloud.com/content/en/example/home.html
Die Preflight-Erweiterung wird in der Seitenleiste angezeigt.
Wählen Sie in Seitenleiste die Preflight-Erweiterung) aus, um Preflight für die aktuelle Seite zu öffnen.

Dokumentenbasiertes Authoring

Gehen Sie wie folgt vor, um Preflight für das dokumentenbasierte Authoring einzurichten:

Fügen Sie folgende Konfiguration zum /tools/sidekick/config.json im GitHub-Repository Ihres Edge Delivery Services-Projekts hinzu:

code language-json
`{ "plugins": [ { "id": "preflight", "titleI18n": { "en": "Preflight" }, "environments": ["preview"], "event": "preflight" } ] }`

Erstellen Sie eine neue Datei mit dem Namen /tools/sidekick/aem-sites-optimizer-preflight.js und fügen Sie den folgenden Inhalt hinzu:

code language-javascript

(function () {
  let isAEMSitesOptimizerPreflightAppLoaded = false;
  function loadAEMSitesOptimizerPreflightApp() {
    const script = document.createElement('script');
    script.src = 'https://experience.adobe.com/solutions/OneAdobe-aem-sites-optimizer-preflight-mfe/static-assets/resources/sidekick/client.js?source=plugin';
    script.onload = function () {
      isAEMSitesOptimizerPreflightAppLoaded = true;
    };
    script.onerror = function () {
      console.error('Error loading AEMSitesOptimizerPreflightApp.');
    };
    document.head.appendChild(script);
  }

  function handlePluginButtonClick() {
    if (!isAEMSitesOptimizerPreflightAppLoaded) {
      loadAEMSitesOptimizerPreflightApp();
    }
  }

  // Sidekick V1 extension support
  const sidekick = document.querySelector('helix-sidekick');
  if (sidekick) {
    sidekick.addEventListener('custom:preflight', handlePluginButtonClick);
  } else {
    document.addEventListener('sidekick-ready', () => {
      document.querySelector('helix-sidekick')
        .addEventListener('custom:preflight', handlePluginButtonClick);
    }, { once: true });
  }

  // Sidekick V2 extension support
  const sidekickV2 = document.querySelector('aem-sidekick');
  if (sidekickV2) {
    sidekickV2.addEventListener('custom:preflight', handlePluginButtonClick);
  } else {
    document.addEventListener('sidekick-ready', () => {
      document.querySelector('aem-sidekick')
        .addEventListener('custom:preflight', handlePluginButtonClick);
    }, { once: true });
  }
}());

Aktualisieren Sie die loadLazy()-Funktion in /scripts/scripts.js, um das Preflight-Skript für Vorschau-URLs zu importieren:

code language-javascript
`if (window.location.href.includes('.aem.page')) { import('../tools/sidekick/aem-sites-optimizer-preflight.js'); }`

Öffnen Sie die Vorschau-URL (*.aem.page) der Seite, die Sie prüfen möchten.
Klicken Sie in Sidekick auf die Schaltfläche Preflight, um Preflight für die aktuelle Seite zu öffnen.

AEM-Sites – Seiteneditor

Wenn Ihre Autorenumgebung AEM 2026.7.0 (Version 27083) oder höher ausführt, ist Preflight in den AEM Sites-Seiteneditor integriert und es ist keine Lesezeichenliste erforderlich. Führen Sie die folgenden Schritte aus:

Öffnen Sie die zu prüfende Seite im AEM Sites-Seiteneditor.
Wählen Sie in der Editor-Symbolleiste das Preflight-Symbol (die unten hervorgehobene Wiedergabeschaltfläche) aus, um das Preflight-Bedienfeld für die aktuelle Seite zu öffnen.

{align="center"}

note
NOTE
Wird das Symbol Preflight in der Symbolleiste nicht angezeigt? Überprüfen Sie Folgendes:
Unterstützte Version - Für die integrierte Schaltfläche ist AEM 2026.7.0 (Version 27083) oder höher erforderlich. Verwenden Sie in früheren Versionen die unten stehende Lesezeichenmethode. Rollout - Die integrierte Schaltfläche wird für Organisationen in Phasen aktiviert, sodass sie Ihre Organisation möglicherweise noch nicht erreicht hat, auch nicht bei einer unterstützten Version. Bis dahin können Sie die unten stehende Lesezeichenmethode verwenden oder sich an Adobe oder Ihren Administrator wenden. Seitenzugriff - Die Schaltfläche wird nur angezeigt, wenn Sie Bearbeitungszugriff auf die Seite haben. Benutzerzugriff - Bestätigen Sie, dass Ihrem Benutzer das Profil AEM Sites Optimizer - Benutzer automatisch vorschlagen oder AEM Sites Optimizer - Benutzer automatisch optimieren. Siehe Benutzerzugriff aktivieren.

Um Preflight im AEM Sites-Seiteneditor in früheren AEM-Versionen zu verwenden, können Sie eine Lesezeichenliste in Ihrem Webbrowser erstellen. Führen Sie die folgenden Schritte aus:

Zeigen Sie Ihre Lesezeichenleiste in Ihrem Webbrowser an:
- Drücken Sie Strg+Umschalt+B (Windows) oder Befehl+Umschalt+B (Mac).

Erstellen Sie ein neues Lesezeichen in Ihrem Browser:

Klicken Sie mit der rechten Maustaste auf die Lesezeichenleiste und wählen Sie Neue Seite oder Lesezeichen hinzufügen aus.
Fügen Sie im Feld Adresse (URL) den folgenden Code ein:

code language-javascript

javascript:(function(){const script=document.createElement('script');script.src='https://experience.adobe.com/solutions/OneAdobe-aem-sites-optimizer-preflight-mfe/static-assets/resources/sidekick/client.js?source=bookmarklet&target-source=aem-cloud-service';document.head.appendChild(script);})();

Nennen Sie das Lesezeichen Preflight (oder verwenden Sie einen beliebigen Namen, den Sie bevorzugen).
Öffnen Sie die Vorschau-URL (*.aem.page) der Seite, die Sie im AEM Sites-Seiteneditor prüfen möchten.
Klicken Sie auf Preflight Lesezeichen in Ihrer Lesezeichenleiste, um Preflight für die aktuelle Seite zu öffnen.

Adobe Managed Services

note important
IMPORTANT
Es werden nur Adobe Managed Services (AMS)-Umgebungen unterstützt, die Adobe Identity Provider (IMS) für die Authentifizierung auf der AEM-Autoreninstanz verwenden. Preflight funktioniert nicht, wenn Ihr Unternehmen einen anderen Identitätsanbieter für die AMS-Authentifizierung verwendet.

Um Preflight im AEM Sites-Seiteneditor in einer AMS-Umgebung zu verwenden, erstellen Sie eine Lesezeichenliste in Ihrem Webbrowser, indem Sie die folgenden Schritte ausführen:

Zeigen Sie Ihre Lesezeichenleiste in Ihrem Webbrowser an:
- Drücken Sie Strg+Umschalt+B (Windows) oder Befehl+Umschalt+B (Mac).

Erstellen Sie ein neues Lesezeichen in Ihrem Browser:

Klicken Sie mit der rechten Maustaste auf die Lesezeichenleiste und wählen Sie Neue Seite oder Lesezeichen hinzufügen aus.
Fügen Sie im Feld Adresse (URL) den folgenden Code ein:

code language-javascript

javascript:(function(){const script=document.createElement('script');script.src='https://experience.adobe.com/solutions/OneAdobe-aem-sites-optimizer-preflight-mfe/static-assets/resources/sidekick/client.js?source=bookmarklet&target-source=ams';document.head.appendChild(script);})();

Nennen Sie das Lesezeichen Preflight (oder verwenden Sie einen beliebigen Namen, den Sie bevorzugen).
Öffnen Sie die zu prüfende Seite im AEM Sites-Seiteneditor.
Klicken Sie auf Preflight Lesezeichen in Ihrer Lesezeichenleiste, um Preflight für die aktuelle Seite zu öffnen.

Best Practices

Beachten Sie beim Ausführen von Preflight-Audits die folgenden Richtlinien:

Führen Sie Audits immer für Staging- oder Vorschauseiten durch, bevor Sie sie in der Produktion veröffentlichen.
Priorisieren Sie die Behebung von schwerwiegenden Problemen ( z. B. fehlerhafte Links, fehlende H1-Tags oder unsichere Links).
Stellen Sie sicher, dass für Staging-Umgebungen die Authentifizierung aktiviert ist, bevor Sie Audits ausführen.
Überprüfen und wenden Sie Meta-Tag-Empfehlungen an, um die SEO-Leistung zu verbessern.

recommendation-more-help

experience-manager-sites-optimizer-help-main-toc