DocumentaciónAEM Sites Optimizer

Configuración de Preflight

Last update: Thu Oct 09 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

La identificación de la oportunidad de comprobación preliminar de AEM Sites Optimizer requiere la configuración de la extensión de comprobación preliminar en el editor universal, la vista previa basada en documentos o AEM Cloud Service para ejecutar auditorías de comprobaciones en las páginas antes de publicarlas.

Habilitar el acceso de los usuarios

Para usar la extensión de comprobaciones, asegúrese de que el usuario esté asignado al menos a uno de los siguientes perfiles de producto de AEM Sites Optimizer en Adobe Admin Console:

  • AEM Sites Optimizer: sugerencia automática de usuario
  • AEM Sites Optimizer: optimización automática del usuario

Habilitar la extensión de comprobaciones

Editor universal

Para configurar la comprobación preliminar en el editor universal, siga estos pasos:

  1. Abra Extension Manager en:
    https://experience.adobe.com/#/@org/aem/extension-manager/universal-editor

  2. Busque la extensión de comprobaciones de AEM Sites Optimizer y envíe una solicitud para habilitarla.

  3. El equipo de Adobe AEM revisará y habilitará la extensión para su organización.

  4. Una vez habilitada la extensión, abra una página en el Editor universal, por ejemplo:
    https://author-p12345-e123456.adobeaemcloud.com/ui#/@org/aem/universal-editor/canvas/author-p12345-e123456.adobeaemcloud.com/content/en/example/home.html

  5. La extensión de Preflight aparecerá en el panel lateral.

  6. Seleccione la extensión Preflight en la barra lateral para iniciar una auditoría Preflight de la página actual.

Creación basada en documentos

Para configurar la comprobación preliminar para la creación basada en documentos, siga estos pasos:

  1. Añada la siguiente configuración a /tools/sidekick/config.json en el repositorio de GitHub de su proyecto de Edge Delivery Services:

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

  2. Cree un nuevo archivo /tools/sidekick/aem-sites-optimizer-preflight.js y añada el siguiente contenido:

    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 });
  }
}());

  3. Actualice la función loadLazy() en /scripts/scripts.js para importar el script de comprobación preliminar para las direcciones URL de vista previa:

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

  4. Abra la dirección URL de vista previa (*.aem.page) de la página que desea auditar.

  5. En Sidekick, haga clic en el botón Preflight para iniciar la auditoría de la página actual.

Editor de página de AEM Sites

Para utilizar la comprobación preliminar en el editor de páginas de AEM Sites, puede crear un bookmarklet en el explorador web. Siga estos pasos:

  1. Muestre la Barra de marcadores en el explorador web:

    • Pulse Ctrl+Mayús+B (Windows) o Cmd+Mayús+B (Mac).

!. Cree un nuevo marcador en el explorador:

  • Haga clic con el botón derecho en la barra de marcadores y seleccione Nueva página  o  Añadir marcador.
  • En el campo Dirección (URL), pegue el siguiente código:
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);})();

  1. Asigne un nombre al marcador Comprobación preliminar (o cualquier nombre que prefiera).

  2. Abra la URL de vista previa (*.aem.page) de la página que desea auditar en el Editor de páginas de AEM Sites.

  3. Haga clic en el marcador Comprobación preliminar de la barra de marcadores para iniciar la auditoría de la página actual.

Prácticas recomendadas

Cuando ejecute auditorías de comprobaciones preliminares, tenga en cuenta las siguientes directrices:

  • Ejecute siempre auditorías en páginas de ensayo o vista previa antes de publicar en producción.
  • Priorice la resolución de problemas de alto impacto, como vínculos rotos, etiquetas H1 que faltan o vínculos no seguros.
  • Asegúrese de que la autenticación esté habilitada para los entornos de ensayo protegidos antes de ejecutar auditorías.
  • Revise y aplique recomendaciones de etiquetas meta para mejorar el rendimiento de SEO.
recommendation-more-help
06ed00c2-5d76-4212-b3f1-d58571bfacb8