> 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/generating-ads/banner-x-responsive/companion-products-banner-x.md).
# 컴패니언 상품
{% hint style="info" %}
베타 기능
이 기능은 현재 베타 버전이며 변경될 수 있습니다. 기능 개선을 위해 고객님의 피드백을 제공해 주시기 바랍니다.
{% endhint %}
컴패니언 상품 구성 요소를 통해 브랜드는 배너와 함께 구매 가능한 상품의 순서 지정된 목록을 선택할 수 있습니다. 이를 배너에 렌더링하여 고객이 배너에서 직접 쇼핑할 수 있는 기능을 활성화할 수 있습니다. 이는 배너 상호작용 증가 및 CTR 상승으로 이어질 수 있습니다.
## 사양
* **컴패니언 상품** 섹션에 사용할 수 있는 상품은 이전 **상품** 캠페인 생성 단계에서 선택한 상품으로 제한됩니다.
* 각 슬롯에 대해 필요한 **컴패니언 상품** 수를 지정할 수 있습니다.
* 캠페인을 생성할 때 **컴패니언 상품**을 원하는 순서대로 정렬할 수 있으며, 이 순서는 광고 응답에서 유지됩니다.
## 컴패니언 상품 연동
컴패니언 상품을 통해 브랜드는 배너와 함께 구매 가능한 상품의 순서 지정된 목록을 선택할 수 있습니다.
### 연동하기 전에
* 컴패니언 상품을 지원하려면 배너 X 응답의 새 필드에 대한 파싱 방법을 업데이트하세요.
* 비디오 광고와 함께 컴패니언 상품을 연동할 때 선택한 비디오 플레이어를 사이트 또는 모바일 앱에 선택하거나 연동하세요.
* 비디오 광고 및 컴패니언 상품을 추가하기 위한 필드는 비디오 및 상품 컴패니언이 구성된 캠페인에 대해서만 채워집니다. 활성화는 연동이 완료된 후에만 발생합니다.
* 새로운 컴패니언 상품 및 비디오 기능을 렌더링하도록 미리보기 도구를 업데이트하세요.
### 컴패니언 상품에 대한 광고 응답 예시
캠페인에 컴패니언 상품이 구성되어 있으면 다음이 표시됩니다. `companionProducts` 객체가 반환되었습니다.
```
{
"ads": [
{
"contentStandardId": "c47c9ca2-ad3b-48cc-880b-e899c1661726",
"slotId": "Top_Banner",
"banners": [
{
"citrusAdId": "shotgun_8SvgA7OvvuwtZkkOKR0vr8AXMvQKFgoURmluZ2VybGltZTI2LWZkeHZxMjcSABoMCO30r70GEKPplJQCIgIIAQ==",
"citrusCampaignName": "Ads:74-330-96832622ed499dafb3da8de8b76340a2",
"citrusContentStandardId": "c47c9ca2-ad3b-48cc-880b-e899c1661726",
"citrusSlotId": "Top_Banner",
"citrusExpiry": "2025-02-12T01:33:33.579155107Z",
"headingText": "recusandae 3205",
"bannerText": "placeat 2825",
"bannerTextColour": "ffffff",
"ctaFlag": true,
"ctaText": "CTA text",
"ctaTextAccessibility": "call to action accessibility text",
"ctaLink": http://citrusad.com,
"backgroundColour": "000000",
"backgroundImage": https://dev3.flavedo.io./citrus/8de07ed9-60b4-4611-8bd5-3f1f0c0b6be4,
"secondaryBackgroundImage": https://dev3.flavedo.io./citrus/b7a70785-1366-42c6-8134-c7fe47a30c34,
"secondaryBackgroundImagePosition": "rightaligned",
"heroImage": https://dev3.flavedo.io./citrus/26798ca9-1022-422d-9100-1a3687c88372,
"heroImageAltText": "hero image alt text",
"secondaryHeroImage": https://dev3.flavedo.io./citrus/c4ee18b4-bf51-44d7-9eb6-eeb1dc4c422f,
"secondaryHeroImageAltText": "secondary hero image alt text",
"secondaryHeroMode": "landscape",
"tags": {},
"additionalFields": [
{
"id": "text-1",
"value": "sed 5731"
}
],
"gtins": [
"Fingerlime26-fdxvq27",
"Oranges5-qgxeb6",
"Cherries9-adkoj11",
"Incaberries20-ppscn21",
"Banana14-simfk15"
],
"sellerId": "seller_id_772_659",
"position": 1,
"metadata": {
"advertiserInfo": {
"advertiser": "Bob's advertising agency",
"onBehalfOf": "Brand company inc"
}
},
"companionProducts": [
"Banana14-simfk15"
"Oranges5-qgxeb6",
"Incaberries20-ppscn21",
]
}
]
}
]
}
```
---
# 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/generating-ads/banner-x-responsive/companion-products-banner-x.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.