다나와 엔진페이지(EP) 작성 안내 (Latest Edit Date : 2014-05-14)

시작하기 전에...

  • 엔진페이지란 다나와에서 상품등록과 가격 자동 업데이트시 필요한 상품목록 페이지입니다.
  • 기존 제공중인 타 가격비교 사이트의 엔진페이지(Naver EnginePage Format)가 있으면 그대로 사용하실 수 있습니다.
  • 엔진페이지 제작시 작성요령을 참고하시어 정확하게 작성해 주시기 바랍니다.

다나와 엔진페이지 작성 요령

  1. 엔진페이지별 설명

    • 엔진페이지 타입
      • 전체 상품 엔진페이지 - 신규, 변경 상품 구분없이 생성 시점의 서비스 중인 모든 상품 목록이 포함
      • 신규 상품 엔진페이지 - 신규 등록된 상품 목록이 포함, 업데이트 주기 단축 목적으로 사용 (신규/변경 중 하나의 엔진페이지에 신규, 변경 상품 모두 포함해도 무관함)
      • 변경 상품 엔진페이지 - 변경된 상품 목록이 포함, 업데이트 주기 단축 목적으로 사용 (신규/변경 중 하나의 엔진페이지에 신규, 변경 상품 모두 포함해도 무관함)
      • 삭제 상품 엔진페이지 - 삭제(품절, 서비스 중단 등)된 상품이 포함 (즉시 서비스 중단이 필요한 상품 존재할 경우)
    • 삭제 상품 엔진페이지가 없어도 주기적인 상품삭제는 전체 상품 엔진페이지를 통해 이뤄집니다.(기존 수집된 상품이 전체 상품 엔진페이지에 존재하지 않을 경우 삭제 처리)
    • 각 엔진페이지는 별도의 URL로 제공 되어야 함

  2. 엔진페이지 형식(※ 2014년 06월 이전에 제휴사에서 제공하는 다나와 엔진페이지 포맷은 AS-IS에서 TO-BE롤 변경되어야 합니다)

    AS-IS
    - 일반업체
    상품ID^카테고리^상품명^제조사^이미지URL^상품URL^가격^적립금^할인쿠폰^무이자할부^사은품^모델명^추가정보^출시일^배송료^재고량(선택)
    - 프로모션제공업체
    상품ID^카테고리^상품명^제조사^이미지URL^상품URL^가격^적립금^할인쿠폰^무이자할부^사은품^모델명^추가정보^출시일^배송료^(카드)프로모션명^(카드)프로모션가^재고량(선택)
    TO-BE
    - 다나와 통합 엔진페이지(타입 : 전체, 변경 엔진페이지)
    상품ID^카테고리^상품명^제조사^이미지URL^상품URL^가격^적립금^할인쿠폰^무이자할부^사은품^모델명^추가정보^출시일^배송료^카드프로모션명^카드프로모션가^쿠폰다운로드필요여부^모바일상품가격^차등배송비여부^차등배송비내용^별도설치유무^재고유무
    - 다나와 통합 엔진페이지(타입 : 삭제 엔진페이지)
    상품ID

  3. 주의사항

    • 각 데이터 항목은 '^'문자를 이용하여 구분하세요.
    • 각 데이터 항목의 위치와 순서가 정확해야 됩니다.
    • 라인 끝에 개행문자(Line Feed,ASCII(10))를 삽입해 주세요. 엔진페이지 URL을 웹브라우저로 열어서 '소스보기'를 했을 경우 한 라인에 하나의 상품데이터가 출력되어야 합니다.
    • 데이터가 없는 항목은 비워둡니다. 단 데이터가 없다고 '^'을 생략하시면 안됩니다.
    • 상품ID, 카테고리, 상품명, 이미지URL, 상품URL, 가격, 배송료필수항목입니다. 이 항목의 데이터가 누락되면 상품이 등록되지 않습니다.
    • 상품ID의 경우 대소문자를 구분해주시기 바라며, 공백이 들어가지 않도록 주의하시기 바랍니다.
    • html 태그및 기타의 프로그래밍 언어 사용금지
    • 엔진페이지의 char-set은 EUC-KR로 설정해주시기 바랍니다.

  4. 필드별 상세설명

    ※ 필드는 모두 23개입니다.

    ※ 구분기호(^)는 반드시 1개 상품(라인) 당 22개가 존재해야 합니다.

    ※ 필수 필드는 반드시 데이터가 존재해야 합니다.

    ※ 필수 이외 필드는 데이터가 없는 경우 비워두시면 됩니다.

        - 좋은 예 : ^^

        - 나쁜 예 : ^NULL^ 또는 ^없음^ 또는 ^None^ 또는 ^ ^

    순서 필드 필수/옵션 데이터 타입 & 규칙
    1상품ID필수
    • Type & Size : varchar [max : 50 bytes]
    • 규칙
      - unique한 상품 ID
      - 영문, 숫자 권장
      - 대소문자 구분
      - 공백주의
    • 예시
      - 123456
      - ABC123
    2카테고리필수
    • Type & Size : varchar [max : 100 bytes(영문 100자 or 한글 50자) , min : 5 bytes ]
    • 규칙
      - 상품이 속한 카테고리
      - 대분류|중분류|소분류
      - '|' 문자로 카테고리 Depth 표현
    • 예시
      - 컴퓨터|CPU
      - 가전|영상가전|디지털TV
      - 영상가전|모니터|LCD|24인치
    3상품명필수
    • Type & Size : varchar [max : 200 bytes(영문 200자 or 한글 100자)]
    • 규칙
      - 상품 고유의 상품명
      - 무이자할부, 쿠폰할인 제외(각 해당하는 필드에 표기)
      - 중고 상품 : prefix로 [중고] 표기, 미표기 시 상품 삭제
      - 해외배송 및 구매대행 상품 : prefix로 [해외] 표기, 미표기 시 상품 삭제
      - 중고 해외 배송 상품의 경우 [중고][해외] 순으로 표기
      - 구분자로 사용되는 '^' 기호가 들어가지 않게 주의 부탁드립니다
        (^^ : 웃는 이모티콘이 들어오는 경우 파싱이 정상적으로 이뤄지지 않을 수 있습니다)
    • 예시
      - Good : 소니정품 A5000 ILCE-5000 렌즈미포함 2014년형 소니 미러리스 카메라
      - Good : [중고]소니정품 A5000 ILCE-5000
      - Good : [중고][해외]소니정품 A5000 ILCE-5000
      - Bad : 소니정품 A5000 ILCE-5000 렌즈미포함 2014년형 소니 미러리스 카메라 ^^* 완전 좋아요
      - Bad : 소니정품 A5000 ILCE-5000 [중고]
    4제조사 
    • Type & Size : varchar [max : 100 bytes(영문 100자 or 한글 50자)]
    • 규칙
      - 상품의 제조사
    • 예시
      - 삼성전자
      - LG전자
    5이미지URL필수
    • Type & Size : varchar [max : 255 bytes(영문 255자)]
    • 규칙
      - 상품의 상세이미지 URL
      - url 경로는 "http://"로 시작
      - 이미지 최대용량 : 1M
      - 확장자는 '.gif', '.jpg', '.png' 만 허용
    • 예시
      - Good : http://auction.com/images/828992.jpg
      - Bad : auction.com/images/828992.jpg
    6상품URL필수
    • Type & Size : varchar [max : 255 bytes(영문 255자)]
    • 규칙
      - 상품의 상세정보가 표기된 업체측 상품 URL
      - url 경로는 "http://" 또는 "https://"로 시작
    • 예시
      - Good : http://itempage3.auction.co.kr/DetailView.aspx?itemno=A605276190
      - Bad : itempage3.auction.co.kr/DetailView.aspx?itemno=A605276190
    7가격필수
    • Type & Size : int (max : 10자)
    • 규칙
      - 상품의 판매가격
      - 원화 기준
      - 숫자(정수, 1 이상) 유효
      - 가격 2100000000 초과 시 미수집
      - 쿠폰이 있는 경우, 쿠폰 적용가로 표기
        단, 쿠폰은 모든 사용자에게 적용 가능한 쿠폰이어야 함
    • 예시
      - Good : 1982200
      - Bad : 1,982,200 & 1982200원 & \1982200 등
    8적립금 
    • Type & Size : int (max : 8자)
    • 규칙
      - 적립금 표기
      - 원화 기준
      - 숫자(정수, 1 이상) 유효
    • 예시
      - Good : 1982
      - Bad : 1,982 & 1982원 & \1982 등
    9할인쿠폰 
    • Type & Size : varchar [max : 100 bytes(영문 100자 or 한글 50자)]
    • 규칙
      - 할인내역 표기
    • 예시
      - Good : 5% 할인쿠폰 증정 & 신규가입고객 10%할인
      - Bad : 최저가 판매
    10무이자할부 
    • Type & Size : varchar [max 100 bytes(영문 100자 or 한글 50자)]
    • 규칙
      - 무이자 정보 표기
    • 예시
      - 삼성3/BC3/농협3
    11사은품 
    • Type & Size : varchar [max : 100 bytes(영문 100자 or 한글 50자)]
    • 규칙
      - 사은품 정보 표기
    • 예시
      - 액정보호필름 or 휴대폰거치대 중 택일
    12모델명 
    • Type & Size : varchar [max : 100 bytes(영문 100자 or 한글 50자)]
    • 규칙
      - 모델명 표기
    • 예시
      - SCH-M620
    13추가정보 
    • Type & Size : varchar [max : 200 bytes(영문 200자 or 한글 100자)]
    • 규칙
      - 추가 정보 표기
    • 예시
    14출시일 
    • Type & Size : varchar (max : 8 bytes , min : 8 bytes)
    • 규칙
      - 상품 출시일
    • 예시
      - Good : 20060926
      - Bad : 2006-09-26 & 2006년 9월 26일 & 060926
    15배송료필수
    • Type & Size : int (max : 8자)
    • 규칙
      - 원화 기준
      - 숫자 값만 유효(-1 허용)
      - 무료배송인 경우 0으로 표기
      - 명확한 배송비를 제공하기 힘든 경우 -1로 표기
    16카드프로모션명 
    • Type & Size : varchar [max : 50 bytes(영문 50자 or 한글 25자)]
    • 규칙
      - 카드프로모션명 표기(카드프로모션가에 해당하는 프로모션명 표기)
      - 단일 프로모션명만 허용
    • 예시
      - Good : 현대카드
      - Bad : 현대카드, 삼성카드, 신한카드, 국민카드
    17카드프로모션가 
    • Type & Size : int (max : 10자)
    • 규칙
      - 카드프로모션가 표기(카드프로모션명에 해당하는 프로모션가 표기)
      - 원화 기준
      - 숫자(정수, 1 이상) 유효
      - 카드프로모션명 & 카드프로모션가 두가지 필드가 모두 유효해야만 서비스 적용
    • 예시
      - Good : 1982200
      - Bad : 1,982,200 & 1982200원 & \1982200 등
    18쿠폰다운로드필요여부 
    • Type & Size : varchar (max : 1 byte)
    • 규칙
      - Y or N
      - 다나와에 제공한 가격이 제휴사 상품페이지에 표시된 가격과 다르고,
        팝업화면 등에서 별도의 쿠폰을 다운받아야 해당 가격으로 구매할 수 있는 경우 Y 표기
      - 별도 쿠폰 다운로드 필요가 없고 제공 가격으로 구매가 가능한 경우
        N으로 표기하거나 null로 비워둠
      - null 허용(^null^ 이라고 표기하지 마시고 ^^로 구분기호 사이를 비워두면 됨)
    • 예시
      - Good : Y & N & null
      - Bad : X
    19모바일상품가격 
    • Type & Size : int (max : 10자)
    • 규칙
      - 가격 필드와 동일한 규칙
      - 모바일 상품 가격이 존재하는 경우만 가격 표기
      - 모바일 상품이 존재하지 않는 경우 비워두면 됨
    • 예시
      - Good : 1982200
      - Bad : 1,982,200 & 1982200원 & \1982200 등
    20차등배송비여부 
    • Type & Size : varchar (max : 1 byte)
    • 규칙
      - Y or N
      - 배송비필드로 보내준 무료배송 또는 배송비 금액이 특정 조건에만
        한정되며, 지역이나 품목에 따라 배송비가 추가로 발생할 경우 Y
      - 일반적인 도서산간 지역에 대한 추가 배송비는 해당하지 않음
      - 지역이나 품목에 따라 추가 배송비가 부과되는 상품인데,
        해당 필드를 Y로 전송하지 않을 경우 상품이 삭제 처리 될 수 있으니 주의 요망
    • 예시
      - 서울 경기 무료배송/ 강원, 충청 2만원이 추가 될 경우
      > 배송료 필드 : 0
      > 차등배송비여부 필드 : Y
      > 차등배송비내용 필드 : 서울 경기 무료배송/ 강원, 충청 2만원 추가
    20차등배송비내용 
    • Type & Size : varchar [max : 200 bytes(영문 200자 or 한글 100자)]
    • 규칙
      - 지역이나 품목에 따라 배송비가 추가로 발생할 경우(차등배송비여부 값이 Y인 경우) 해당 상세 내용 기입
    • 예시
      - 서울 경기 무료배송/ 강원, 충청 2만원 추가
    22별도설치비유무 
    • Type & Size : varchar (max : 1 byte)
    • 규칙
      - Y or N
      - 일반적으로 설치가 필요한 상품에 대해서, 기본적인 설치비가 추가로 발생할 경우 Y로 표기
      - 설치비가 이미 가격에 포함되어 있거나, 추가 설치비가 필요하지 않은 상품일 경우 N이나 비워둠
      - null 허용 : 비워둘 경우 별도설치비 없는 것으로 간주함
    • 예시
      - Good : Y & N & null
      - Bad : X
    23재고유무 
    • Type & Size : varchar (max : 1 byte)
    • 규칙
      - Y or N
      - 판매 가능한 재고 보유 유무 표기
      - null 허용 : 비워둘 경우 재고 있는 것으로 간주함
    • 예시
      - Good : Y & N & null
      - Bad : X

  5. 샘플

    <모든 필드 데이터가 존재하는 경우>
    DNW10001^가전|디카|니콘|풀프레임|^니콘 정품 D4S BODY DSLR 카메라^NIKON^http://img.danawa.com/image/prod/detail/code=DNW10001^http://prod.danawa.com/prod/code=DNW10001^7262000^7262^5%추가할인^상성/KB/BC/LG/신한 6개월 무이자할부^청소세트 or 8G 메모리카드 중 임의 발송^D4s^최신 일련번호, 신상품, 박스 미개봉^20140312^5000^KB카드^6262000^Y^7162000^Y^서울/경기 5,000원, 기타 지역 10,000원^N^Y

    <필수 필드 데이터만 존재하는 경우>
    DNW10002^가전|디카|캐논|크롭|^니콘 정품 D5300^^http://img.danawa.com/image/prod/detail/code=DNW10002^http://prod.danawa.com/prod/code=DNW10002^726200^^^^^^^^0^^^^^^^^