사용 방법
- 페이지에 표시되는 대로 질문과 답변을 입력하세요.
- 질문과 답변 쌍을 추가하거나 순서를 위아래로 바꾸고, 필요 없는 항목은 삭제하세요. 입력이 완료되지 않은 쌍은 제외되고 표시됩니다.
- 스크립트를 복사해 페이지 HTML의 head나 body에 붙여 넣으세요.
- 구조화 데이터 검사기로 페이지를 테스트해 마크업이 올바르게 읽히는지 확인하세요.
작동 방식
이 생성기는 각 질문과 답변 쌍을 Question 항목으로 만들고, 각 항목에 Answer 유형의 acceptedAnswer를 추가해 schema.org FAQPage 객체를 구성합니다. JSON은 실제 JSON 직렬화기를 사용해 생성하므로 텍스트의 따옴표, 백슬래시, 줄바꿈이 올바르게 이스케이프됩니다. 또한 모든 “<”, “>”, “&” 문자는 \u 이스케이프 형식으로 출력됩니다. 따라서 답변에 “</script>” 또는 “<!--”와 같은 텍스트가 있어도 스크립트 요소가 일찍 끝나 페이지가 깨지는 일을 방지하며, JSON 파서는 원래 문자를 그대로 읽습니다.
리치 결과 안내: Google은 2023년 8월 FAQ 리치 결과를 잘 알려져 있고 권위 있는 정부 및 건강 관련 웹사이트로 제한했습니다. 대부분의 다른 사이트에서는 FAQPage 마크업을 사용해도 Google 검색에 펼쳐지는 질문이 표시되지 않습니다. 이 마크업은 페이지를 설명하는 유효한 구조화 데이터로 남아 있으며, schema.org 데이터를 사용하는 다른 서비스에서 활용할 수 있습니다.
따라야 할 규칙: 마크업의 질문과 답변은 페이지에도 표시되어야 합니다. 각 질문에는 사이트에서 작성한 답변 하나만 있어야 합니다(사용자가 답변을 제출하는 페이지에는 QAPage가 적합합니다). 또한 마크업을 광고에 사용해서는 안 됩니다. 답변에는 링크나 목록과 같은 간단한 HTML을 넣을 수 있으며, Google 가이드라인에서도 답변 텍스트에 이를 허용합니다.
예시
제품 고객 지원 페이지
배송, 반품, 보증에 관한 질문 세 개가 Question 항목 세 개를 포함하는 FAQPage로 변환됩니다. 해당 질문이 표시되는 고객 지원 페이지에 스크립트를 한 번 붙여 넣으세요.
코드가 포함된 답변
“</script>”가 포함된 답변은 JSON 안에서 \u003c/script\u003e로 출력되므로 페이지의 script 태그가 그대로 유지되고 화면에 표시되는 텍스트에도 영향이 없습니다.
자주 묻는 질문
FAQ 마크업을 사용하면 Google에서 페이지가 리치 결과로 표시되나요?
잘 알려져 있고 권위 있는 정부 또는 건강 관련 웹사이트가 아니라면 아마 표시되지 않을 것입니다. Google은 2023년에 FAQ 리치 결과를 해당 사이트로 제한했습니다. 마크업은 여전히 유효하며 다른 서비스에서 읽을 수 있습니다.
JSON-LD 스크립트는 어디에 넣어야 하나요?
HTML의 head나 body 어디에나 넣을 수 있습니다. 화면에는 아무것도 표시되지 않습니다. 해당 질문과 답변이 실제로 표시되는 페이지에만 추가하세요.
답변에 링크를 넣을 수 있나요?
네. Google의 FAQ 가이드라인은 링크, 목록, 문단과 같은 일부 HTML 태그를 답변 텍스트에 허용합니다. 답변에 HTML을 입력하면 스크립트에서 안전하게 이스케이프됩니다.
출력에 \u003c 시퀀스가 있는 이유는 무엇인가요?
“<” 문자를 나타내는 JSON 이스케이프입니다. 이렇게 쓰면 답변 안의 텍스트로 인해 스크립트 태그가 닫히는 것을 방지할 수 있습니다. JSON-LD를 읽는 프로그램은 이를 다시 “<”로 변환합니다.
개인정보 보호
마크업은 브라우저에서 생성됩니다. 질문과 답변은 어디에도 전송되거나 저장되지 않습니다.