> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/ko/references/catalog-products-reference.md).

# 카탈로그 상품 참조

아래는 다음 문서에 개요가 설명된 표준 동기화 요청에서 가능한 속성을 개략적으로 설명합니다: [API를 통한 제품 동기화](/retail-media-interface/integration/ko/data-api/catalog-products-2/syncing-products-via-api.md).

## 요청 항목

| 속성          | 설명                                                                                                                              | 필수/선택                                                                 | 예시                                                                                                                    |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `catalogId` | 동기화 중인 카탈로그입니다.                                                                                                                 | 필수                                                                    | `628dbe95-2ec9-4e07-881d-3e9f92ab2e0b`                                                                                |
| `filters`   | 제품과 관련된 필터입니다. 카테고리, 위치 및 브랜드 정보일 수 있습니다.                                                                                       | <p>필수<br>최대 750자</p>                                                  | `"category:Health&Beauty","category:Grocery","Brand:Covergirl","Special_Flag:0"`                                      |
| `groups`    | 교차 판매 및 업셀 캠페인에 사용됩니다.                                                                                                          | <p>선택 그룹의 경우 더 이상 사용되지 않습니다.<br>기존 제품 교차 판매 및 업셀 캠페인에는 여전히 필요합니다.</p> | `[<br> "subClassName:Milk",<br> "xSellSubClassName:Coffee",<br> "xSellSubClassName:Tea"<br> "vendor:MilkBrand"<br> ]` |
| `gtin`      | 시스템 내 제품의 제품 코드입니다.                                                                                                             | <p>필수<br>최대 50자</p>                                                   | `23556578965543`                                                                                                      |
| `inventory` | <p>시스템 내 제품의 재고입니다. 0으로 설정하면 제품 광고가 게재되지 않습니다.<br><br>수량을 제공할 수 없는 경우 이 필드를 보내지 마십시오. Epsilon Retail Media 기본 재고가 1로 설정됩니다.</p> | <p>필수<br>32비트 부호 없는 정수 권장</p>                                         | `1`                                                                                                                   |
| `price`     | 제품의 가격                                                                                                                          | <p>선택<br>소수점 2자리 권장</p>                                               | `9.90`                                                                                                                |
| `profit`    | 제품에서 발생한 이익                                                                                                                     | <p>선택<br>소수점 2자리 권장</p>                                               |                                                                                                                       |
| `tags`      | 포털에 표시되는 제품 이름 및 이미지를 동기화하는 데 사용됩니다. 예시의 구조를 따르세요. Epsilon Retail Media 포털. 예시의 구조를 따르세요.                                       | <p>필수<br>최대 750자</p>                                                  | `"imageurl:<https://your.image.host.com/image.jpg","name:Covergirl> Clean 120 Creamy Natural Liquid Foundation30mL"`  |
| `sellerId`  | 판매자의 고유 Id입니다. sellerIds는 일반적으로 마켓플레이스 판매자를 온보딩할 때 사용됩니다.                                                                       | <p>선택<br>최대 50자</p>                                                   | `73nns-32sxr-32ss` 연동별 맞춤 설정                                                                                          |


---

# 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.citrusad.com/retail-media-interface/integration/ko/references/catalog-products-reference.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.