> 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/products/sync-management.md).

# 상품 연동 관리

상품 데이터를 연동하는 방식을 설정하고 관리하는 페이지입니다.

<figure><img src="/files/nIPzGr0uUPDzZgPAS9eT" alt=""><figcaption></figcaption></figure>

## **1. 연동 방식 한눈에 보기**

<table><thead><tr><th width="160">연동 방식</th><th>설명</th><th>수집 방식</th><th>적합한 경우</th></tr></thead><tbody><tr><td><strong>네이버 EP</strong></td><td>네이버 쇼핑에 사용 중인 EP URL을 통해 상품을 연동합니다.</td><td>스케줄 기반 자동 수집</td><td>네이버 쇼핑 파트너 센터 EP를 이미 운영 중인 경우</td></tr><tr><td><strong>GMC Feed</strong></td><td>구글·유튜브 쇼핑에 사용 중인 Feed URL을 통해 상품을 연동합니다.</td><td>스케줄 기반 자동 수집</td><td>구글 머천트 센터 피드를 이미 운영 중인 경우</td></tr><tr><td><strong>API</strong></td><td>젤라또·네이버 커머스·구글 머천트 API를 통해 상품 데이터를 실시간으로 연동합니다.</td><td>실시간 전송</td><td>상품 변경 시 즉시 반영이 필요하거나, 자체 시스템에서 직접 데이터를 전송하는 경우</td></tr></tbody></table>

{% hint style="info" %}
네이버 EP, GMC Feed, API 세 가지 방식을 동시에 사용할 수 있습니다. 동일한 상품이 여러 방식으로 연동되더라도 상품 코드를 기준으로 필드 단위로 자동 병합됩니다.
{% endhint %}

***

## **2. 네이버 EP**

네이버 쇼핑에 사용 중인 EP URL을 등록하면, 설정한 스케줄에 따라 상품 데이터를 자동으로 수집합니다.

<figure><img src="/files/QeCNQhUa6UkoHF7S5CoF" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
네이버 EP는 한국 리전에서만 사용할 수 있습니다. 일본 리전에서는 표시되지 않습니다.
{% endhint %}

### **2-1. 스케줄 연동**

#### **Step 1. URL 등록 및 스케줄 설정**

<img src="/files/p9PZjgYF8qJqKTdcOTZd" alt="" data-size="line"> 버튼을 클릭하여 EP URL과 연동 스케줄을 설정합니다.

<figure><img src="/files/PwlLOQG3JNQJQDiIH7xu" alt=""><figcaption></figcaption></figure>

* **전체 EP:** '전체 상품 데이터'를 수집하는 기본 EP입니다.
* **요약 EP:** 가격, 재고 등 '자주 변경되는 핵심 정보'를 빠르게 업데이트하기 위한 보조 EP입니다. 필요에 따라 우측의 토글을 켜서 사용할 수 있습니다.

<table><thead><tr><th width="160">항목</th><th>설명</th></tr></thead><tbody><tr><td><strong>URL*</strong></td><td><p><strong>[전체 EP / 요약 EP]</strong></p><ul><li>네이버 쇼핑에 사용 중인 전체 EP와 요약 EP 각각의 URL을 입력합니다.</li><li><code>http://</code> 또는 <code>https://</code>로 시작하는 완전한 형태여야 합니다.</li><li>외부에서 접근 가능한 <strong>공개 URL</strong>만 등록할 수 있습니다.</li></ul></td></tr><tr><td><strong>연동 스케줄</strong></td><td><p><strong>[전체 EP]</strong></p><ul><li>매일 선택한 시간에 <strong>1회</strong> 연동합니다.</li><li>00시~23시 중 선택할 수 있으며, <strong>기본값은 01시</strong>입니다.</li></ul><p><strong>[요약 EP]</strong></p><ul><li>매일 <strong>08:00 ~ 22:00</strong> 사이, 선택한 간격으로 반복 연동합니다.</li><li>30분 / 1시간 / 2시간 중 선택할 수 있으며, <strong>기본값은 1시간</strong>입니다.</li></ul></td></tr></tbody></table>

{% hint style="info" %}
EP URL을 어디서 확인해야 하는지 모르거나, 아직 EP 파일이 준비되지 않은 경우 [**네이버 EP URL 설정 가이드**](/reference/naver-ep-url.md)를 참고해 주세요.
{% endhint %}

{% hint style="info" %}
**\[전체 EP 연동 스케줄 권장 사항]**

전체 상품을 한 번에 수집하므로 완료까지 다소 시간이 소요될 수 있습니다. 특히 연동 요청이 집중되는 시간대에는 지연이 발생할 수 있으니, 안정적인 수집을 위해 트래픽이 적은 **새벽 시간대**에 진행하시는 것을 권장합니다.
{% endhint %}

{% hint style="warning" %}
**\[스케줄 변경 시 적용 시점]**

* **전체 EP:** 오늘 설정된 연동이 이미 완료된 경우, 변경된 스케줄은 **다음 날 연동 일정**부터 적용됩니다.
* **요약 EP:** 스케줄 변경 시, 변경된 주기의 다음 **정각 또는 30분 시점**부터 반영됩니다. 단, 연동 동작 시간(08:00\~22:00) 외의 시간에 변경한 경우 설정은 즉시 저장되지만, **실제 실행은 다음 날 08:00부터 시작**됩니다.
  {% endhint %}

#### **Step 2. 저장 및 활성화**

**\[저장] 버튼**을 클릭하여 설정을 완료합니다. 우측 상단의 **연동 토글을 ON(활성화)** 상태로 유지해야 설정한 스케줄에 따라 상품 데이터가 정상적으로 수집됩니다.

설정이 완료되면 네이버 EP 연동 정보에서 **다음 연동 예정 시각**을 확인할 수 있습니다.

<figure><img src="/files/0iEyU9bbrXiwruDgi0bS" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
우측 상단의 토글을 끄면(OFF) 연동이 일시 중지됩니다. 단, 비활성화하더라도 **이미 수집된 상품 데이터는 삭제되지 않으며 검색 결과에도 그대로 노출**됩니다. URL, 스케줄 등 기존 설정 정보도 유지되므로 필요 시 언제든 다시 켤 수 있습니다.
{% endhint %}

### **2-2. 즉시 연동**

설정된 스케줄과 별개로, 데이터 최신화가 급히 필요할 때 상품을 바로 수집할 수 있는 기능입니다. \ <img src="/files/eDkSHMytENPGsYnbRFJm" alt="" data-size="line"> 버튼을 클릭하여 실행합니다.

당일 즉시 연동 잔여 횟수는 연동 정보에서 확인할 수 있으며, 제공 횟수는 **매일 00시(자정)를 기준으로 자동 초기화**됩니다.

<table><thead><tr><th width="160">구분</th><th>1일 제공 횟수</th></tr></thead><tbody><tr><td><strong>전체 EP</strong></td><td>3회</td></tr><tr><td><strong>요약 EP</strong></td><td>12회</td></tr></tbody></table>

***

## **3. GMC Feed**

구글·유튜브 쇼핑에 사용 중인 Feed URL을 등록하면, 설정한 스케줄에 따라 상품 데이터를 자동으로 수집합니다.

<figure><img src="/files/tqu5EUeiYASVF0yfu3Oo" alt=""><figcaption></figcaption></figure>

### **3-1. 스케줄 연동**

#### **Step 1. URL 등록 및 스케줄 설정**

<img src="/files/p9PZjgYF8qJqKTdcOTZd" alt="" data-size="line"> 버튼을 클릭하여 Feed URL과 연동 스케줄을 설정합니다.

<figure><img src="/files/Ltoo0b6HTdZalkAIs0HW" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="160">항목</th><th>설명</th></tr></thead><tbody><tr><td><strong>URL*</strong></td><td><ul><li>구글·유튜브 쇼핑에 사용 중인 <strong>Feed URL</strong>을 입력합니다.</li><li><code>http://</code> 또는 <code>https://</code>로 시작하는 완전한 형태여야 합니다.</li><li>외부에서 접근 가능한 <strong>공개 URL</strong>만 등록할 수 있습니다.</li><li>지원 형식: <strong>.txt,</strong> <strong>.tsv, .xml (최대 4GB)</strong></li></ul></td></tr><tr><td><strong>연동 스케줄</strong></td><td><ul><li>매일 선택한 시간에 <strong>1회</strong> 연동합니다.</li><li>00시~23시 중 선택할 수 있으며, <strong>기본값은 01시</strong>입니다.</li></ul></td></tr></tbody></table>

{% hint style="info" %}
Feed URL을 어디서 확인해야 하는지 모르거나, 아직 피드 파일이 준비되지 않은 경우 [**GMC Feed URL 설정 가이드**](/reference/gmc-feed-url.md)를 참고해 주세요.
{% endhint %}

{% hint style="info" %}
**\[스케줄 권장 사항]**

전체 상품을 한 번에 수집하므로 완료까지 다소 시간이 소요될 수 있습니다. 특히 연동 요청이 집중되는 시간대에는 지연이 발생할 수 있으니, 안정적인 수집을 위해 트래픽이 적은 **새벽 시간대**에 진행하시는 것을 권장합니다.
{% endhint %}

{% hint style="warning" %}
**\[스케줄 변경 시 적용 시점]**

오늘 설정된 연동이 이미 완료된 경우, 변경된 스케줄은 **다음 날 연동 일정**부터 적용됩니다.
{% endhint %}

#### **Step 2. 저장 및 활성화**

**\[저장] 버튼**을 클릭하여 설정을 완료합니다. 우측 상단의 **연동 토글을 ON(활성화)** 상태로 유지해야 설정한 스케줄에 따라 상품 데이터가 정상적으로 수집됩니다.

설정이 완료되면 GMC Feed 연동 정보에서 **다음 연동 예정 시각**을 확인할 수 있습니다.

<figure><img src="/files/MSVfrZ7SSrGabpolNAnR" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
우측 상단의 토글을 끄면(OFF) 연동이 일시 중지됩니다. 단, 비활성화하더라도 **이미 수집된 상품 데이터는 삭제되지 않으며 검색 결과에도 그대로 노출**됩니다. URL, 스케줄 등 기존 설정 정보도 유지되므로 필요 시 언제든 다시 켤 수 있습니다.
{% endhint %}

### **3-2. 즉시 연동**

설정된 스케줄과 별개로, 데이터 최신화가 급히 필요할 때 상품을 바로 수집할 수 있는 기능입니다. \ <img src="/files/a6IRQhMc1Uleq3YjXNPu" alt="" data-size="line"> 버튼을 클릭하여 실행합니다.

* **1일 제공 횟수:** 3회
* 당일 즉시 연동 잔여 횟수는 연동 정보에서 확인할 수 있으며, 제공 횟수는 **매일 00시(자정)를 기준으로 자동 초기화**됩니다.

***

## **4. API**

젤라또·네이버 커머스·구글 머천트 API를 통해 상품 데이터를 실시간으로 전송하는 방식입니다.\
네이버 EP나 GMC Feed와 달리 별도의 스케줄이나 토글 설정 없이, **API 호출 시점에 즉시 데이터가 연동**됩니다.

<figure><img src="/files/WNOFuuq6jzl6yRYu03tA" alt=""><figcaption></figcaption></figure>

### **4-1. 사전 준비**

#### **Step 1. API 키 발급**

최초 진입 시에는 API 키가 발급되지 않은 상태입니다. <img src="/files/D8bt2ejlaVLCZeceC56k" alt="" data-size="line"> 버튼을 클릭하여 [**API 키 발급**](/settings/api-key.md) 페이지로 이동한 뒤, 새로운 API 키를 발급 받을 수 있습니다.

키 발급이 완료되면 카드 화면에 마스킹된 API 키와 <img src="/files/ecfezBgsc5cE1eQAYPpd" alt="" data-size="line"> 버튼이 표시됩니다.

<figure><img src="/files/kIkm936GfT5ao7dbEaKE" alt=""><figcaption></figcaption></figure>

#### **Step 2. API 키 확인**

<table><thead><tr><th width="160">기능</th><th>설명</th></tr></thead><tbody><tr><td><img src="/files/PyLSFx8ATrAjhrAks9Ad" alt="" data-size="line"> <strong>보기</strong></td><td>클릭 시 마스킹 처리된 API 키 전체를 확인합니다.</td></tr><tr><td><img src="/files/K1RqSs8YlSeRBtkhckek" alt="" data-size="line"> <strong>복사</strong></td><td>API 키를 클립보드에 복사합니다.</td></tr></tbody></table>

{% hint style="info" %}
발급된 API 키 하나로 젤라또, 네이버 커머스, GMC 등 **모든 API 연동에 공통으로 사용**할 수 있습니다.
{% endhint %}

{% hint style="warning" %}
API 키가 외부에 노출될 경우 무단으로 데이터가 전송되거나 훼손될 위험이 있습니다. 키가 유출되지 않도록 보안 관리에 주의해 주세요.
{% endhint %}

### **4-2. API 연동 가이드**

<img src="/files/ecfezBgsc5cE1eQAYPpd" alt="" data-size="line"> 버튼을 클릭하면 상세 안내 페이지로 이동합니다. 해당 [**API 연동 가이드**](/developers/product-collection.md)에서 사용하려는 API 유형(젤라또 API, 네이버 커머스 API, 구글 머천트 API)별 **엔드포인트와 요청 규격** 등을 확인할 수 있습니다.

***

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

<details>

<summary><strong>Q. EP URL이나 Feed URL을 어디서 확인하나요?</strong></summary>

네이버 EP URL은 네이버 쇼핑 파트너센터에서,\
GMC Feed URL은 Google Merchant Center에서 확인할 수 있습니다.

</details>

<details>

<summary><strong>Q. 피드 파일(EP, GMC) 내용이 업데이트될 때마다 URL을 다시 등록해야 하나요?</strong></summary>

**아닙니다. URL은 최초 한 번만 등록하시면 됩니다.**\
이후에는 기존과 동일한 URL 경로에 파일 내용만 갱신해 두시면, 설정하신 스케줄에 맞춰 시스템이 최신 데이터를 자동으로 수집합니다.

</details>

<details>

<summary><strong>Q. 네이버 EP, GMC 피드, API 등 여러 연동 방식을 동시에 사용하면 상품이 중복 생성되나요?</strong></summary>

**중복 생성되지 않습니다.**\
모든 연동 방식은 '상품 고유 식별 코드'를 기준으로 식별합니다. 동일한 상품 코드로 여러 방식의 데이터가 들어오더라도, 시스템에서 자동으로 항목(필드) 단위로 최신 정보를 안전하게 병합하여 업데이트합니다.

</details>

<details>

<summary><strong>Q. 연동 토글을 비활성화(OFF)하면 이미 수집된 상품은 어떻게 되나요?</strong></summary>

**기존 상품 데이터는 삭제되지 않으며, 검색 결과에도 정상적으로 노출됩니다.**\
토글 비활성화는 '새로운 데이터의 자동 수집'만 일시 중지하는 기능입니다. 만약 연동된 상품 전체를 쇼핑몰 검색 결과에서 즉시 숨기고 싶으시다면, 연동 비활성화가 아닌 상품 현황 페이지의 '검색 노출 설정' 토글을 OFF로 변경해 주세요.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.genser.ai/products/sync-management.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.