Preflight-Setup
Zur Identifizierung von AEM Sites Optimizer Preflight-Opportunitys muss die Preflight-Erweiterung eingerichtet werden. Sie können sie entweder im universellen Editor, in der dokumentbasierten Vorschau oder in AEM Cloud Service einrichten, damit Sie Preflight-Prüfungen auf Ihren Seiten durchführen können, bevor sie veröffentlicht werden.
Aktivieren des Benutzerzugriffs
Um die Preflight-Erweiterung 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
Aktivieren der Preflight-Erweiterung
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 nach der AEM Sites Optimizer Preflight-Erweiterung und senden Sie eine Anfrage, um sie zu aktivieren.
-
Das Adobe AEM Team überprüft und aktiviert die Erweiterung für Ihr Unternehmen.
-
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.
-
Wenn Sie in der Seitenleiste auf die Preflight-Erweiterung klicken, wird das Preflight-Audit für die aktuelle Seite gestartet.
Gehen Sie wie folgt vor, um Preflight für das dokumentenbasierte Authoring einzurichten:
-
Fügen Sie folgende Konfiguration zum
/tools/sidekick/config.jsonim 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.jsund 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 die Prüfung für die aktuelle Seite zu starten.
Um Preflight im Seiteneditor von AEM Sites zu verwenden, können Sie in Ihrem Webbrowser ein Bookmarklet erstellen. Führen Sie die folgenden Schritte aus:
-
Zeigt 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 überprüfen. -
Klicken Sie in Ihrer Lesezeichenleiste auf das Preflight-Lesezeichen, um den Audit für die aktuelle Seite zu starten.
| 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 in Ihrer Lesezeichenleiste auf das Preflight-Lesezeichen, um den Audit für die aktuelle Seite zu starten.
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 die -Authentifizierung für Staging-Umgebungen aktiviert ist, bevor Sie Audits ausführen.
- Überprüfen und wenden Sie Meta-Tag-Empfehlungen an, um die SEO-Leistung zu verbessern.