DocumentaçãoAEMAEM Sites Optimizer

Configurações de simulação

Última atualização: 1 de dezembro de 2025

A identificação de oportunidades de simulação do AEM Sites Optimizer requer a configuração da extensão de simulação. Você pode configurá-la no Editor universal, na Visualização baseada em documento ou no AEM Cloud Service para realizar auditorias de simulação nas suas páginas antes da publicação.

Habilitar acesso do usuário

Para usar a extensão do Preflight, verifique se o usuário está atribuído a pelo menos um dos seguintes perfis de produto do AEM Sites Optimizer no Adobe Admin Console:

  • AEM Sites Optimizer: sugerir usuário automaticamente
  • AEM Sites Optimizer: otimizar usuário automaticamente

Habilitar a extensão de simulação

Universal Editor

Para configurar a simulação no Universal Editor, siga estas etapas:

  1. Abra o Extension Manager em:
    https://experience.adobe.com/#/@org/aem/extension-manager/universal-editor
  2. Localize a Extensão AEM Sites Optimizer Preflight.
  3. O administrador de sistema da organização precisará habilitar essa extensão.
  4. Após habilitar a extensão, abra uma página no Universal Editor, como, por exemplo:
    https://author-p12345-e123456.adobeaemcloud.com/ui#/@org/aem/universal-editor/canvas/author-p12345-e123456.adobeaemcloud.com/content/en/example/home.html
  5. A Extensão do Preflight aparece no painel lateral.
  6. Selecione a Extensão de simulação no painel lateral para iniciar a Auditoria de simulação da página atual.
Criação baseada em documentos

Para configurar a simulação para criação baseada em documentos, siga estas etapas:

  1. Adicione a seguinte configuração a /tools/sidekick/config.json no repositório do GitHub do seu projeto do Edge Delivery Services:

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

  2. Crie um novo arquivo /tools/sidekick/aem-sites-optimizer-preflight.js e adicione o seguinte conteúdo:

    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. Atualize a função loadLazy() em /scripts/scripts.js para importar o script de simulação para URLs de pré-visualização:

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

  4. Abra o URL de visualização (*.aem.page) da página que deseja auditar.

  5. No Sidekick, clique no botão Simulação para iniciar a auditoria da página atual.

Editor de páginas do AEM Sites

Para usar a simulação no editor de páginas do AEM Sites, você pode criar um marcador no seu navegador da web. Siga estas etapas:

  1. Exiba a Barra de Favoritos no seu navegador da Web:

    • Pressione Ctrl+Shift+B (Windows) ou Cmd+Shift+B (Mac).

  2. Crie um novo marcador no seu navegador:

    • Clique com o botão direito do mouse na barra de marcadores e selecione Nova página ou Adicionar marcador.
    • No campo Endereço (URL), cole o seguinte 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);})();

  3. Nomeie o marcador Simulação (ou qualquer nome que preferir).

  4. Abra o URL de visualização (*.aem.page) da página que você deseja auditar no Editor de páginas do AEM Sites.

  5. Clique no marcador Simulação, na barra de marcadores, para iniciar a auditoria da página atual.

Adobe Managed Services
note important
IMPORTANT
Somente os ambientes do Adobe Managed Services (AMS) que usam o Provedor de identidade (IMS) da Adobe para autenticação no AEM Author são compatíveis. O Preflight não funcionará se sua organização usar qualquer outro provedor de identidade para autenticação AMS.

Para usar o Preflight no editor de páginas do AEM Sites em um ambiente AMS, crie um bookmarklet no seu navegador da Web, seguindo estas etapas:

  1. Exiba a Barra de marcadores do seu navegador da web:

    • Pressione Ctrl+Shift+B (Windows) ou Cmd+Shift+B (Mac).

  2. Crie um novo marcador no seu navegador:

    • Clique com o botão direito do mouse na barra de marcadores e selecione Nova página ou Adicionar marcador.
    • No campo Endereço (URL), cole o seguinte 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=ams';document.head.appendChild(script);})();

  3. Nomeie o marcador Simulação (ou qualquer nome que preferir).

  4. Abra a página que deseja auditar no editor de páginas do AEM Sites.

  5. Clique no marcador Simulação, na barra de marcadores, para iniciar a auditoria da página atual.

Práticas recomendadas

Ao executar auditorias de simulação, lembre-se das seguintes diretrizes:

  • Sempre execute auditorias em páginas de preparo ou pré-visualização antes de publicar na produção.
  • Priorize a resolução de problemas de alto impacto, como links corrompidos, tags H1 ausentes ou links inseguros.
  • Certifique-se de que a autenticação esteja ativada nos ambientes de teste protegidos antes de executar auditorias.
  • Revise e aplique as recomendações de metatags para melhorar o desempenho da SEO.
recommendation-more-help
experience-manager-sites-optimizer-help-main-toc