WebSite SearchAction JSON-LD 생성기
브라우저 처리사이트 이름·첫 화면 주소와 검색 결과 주소 형식으로 WebSite·SearchAction 구조화 데이터를 만들고 {search_term_string} 포함 여부를 검사합니다. Google이 2024년 11월 사이트링크 검색창 표시를 중단했다는 점도 알려 줍니다.
WebSite 구조화 데이터는 사이트의 공식 이름과 첫 화면 주소를 검색엔진에 알립니다. 검색결과에 'shop.example.com' 대신 '예시상점' 같은 사이트 이름이 표시되도록 돕는 신호 중 하나입니다.
"@type": "WebSite",
"name": "예시상점",
"url": "https://shop.example.com/",
"potentialAction": {
"@type": "SearchAction",
"target": { "@type": "EntryPoint", "urlTemplate": "https://shop.example.com/search?q={search_term_string}" },
"query-input": "required name=search_term_string"
}
WebSite SearchAction JSON-LD 생성기 사용 가이드
WebSite 구조화 데이터는 사이트의 공식 이름과 첫 화면 주소를 검색엔진에 알립니다. 검색결과에 'shop.example.com' 대신 '예시상점' 같은 사이트 이름이 표시되도록 돕는 신호 중 하나입니다.
이 생성기는 사이트 이름과 주소에 더해 검색=에 사이트 내부 검색 결과 주소 형식을 넣으면 SearchAction까지 만듭니다. 주소 형식에는 검색어 자리를 뜻하는 {search_term_string}이 반드시 들어가야 하며, 없으면 예시와 함께 알려 줍니다.
Google은 2024년 11월부터 검색결과의 사이트링크 검색창을 더 이상 보여 주지 않습니다. 그래서 SearchAction은 표시 효과가 줄었지만, WebSite의 name은 사이트 이름 표시에 계속 쓰인다는 안내를 주석에 담습니다.
사용 방법
- '사이트 이름'에 검색결과에 보이길 원하는 공식 이름을 적습니다.
- '사이트 첫 화면 주소'에 첫 화면의 전체 주소를 넣습니다.
- '검색=검색 결과 주소 ({search_term_string} 포함)' 칸에 검색 주소 형식을 적고 '실행'을 누릅니다.
- 결과를 사이트 첫 화면에만 붙여 넣습니다.
예시: 쇼핑몰 첫 화면
사이트 이름: 예시상점
주소: https://shop.example.com/
검색=https://shop.example.com/search?q={search_term_string}"@type": "WebSite",
"name": "예시상점",
"url": "https://shop.example.com/",
"potentialAction": {
"@type": "SearchAction",
"target": { "@type": "EntryPoint", "urlTemplate": "https://shop.example.com/search?q={search_term_string}" },
"query-input": "required name=search_term_string"
}검색 주소 형식은 사이트에서 실제로 검색했을 때 주소창에 보이는 주소를 보고 검색어 자리를 바꿔 만듭니다.
이럴 때 쓰면 좋아요
- 검색결과에 도메인 대신 사이트 이름이 보이길 원할 때
- 사이트 공식 이름을 바꾼 뒤 구조화 데이터를 갱신할 때
- 내부 검색 주소 형식을 문서로 남겨 둘 때
- 첫 화면에 넣을 기본 구조화 데이터를 정리할 때
문제가 생겼을 때
검색어 자리는 {search_term_string}으로 바꿔야 합니다. 예: https://shop.example.com/search?q={search_term_string}
WebSite 구조화 데이터는 첫 화면 한 곳에만 넣으면 됩니다.
title 태그, og:site_name, WebSite의 name에 같은 이름을 쓰면 검색엔진이 사이트 이름을 정하기 쉽습니다.
활용 팁
- 사이트 이름을 영어와 한국어로 함께 알리고 싶으면 결과에 "alternateName": "Example Shop"을 추가하세요.
- name은 짧고 일관된 공식 이름이 좋습니다. 홍보 문구를 붙이지 마세요.
- 회사 정보와 로고는 Organization JSON-LD로 따로 알립니다.
자주 묻는 질문
Google 검색결과에는 더 이상 표시되지 않지만 넣어도 문제는 없습니다. 다른 검색엔진이나 서비스가 참고할 수 있고, WebSite의 이름 정보는 계속 쓰입니다.
사용자가 입력한 검색어가 들어갈 자리를 표시하는 약속된 이름입니다. query-input의 name과 같아야 합니다.
검색=을 비워 두면 검색 주소 오류가 납니다. 검색 기능이 없다면 이 도구 대신 Organization JSON-LD로 사이트 정보를 알리세요.