> For the complete documentation index, see [llms.txt](https://help.genser.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genser.ai/reference/gmc-feed-url.md).

# GMC Feed URL 설정 가이드

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

## **URL만 찾으면 되는 경우**

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

#### **방법 1: Google Merchant Center에서 확인**

1. [Google Merchant Center](https://merchants.google.com/) 로그인
2. 좌측 메뉴 제품 → 피드 이동
3. 등록된 피드 항목 클릭 후 가져오기 URL 확인 및 복사

{% hint style="info" %}
GMC Feed 목록에서 `Content API` 라고 표시된 항목은 파일 URL이 아닙니다. \
파일 형식으로 등록된 항목에서만 가져오기 URL을 확인할 수 있습니다.
{% endhint %}

#### **방법 2: 개발팀에 문의**

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

* 쇼핑몰 서버 내 특정 경로에 정적 파일로 생성되는 경우
* AWS S3, Google Cloud Storage 등 외부 파일 서버(오브젝트 스토리지)에 업로드되는 경우
* 별도 API 엔드포인트로 동적으로 생성되는 경우

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

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

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

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

***

## **처음 만드는 경우**

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

<table><thead><tr><th width="97.08984375">형식</th><th width="474.3828125">특징</th><th>확장자 예시</th></tr></thead><tbody><tr><td><strong>XML</strong></td><td>구조화된 태그 형식, 계층적 데이터 표현 가능</td><td><code>products.xml</code></td></tr><tr><td><strong>TSV</strong></td><td>탭 구분 텍스트, 용량 작고 처리 빠름</td><td><code>products.tsv</code></td></tr><tr><td><strong>TXT</strong></td><td>TSV와 동일한 탭 구분 형식, 확장자만 다름</td><td><code>products.txt</code></td></tr></tbody></table>

#### **필수 필드**

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

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

{% hint style="info" %}
[Google 공식 문서](https://support.google.com/merchants/answer/7052112#product_category)를 참고해 주세요.
{% endhint %}

#### **선택 필드 (권장)**

<table><thead><tr><th width="379.93359375">필드명</th><th>설명</th></tr></thead><tbody><tr><td><code>google_product_category</code></td><td>Google 제품 카테고리</td></tr><tr><td><code>sale_price</code></td><td>할인가</td></tr><tr><td><code>mobile_link</code></td><td>모바일 상품 URL</td></tr><tr><td><code>additional_image_link</code></td><td>추가 이미지 URL</td></tr><tr><td><code>color</code></td><td>컬러 (패션에서는 특히 권장)</td></tr><tr><td><code>size</code></td><td>사이즈 (패션에서는 특히 권장)</td></tr><tr><td><code>gtin</code></td><td>국제 상품 번호 (바코드)</td></tr><tr><td><code>mpn</code></td><td>제조사 상품 번호</td></tr></tbody></table>

**XML 샘플**

```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 또는 탭 구분 텍스트 데이터가 표시됨

***

## **자주 묻는 질문**

<details>

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

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

</details>

<details>

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

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

</details>