> 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/feature-integrations/integrating-parent-products.md).
# 상위 상품 연동
## 하위 제품이란 무엇인가요?
일부 제품에는 상위/하위 관계가 있습니다. 하나의 상위 제품이 존재하며, 여러 가지 변형이 하위 제품이 됩니다. 광고주는 고객에게 가장 관련성이 높고 실적이 우수한 제품을 홍보하기 위해 하위 제품 수준에서 캠페인을 최적화하고자 합니다.
다른 제품에는 이러한 관계가 없으므로 플랫폼에서 아무런 변경 사항이나 영향을 받지 않습니다.
## UI 기능
### 제품 선택
제품을 선택할 때 상위/하위 제품이 함께 그룹화됩니다.
상위 제품을 클릭하면 확장되어 하위 제품이 표시됩니다. 이를 통해 광고주는 캠페인에서 고유한 하위 제품 수준으로 최적화할 수 있습니다.
### 리포팅
플랫폼 내 리포팅은 제품에 다음과 관련된 연관이 있을 때 상위 제품별로 자동 그룹화합니다. `productCollection` 와(과) 연관되어 있습니다.
플랫폼의 CSV 내보내기에서 제품 코드의 경우 새로운 "Parent Code" 열이 생성되며, 여기에 다음 값이 채워집니다. `productCollection` 값.
UI에서 제품 코드로 필터링하는 경우 상위 제품 지표는 공란으로 표시되며, 상위 제품을 클릭하여 모든 하위 제품에 대한 리포팅을 볼 수 있습니다.
## 연동 요구 사항
### 상품 업데이트
상품을 다음 서비스와 동기화할 때: Epsilon Retail Media이(가) 신규 작성됨 `productCollection` 상품에 대한 POST 요청의 필드입니다.
```http
POST $BASE_URL/v1/catalog-products?teamId= HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic
{
"catalogProducts": [
{
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"gtin": "23556578965543",
"productCollection": "abc-123",
"inventory": 50,
"price": "19.99",
"tags": [
"imageurl:https://your.image.host.com/image.jpg","name:Covergirl Clean 120 Creamy Natural Liquid Foundation30mL"
],
"filters": [
"category:Health&Beauty","category:Grocery","Brand:Covergirl","Special_Flag:0"
]
}
]
```
이 필드가 존재하면 상품 선택 및 보고서 테이블은 동일한 값을 가진 모든 상품에 대해 상품 컬렉션 수준에서 집계됩니다. `productCollection`.
파일로 동기화하는 경우, 옵션으로 상품별로 입력할 수 있는 `product_collection` 열이 있습니다.
### 광고 렌더링
다음 서비스에서 광고를 렌더링할 때 필요한 변경 사항은 없습니다: Epsilon Retail Media. 귀하가 `gtin` API 응답으로 받는 내용은 "하위" 상품의 내용이며, 귀하의 웹사이트에서 고객에게 해당 내용을 렌더링해야 합니다.
---
# 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/feature-integrations/integrating-parent-products.md?ask=&goal=
```
`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.