[네이버웹마스터 가이드] 신디케이션 문서 작성 가이드 > 웹문서/검색 마케팅

본문 바로가기
사이트 내 전체검색

웹문서/검색 마케팅

[네이버웹마스터 가이드] 신디케이션 문서 작성 가이드

페이지 정보

profile_image
작성자 금탑
댓글 0건 조회 8,636회 작성일 21-07-10 10:43

본문

신디케이션 문서의 구성

네이버 신디케이션 문서는 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)구글 플레이 마켓의 앱 IDplaystore:com.syndi-example.android
itunes:(+app ID)애플 아이튠즈 마켓의 앱 IDitunes:id123456789

신디케이션 문서 제한 사항

  • 피드 문서에서 필수 요소들의 순서를 아래와 같이 지켜야 합니다.
<feed>
 <id />
 <title />
 <author />
 <updated /> 
 ...
 </feed>
  • 등록/수정 엔트리에서 필수 요소들의 순서를 아래와 같이 지켜야 합니다.
<entry>
 <id />
 <title />
 <author />
 <updated />
 <published /> 
 <link />
 <content />
 ...
 </entry>
  • 문서 크기와 엔트리 수 제한
    문서 크기가 최대 크기(50MB)를 넘지 않는다면 문서당 최대 100개의 등록, 수정, 삭제 엔트리를 포함할 수 있습니다.

신디케이션 문서 예제 및 검증

  • 문서 예제
    네이버가 권장하는 신디케이션 문서 예
    최소한의 요소만 포함하는 신디케이션 문서 예

  • 신디케이션 문서 검증
    웹 마스터도구의 검증 > 신디케이션 핑 메뉴에서 사용자 신디케이션 문서에 대한 스키마 검증이 가능합니다.
    스키마 검증 결과가 “정상”으로 나오지않은 경우에는, 검증 결과의 오류 메시지에 따라 사용자의 네이버 신디케이션 문서를 수정해야합니다.
    스키마 검증을 통과하지못한 신디케이션 문서는 네이버 검색 결과에 노출되지 않습니다.

  • 신디케이션 XML 스키마
    네이버 신디케이션 문서의 XML 스키마는 이곳에서 조회가 가능합니다.
    XML 스키마를 사용하여 신디케이션 문서의 무결성을 직접 검증할 수 있으며, 검증을 통과한 경우에만 네이버 검색 시스템에 사용됩니다.


출처 : 네이버 웹마스터 가이드

댓글목록

등록된 댓글이 없습니다.

회원로그인

회원가입

Copyright © admoim.kr All rights reserved.