패치란 무엇인가?
패치를 사용하시면 사이트 감사를 통해 직접 웹사이트의 문제를 수정하고 변경할 수 있습니다. 패치는 빠르고 일시적인 해결책으로 생각해야 합니다. 개발자에게 요청할 시간이 없거나 웹사이트에서 최종적으로 변경하기 전에 무언가를 테스트하고 쉽고 간편하게 되돌릴 수 있는 기능이 필요할 때, 패치를 이용할 수 있습니다.
페이지에서 패치를 사용하여 무엇을 변경할 수 있나요?
현재 이 기능의 첫 릴리스에서는 제목과 메타 설명 두 필드만 패치할 수 있습니다. 곧 더 많은 필드를 추가할 예정입니다. 리디렉션, 캐노니컬, 로봇 메타 태그 관리뿐만 아니라 내부 링크 추가 및 업데이트도 할 수 있도록 계획 중입니다.
패치를 사용하는 방법은?
패치를 생성하기 위해서는 페이지 제목이나 메타 설명과 관련된 문제를 열거나 페이지 탐색기에서 관련 필터 프리셋을 열거나 해당 필드를 수동으로 추가해야 합니다. 패치 가능한 문제는 모든 문제 보고서에서 번개 아이콘으로 표시됩니다.
보고서 내 각 페이지 제목과 메타 설명 옆에 "패치" 입력란이 표시됩니다. 새로운 제목이나 메타 설명 초안을 작성하고 모든 준비가 되면 라이브로 웹사이트에 게시할 수 있습니다.
패치 상태
패치는 초안으로 저장, 게시, 비공개 상태일 수 있습니다. 제목이나 메타 설명을 게시하기 전에 시간을 두고 초안을 작성할 수 있습니다. 타이핑을 하면 초안이 자동으로 저장됩니다. 게시 후 언제든지 비공개로 전환하여 패치를 되돌릴 수 있습니다.
현재 패치 상태와 사용 가능한 작업은 "패치" 입력에서 확인할 수 있습니다.
어떤 패치든 전체 기록을 추적할 수 있습니다. 패치가 언제 게시되었는지, 누가 초안을 편집했는지 확실하지 않을 때는 이곳에서 확인하세요. "이력 보기" 링크는 모든 패치의 컨텍스트 메뉴에 있습니다.
패치 보고서
이슈 보고서에서 바로 문제를 패치하는 것이 편리하긴 하지만, 사이트에 대해 생성한 모든 패치를 확인하고 관리할 수 있는 전용 "패치 보고서"도 있습니다. 헤더에서 이 보고서에 액세스할 수 있으며, 현재 게시된 패치 수도 표시됩니다.
패치 보고서는 상태와 페이지 URL별로 패치를 필터링하고, 패치를 내보내며, 문제 보고서나 페이지 탐색기에서도 동일한 작업을 수행할 수 있습니다. 이 보고서는 패치 배포를 구성하는 것도 가능합니다.
패치 배포 설정
배포 구성을 시작하려면 패치 보고서 헤더의 "배포 설정" 버튼을 클릭하세요.
사이트에 패치를 배포하는 방법은 두 가지가 있습니다:
JavaScript 스니펫
사이트 감사가 페이지를 변경할 수 있도록 하려면, 사이트의 모든 페이지 <head> 섹션에 작은 JavaScript 스니펫을 추가해야 합니다. 이 JavaScript 스니펫은 배포 구성 중에 생성 및 제공됩니다.
이 스니펫은 Ahrefs에서 호스팅하는 고유한 JavaScript 파일을 호출합니다. 게시하는 모든 패치가 거기에 추가되고 브라우저나 봇이 페이지에서 JavaScript를 실행할 때 클라이언트 측에서 적용됩니다. 페이지를 방문할 때 JavaScript를 실행하지 않는 봇은 변경사항을 볼 수 없다는 점에 유의하세요. 하지만 Google은 페이지를 순위를 매기기 전에 렌더링하므로 일반적으로 문제가 되지 않습니다.
언제든지 JavaScript 배포를 켜거나 끌 수 있습니다. 패치가 활성 상태일 때 비활성화하면 게시 취소될 것이라는 확인 메시지가 표시됩니다.
Cloudflare 워커
Cloudflare를 사용하는 경우, 사이트 감사가 Cloudflare 계정에서 워커를 실행하여 서버 측에서 패치를 적용하도록 할 수 있습니다. 이렇게 하면 원시 HTML과 렌더링된 페이지 모두에 변경사항이 포함됩니다. Google이 어느 것을 따를지 결정하기 전에 두 버전을 모두 확인하므로, <link rel="canonical">이나 <meta name="robots">와 같은 태그에서는 특히 중요합니다.
다음은 작동 방식입니다:
API 토큰 생성
API 토큰을 제공하여 Ahrefs가 계정에 Cloudflare 워커를 생성할 수 있는 권한을 부여하라는 요청을 받게 됩니다. Cloudflare 대시보드에서 다음 권한으로 사이트 영역에 범위가 지정된 토큰을 생성하세요:
계정 > 워커 스크립트: 편집
영역 > 워커 라우트: 편집
영역 > 영역: 읽기
일회성 워커 생성
사이트 감사는 토큰을 사용하여 계정에 워커를 설치하고, 보안 강화를 위해 토큰을 즉시 폐기합니다. 따라서 Cloudflare 대시보드에 대한 지속적인 액세스 권한을 보유하지 않습니다.
실시간 패치 가져오기
워커 스크립트에는 핵심 패치 로직이 포함되어 있지만, 실제 패치는 Ahrefs의 JSON 파일에 있습니다. 새 패치를 게시할 때마다 워커가 최신 JSON을 실시간으로 가져옵니다.
워커 동기화 유지
자격 증명을 저장하지 않기 때문에 패치를 손상시킬 수 있는 워커 스크립트의 수동 편집을 감지할 수 없습니다. 그런 경우 워커 재배포를 클릭하기만 하면 업데이트된 스크립트를 복원할 수 있습니다. 때때로 주요 기능 업데이트가 필요한 경우 사이트 감사에서 워커를 재배포하라는 메시지를 표시할 수도 있습니다.
JavaScript 배포와 마찬가지로 언제든지 Cloudflare 배포를 비활성화할 수 있습니다.
패치 수동 배포
패치는 모든 사용자에게 제공됩니다. 하지만 Site Audit에서 패치를 게시하려면 패치 기능을 지원하는 업그레이드 부스트가 필요합니다. 프로젝트가 업그레이드되지 않았거나 실제 배포를 위한 Site Audit 사용을 원하지 않는 경우 패치를 작성하고 내보내 개발자에게 전달하여 변경 및 배포를 그들이 할 수 있도록 합니다.
중요 사항
패치를 가장 효과적으로 사용하려면 다음 사항을 고려하세요.
변경사항은 사이트를 방문하는 모든 사람에게 표시됩니다: 사람과 봇이 볼 수 있는 변경사항을 만드는 것은 패치 기능의 명백한 목표이지만, 명확히 말씀드립니다. 패치를 게시하면 사이트에 가시적인 변경 사항이 발생합니다. 패치가 게시된 후 사이트를 방문하는 사람들과 봇이 변경 사항을 보게 됩니다. 따라서 게시하는 변경 사항이 사이트에 적합한지 확인하는 것이 중요합니다.
초안 작성과 게시에는 추가 확인이 필요합니다: 프로젝트에 액세스할 수 있는 모든 사용자가 패치 초안을 작성할 수 있습니다. 그러나, 계정 설정에 2FA를 구성한 사용자만 패치를 게시할 수 있습니다. 패치 배포가 활성화된 프로젝트에 대한 접근 권한을 가진 적절한 사용자가 선택되었는지 확인하세요. 그들이 사이트에서 변경을 게시할 수 있게 되기 때문입니다. 또한, 사이트 소유권이 확인된 프로젝트에서만 패치가 게시됩니다.
패치는 프로젝트에 연결됩니다: 프로젝트를 삭제하면 그 안에서 게시된 모든 패치가 게시 취소됩니다.
프로젝트 부스트를 구매해야 합니다: 패치 배포는 모든 프로젝트에서 사용할 수 있는 것은 아닙니다. 패치를 게시하려면 패치 기능을 지원하는 부스트로 업그레이드해야 합니다. 지원하지 않는 부스트로 다운그레이드하면 새 패치를 게시할 수 없습니다. 그러나 이전에 게시된 패치는 활성 상태로 남아 있습니다.
JavaScript 실행을 켜야 합니다: 배포를 설정한 프로젝트에서는 "JavaScript 실행" 옵션이 자동으로 활성화됩니다. 이 옵션을 통해 사이트 감사 봇이 다음 크롤 시 JavaScript를 통해 배포된 변경 사항을 감지할 수 있습니다. JavaScript 실행 시 크롤링 속도가 더 느릴 수 있으며, 이 옵션이 이전에 비활성화되었던 경우 크롤 시간이 더 길어질 수 있습니다.
JavaScript 배포를 사이트 감사에서 활성화하기 전에 이러한 조건에 동의해야 합니다.