[네이버웹마스터 가이드] 신디케이션 문서 작성 가이드
페이지 정보
본문
신디케이션 문서의 구성
네이버 신디케이션 문서는 RFC 4287 - The Atom Syndication Format과 RFC 6721 - The Atom "deletedentry" Element를 참고하여 네이버 검색 서비스에 연동할 수 있게 보완한 XML 문서 형식을 사용합니다. 네이버 신디케이션 문서는 UTF-8로 인코딩된 피드 문서로 구성되며, 피드 문서는 등록/수정 엔트리나 삭제 엔트리, 또는 둘 모두를 포함합니다.
- 각 문서의 문법은 다음과 같은 기호를 사용하여 표현
- 물음표(?): 해당 요소를 0회 또는 1회 포함
- 더하기 기호(+): 해당 요소를 1회 이상 포함
- 별표(*): 해당 요소를 0회 이상 포함
주의 : XML 파서로 파싱이 불가능한 문자(컨트롤 문자)가 문서에 포함되어 있거나 네이버 신디케이션 문서 형식을 준수하지 않으면, 네이버 검색 서비스에 반영되지 않을 수 있습니다.
피드 문서
네이버 신디케이션 문서에는 entry 요소(element) 또는 deleted-entry 요소를 하나 이상 포함하는 feed 요소가 반드시 있어야 합니다. feed 요소는 다음 7가지 요소를 포함합니다.
Feed Document = <feed> {
<id>
<title>
<author>
<updated>
<link> ?
<entry> *
<deleted-entry> *
}
요소 | 필수 여부 | 설명 |
---|---|---|
feed | 필수 | entry 요소를 담는 컨테이너 요소 |
id | 필수 | 피드 문서를 구분하는 URL. 엔트리를 담고 있는 채널(예: 게시판, 카테고리)의 URL을 입력한다. |
title | 필수 | 피드 문서를 나타내는 제목 |
author | 필수 | 피드 문서 작성자. 콘텐츠를 소유하는 웹 사이트 이름 등을 사용할 수 있다. |
name(필수), url(선택), email(선택)과 같은 하위 요소를 사용하여 표현한다. | ||
updated | 필수 | 피드 문서가 수정된 시간. ISO 8601 형식을 사용한다 |
(예: 2014-01-01T18:30:02+01:00, 2014-01-01T18:30:02z) | ||
link | 선택 | 콘텐츠를 소유하는 웹 사이트 정보를 표현할 수 있다. 다음과 같은 속성이 있다. |
- rel(필수): rel='site' 속성만 유효 | ||
- href(필수): 콘텐츠를 소유하는 웹 사이트 주소를 제공한다. | ||
- title(선택): 콘텐츠를 소유하는 웹 사이트 이름을 제공한다. | ||
entry | 선택 | 등록되거나 수정된 콘텐츠를 표현하는 요소 |
deleted-entry | 선택 | 삭제된 콘텐츠를 표현하는 요소 |
등록/수정 엔트리
등록/수정 엔트리는 웹 사이트의 콘텐츠 등록 또는 수정에 대한 정보를 포함하며, 다음과 같은 요소로 구성됩니다.
Entry Document = <entry> {
<id>
<title>
<author>
<updated>
<published>
<link> +
<content>
<summary> ?
<category> ?
}
요소 | 필수 여부 | 설명 |
---|---|---|
entry | 필수 | 웹 사이트의 개별 페이지를 구분하는 단위 |
id | 필수 | 엔트리를 구분하는 유일한 ID로 개별 페이지의 URL을 입력한다. |
개별 페이지의 URL은 웹 브라우저에서 노출되는 URL과 동일하게 입력한다. | ||
title | 필수 | 엔트리를 나타내는 제목 |
author | 필수 | 엔트리 작성자. |
name(필수), url(선택), email(선택)과 같은 하위 요소를 사용 하여 표현한다. | ||
updated | 필수 | 최근 수정한 시간. ISO 8601 형식을 사용한다. |
(예: 2014-01- 01T18:30:02+01:00, 2014-01-01T18:30:02z) | ||
published | 필수 | 최초 발행 시간. ISO 8601 형식을 사용한다. |
(예: 2014-01- 01T18:30:02+01:00, 2014-01-01T18:30:02z) | ||
최초 발행 시간을 알기 어렵다면 최근 수정한 시간을 사용할 수 있다. | ||
link | 필수 | 다음과 같은 속성이 있다. |
- rel(필수): rel='via' 속성(필수)과 rel='mobile' 속성(선택)과 rel=’app’만 유효하다. | ||
- href(필수): 관련된 콘텐츠의 주소를 제공한다. | ||
- title(선택): 관련된 콘텐츠의 이름을 제공한다. | ||
- type(선택): rel=’app’인 경우, app 을 구분할 수 있는 값을 제공한다. | ||
content | 필수 | HTML 형식의 엔트리 본문. 다음과 같은 속성이 있다. |
- type(필수): type='html'만 지원. | ||
summary | 선택 | 텍스트 형식의 엔트리 본문이나 요약 정보. 다음과 같은 속성이 있다. |
- type(필수): type='text'만 지원. | ||
category | 선택 | 엔트리의 분류 정보를 표현하는 요소. 다음과 같은 속성이 있다. |
- term(필수): 분류 식별자 | ||
- label(선택): 분류 이름 |
삭제 엔트리
삭제 엔트리는 웹 사이트에서 삭제된 콘텐츠에 대한 정보만을 포함하며, 다음과 같은 요소로 구성됩니다.deletedEntry Document = <deleted-entry> *
요소 | 필수 여부 | 설명 |
---|---|---|
deleted-entry | 필수 | 웹 사이트의 삭제된 한 페이지를 구분하는 단위. 다음과 같은 속성이 있다. |
- ref(필수): 삭제된 엔트리의 URL 값을 사용한다. | ||
- when(필수): 엔트리 삭제 시간. ISO 8601 형식을 사용한다 |
참고) link 요소의 rel 속성값 분류
- link 요소의 rel 속성값에 따른 href 속성값 의미
rel 속성 값 | 필수 여부 | 사용 범위 | href 속성 설명 |
---|---|---|---|
site | 필수 | 피드 | 엔트리를 소유하는 웹 사이트 링크 |
via | 필수 | 엔트리 | 엔트리가 속한 상위 채널의 링크(예: 게시판 목록, 블로그 홈 등) |
mobile | 선택 | 엔트리 | 엔트리를 표현하는 모바일 웹 링크 |
app | 선택 | 엔트리 | 엔트리를 표현하는 모바일 앱 링크 |
- link 요소의 rel="app"의 경우 사용되는 type 속성 값
type 속성 값 | 설명 | 예 |
---|---|---|
playstore:(+app ID) | 구글 플레이 마켓의 앱 ID | playstore:com.syndi-example.android |
itunes:(+app ID) | 애플 아이튠즈 마켓의 앱 ID | itunes:id123456789 |
신디케이션 문서 제한 사항
- 피드 문서에서 필수 요소들의 순서를 아래와 같이 지켜야 합니다.
<feed>
<id />
<title />
<author />
<updated />
...
</feed>
- 등록/수정 엔트리에서 필수 요소들의 순서를 아래와 같이 지켜야 합니다.
<entry>
<id />
<title />
<author />
<updated />
<published />
<link />
<content />
...
</entry>
- 문서 크기와 엔트리 수 제한
문서 크기가 최대 크기(50MB)를 넘지 않는다면 문서당 최대 100개의 등록, 수정, 삭제 엔트리를 포함할 수 있습니다.
신디케이션 문서 예제 및 검증
신디케이션 문서 검증
웹 마스터도구의 검증 > 신디케이션 핑 메뉴에서 사용자 신디케이션 문서에 대한 스키마 검증이 가능합니다.
스키마 검증 결과가 “정상”으로 나오지않은 경우에는, 검증 결과의 오류 메시지에 따라 사용자의 네이버 신디케이션 문서를 수정해야합니다.
스키마 검증을 통과하지못한 신디케이션 문서는 네이버 검색 결과에 노출되지 않습니다.신디케이션 XML 스키마
네이버 신디케이션 문서의 XML 스키마는 이곳에서 조회가 가능합니다.
XML 스키마를 사용하여 신디케이션 문서의 무결성을 직접 검증할 수 있으며, 검증을 통과한 경우에만 네이버 검색 시스템에 사용됩니다.
출처 : 네이버 웹마스터 가이드
- 이전글[네이버웹마스터 가이드] 신디케이션 작성된 문서 전송 방법 21.07.16
- 다음글[네이버웹마스터 가이드] 신디케이션 API 활용한 사이트 활성화 21.07.09
댓글목록
등록된 댓글이 없습니다.