Preflight 설정

AEM Sites Optimizer Preflight 기회 식별을 사용하려면 Preflight 확장을 설정해야 합니다. Universal Editor, Document-Based Preview 또는 AEM Cloud Service에서 설정할 수 있으므로 페이지가 게시되기 전에 페이지에서 Preflight 감사를 실행할 수 있습니다.

사용자 액세스 활성화

Preflight 확장을 사용하려면 사용자가 Adobe Admin Console에서 다음 AEM Sites Optimizer 제품 프로필 중 하나 이상에 할당되었는지 확인하십시오.

  • AEM Sites Optimizer - 사용자 자동 제안
  • AEM Sites Optimizer - 사용자 자동 최적화

Preflight 확장 기능 활성화

범용 편집기

범용 편집기에서 Preflight 기능을 설정하려면 다음과 같은 단계를 따릅니다.

  1. 다음 위치에서 Extension Manager​를 엽니다.
    https://experience.adobe.com/#/@org/aem/extension-manager/universal-editor

  2. AEM Sites Optimizer Preflight 확장 기능​의 위치를 확인하고 활성화를 위한 요청을 제출합니다.

  3. Adobe AEM 팀​이(가) 조직의 확장을 검토하고 활성화합니다.

  4. 확장 기능 활성화 후 범용 편집기​에서 페이지를 하나 엽니다. 예:
    https://author-p12345-e123456.adobeaemcloud.com/ui#/@org/aem/universal-editor/canvas/author-p12345-e123456.adobeaemcloud.com/content/en/example/home.html

  5. Preflight 확장​이 쪽 레일​에 나타납니다.

  6. 사이드 레일에서 Preflight 확장 기능​을 선택하여 현재 페이지의 Preflight 감사​를 시작합니다.

문서 기반 작성

문서 기반 작성을 위해 Preflight를 설정하려면 다음과 같은 단계를 따릅니다.

  1. Edge Delivery Services 프로젝트의 GitHub 저장소에서 /tools/sidekick/config.json에 다음과 같은 구성을 추가합니다.

    code language-json
    {
      "plugins": [
        {
          "id": "preflight",
          "titleI18n": {
            "en": "Preflight"
          },
          "environments": ["preview"],
          "event": "preflight"
        }
      ]
    }
    
  2. 새 파일(/tools/sidekick/aem-sites-optimizer-preflight.js)을 만들고 다음과 같은 내용을 추가합니다.

    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. 다음과 같이 /scripts/scripts.js에서 loadLazy() 함수를 업데이트하여 미리보기 URL에 대한 Preflight 스크립트를 가져옵니다.

    code language-javascript
    if (window.location.href.includes('.aem.page')) {
       import('../tools/sidekick/aem-sites-optimizer-preflight.js');
    }
    
  4. 감사할 페이지의 미리 보기 URL(*.aem.page)을 엽니다.

  5. Sidekick​에서 Peflight 버튼을 클릭하여 현재 페이지에 대한 감사를 시작합니다.

AEM Sites 페이지 편집기

AEM Sites 페이지 편집기에서 Preflight를 사용하기 위해 웹 브라우저 내에 북마클릿을 만들 수 있습니다. 다음 단계를 수행하십시오.

  1. 웹 브라우저에 책갈피 표시줄 표시:

    • Ctrl+Shift+B(Windows) 또는 Cmd+Shift+B(Mac)를 누릅니다.
  2. 다음과 같이 브라우저에 새 북마크를 만듭니다.

    • 북마크 바를 마우스 오른쪽 버튼으로 클릭하고 새 페이지 또는 북마크 추가​를 선택합니다.
    • 주소(URL) 필드에 다음 코드를 붙여 넣습니다.
    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. 북마크의 이름을 Preflight(또는 원하는 이름)로 지정합니다.

  4. *.aem.pageAEM Sites 페이지 편집기​에서 감사할 페이지의 미리 보기 URL()을 엽니다.

  5. 북마크 바에서 Preflight 북마크를 클릭해 현재 페이지에 대한 감사를 시작합니다.

Adobe Managed Services
note important
IMPORTANT
Adobe 작성자의 인증에 Adobe IMS(ID Provider)를 사용하는 AEM Managed Services(AMS) 환경만 지원됩니다. 조직에서 AMS 인증에 다른 ID 공급자를 사용하는 경우 Preflight가 작동하지 않습니다.

AMS 환경에서 AEM Sites 페이지 편집기에서 Preflight를 사용하려면 다음 단계에 따라 웹 브라우저에서 북마클릿을 만드십시오.

  1. 다음과 같이 웹 브라우저에 북마크 바​를 표시합니다.

    • Ctrl+Shift+B(Windows) 또는 Cmd+Shift+B(Mac)를 누릅니다.
  2. 다음과 같이 브라우저에 새 북마크를 만듭니다.

    • 북마크 바를 마우스 오른쪽 버튼으로 클릭하고 새 페이지 또는 북마크 추가​를 선택합니다.
    • 주소(URL) 필드에 다음 코드를 붙여 넣습니다.
    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. 북마크의 이름을 Preflight(또는 원하는 이름)로 지정합니다.

  4. AEM Sites 페이지 편집기​에서 감사할 페이지를 엽니다.

  5. 북마크 바에서 Preflight 북마크를 클릭해 현재 페이지에 대한 감사를 시작합니다.

모범 사례

Preflight 감사를 실행 시 다음과 같은 지침을 염두에 두십시오.

  • 프로덕션에 게시하기 전 항상 스테이징 페이지 또는 미리보기 페이지​에서 감사를 실행하십시오.
  • 끊어진 링크, 누락된 H1 태그, 안전하지 않은 링크 등 큰 영향력을 갖는 문제 해결을 우선시하십시오.
  • 감사를 실행하기 전에 보호된 스테이징 환경에 대해 인증이 활성화되었는지​확인하십시오.
  • 메타 태그 권장 사항​을 검토 및 적용하여 SEO 성능을 개선하십시오.
recommendation-more-help
09f218e1-7e9e-4738-994e-40fc9cd01d9b