GMC Feed URL 설정 가이드

GMC(Google Merchant Center) Feed URL 확인하는 방법에 대해 안내합니다.

URL만 찾으면 되는 경우

피드 파일이 어디에 저장되어 있는지에 따라 URL 형태가 다릅니다.

방법 1: Google Merchant Center에서 확인

1. Google Merchant Center 로그인

2. 좌측 메뉴 제품 → 피드 이동

3. 등록된 피드 항목 클릭 후 가져오기 URL 확인 및 복사

GMC Feed 목록에서 Content API 라고 표시된 항목은 파일 URL이 아닙니다. 파일 형식으로 등록된 항목에서만 가져오기 URL을 확인할 수 있습니다.

방법 2: 개발팀에 문의

피드 파일은 보통 아래 중 한 곳에 저장되어 있습니다.

• 쇼핑몰 서버 내 특정 경로에 정적 파일로 생성되는 경우

• AWS S3, Google Cloud Storage 등 외부 파일 서버(오브젝트 스토리지)에 업로드되는 경우

• 별도 API 엔드포인트로 동적으로 생성되는 경우

저장 위치에 따라 Feed URL 형태가 다릅니다.

저장 방식	Feed URL 예시
쇼핑몰 서버 내 정적 파일	https://www.yourshop.com/feed/products.xml
AWS S3	https://s3.ap-northeast-2.amazonaws.com/bucket-name/feed/products.tsv
CloudFront (CDN) 경유	https://cdn.yourshop.com/feed/products.txt
API 엔드포인트	https://api.yourshop.com/v1/feed/google

개발팀에 아래와 같이 문의해 주세요.

"Google Merchant Center 연동에 사용 중인 피드 파일 URL이 어떻게 되나요? S3나 CDN 등 외부 파일 서버를 사용 중이라면 해당 공개 URL도 함께 알려주세요."

---

처음 만드는 경우

GMC Feed 파일을 개발팀에서 직접 구현해야 합니다. gelatto는 아래 세 가지 형식을 지원합니다.

형식	특징	확장자 예시
XML	구조화된 태그 형식, 계층적 데이터 표현 가능	products.xml
TSV	탭 구분 텍스트, 용량 작고 처리 빠름	products.tsv
TXT	TSV와 동일한 탭 구분 형식, 확장자만 다름	products.txt

필수 필드

포함되어야 하는 내용은 파일 형식과 관계없이 동일합니다.

필드명	설명	예시
id	상품 고유 ID	PRD_001
title	상품명	[브랜드] 반팔 티셔츠 화이트 L
description	상품 설명	레드 커튼은 옅은 회색 배경에 다양한 색상의 꽃들이 풍성하게 그려진 홈데코 패브릭 커튼입니다.
price	판매가 (통화 포함)	29000 KRW
link	상품 상세 URL	https://www.yourshop.com/product/1
image_link	대표 이미지 URL	https://cdn.yourshop.com/img/1.jpg
brand	브랜드명	gelatto
availability	재고 상태	in_stock, out_of_stock

Google 공식 문서를 참고해 주세요.

선택 필드 (권장)

필드명	설명
google_product_category	Google 제품 카테고리
sale_price	할인가
mobile_link	모바일 상품 URL
additional_image_link	추가 이미지 URL
color	컬러 (패션에서는 특히 권장)
size	사이즈 (패션에서는 특히 권장)
gtin	국제 상품 번호 (바코드)
mpn	제조사 상품 번호

XML 샘플

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">
  <channel>
    <title>My Shop Feed</title>
    <link>https://www.yourshop.com</link>
    <item>
      <g:id>PRD_001</g:id>
      <g:title>[브랜드] 반팔 티셔츠 화이트 L</g:title>
      <g:price>29000 KRW</g:price>
      <g:link>https://www.yourshop.com/product/1</g:link>
      <g:image_link>https://cdn.yourshop.com/img/1.jpg</g:image_link>
      <g:google_product_category>의류 및 액세서리 &gt; 의류</g:google_product_category>
      <g:shipping>
        <g:country>KR</g:country>
        <g:price>3000 KRW</g:price>
      </g:shipping>
    </item>
  </channel>
</rss>

TSV / TXT 샘플

id	title	price	link	image_link	google_product_category	shipping
PRD_001	[브랜드] 반팔 티셔츠 화이트 L	29000 KRW	https://www.yourshop.com/product/1	https://cdn.yourshop.com/img/1.jpg	의류 및 액세서리 > 의류	KR:::3000 KRW
PRD_002	[브랜드] 슬랙스 블랙 M	49000 KRW	https://www.yourshop.com/product/2	https://cdn.yourshop.com/img/2.jpg	의류 및 액세서리 > 의류	KR:::0 KRW

개발팀 구현 체크리스트

• 전체 상품을 지원 형식(XML / TSV / TXT) 중 하나로 출력하는 엔드포인트 구현

• TSV / TXT: 컬럼값 내 탭(\t), 개행(\n) 문자 제거 또는 공백 치환

• 파일 URL이 외부에서 HTTP/HTTPS로 접근 가능한지 확인

---

GMC Feed URL 정상 여부 확인

브라우저 주소창에 Feed URL을 직접 입력했을 때 파일 데이터가 표시되면 정상입니다.

• 정상: 브라우저에서 XML 또는 탭 구분 텍스트 데이터가 표시됨

---

자주 묻는 질문

Q. XML, TSV, TXT 중 어떤 형식을 사용해야 하나요?

세 형식 모두 지원합니다. 이미 GMC에 연동 중인 파일이 있다면 해당 형식을 그대로 사용하시면 됩니다. 새로 만드는 경우라면 용량이 작고 처리가 빠른 TSV 또는 TXT를 권장합니다.

Q. TSV / TXT 컬럼값에 탭이나 줄바꿈이 포함된 경우 어떻게 처리하나요?

탭(\t)과 개행(\n, \r) 문자는 반드시 공백( ) 처리 또는 제거 후 출력해야 합니다. 포함된 경우 파싱 오류로 해당 상품이 무효 처리됩니다.