> 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/ja/feature-integrations/integrating-parent-products.md).
# 親商品の連携
## 子商品とは何ですか？
一部の商品には親／子の関係があります。1つの親商品が存在し、複数のバリエーションが子商品となります。広告主は、最も関連性が高くパフォーマンスの優れた商品を顧客に訴求できるよう、子商品レベルでキャンペーンを最適化したいと考えています。
その他の商品にはこのような関係がないため、プラットフォーム内での変更や影響はありません。
## UI機能
### 商品選択
商品を選択する際、親／子商品はグループ化されます。
親商品をクリックすると展開され、子商品が表示されます。これにより、広告主はキャンペーンにおいて固有の子商品レベルまで最適化できるようになります。
### レポート
プラットフォーム内のレポートでは、商品に `productCollection` が関連付けられている場合、親商品ごとに自動的にグループ化されます。
プラットフォームからのCSVエクスポートでは、商品コード用に新しい「Parent Code」列が追加され、 `productCollection` の値が入力されます。
UIで商品コードによってフィルタリングしている場合、親商品のメトリクスは空欄になり、親商品をクリックすると任意の子商品のレポートが表示されます。
## 統合要件
### 商品の更新
商品を Epsilon Retail Mediaと同期する際、商品に対するPOSTリクエストに新しい `productCollection` フィールドが追加されます。
```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から広告をレンダリングする際に必要な変更はありません。APIレスポンスで受信する `gtin` は「子」商品のものとなるため、それをウェブサイト上で顧客に対してレンダリングする必要があります。
---
# 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/ja/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.