> 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/banner-x-reference-1.md). # 배너 X 참조 아래에는 다음에 설명된 표준 요청에서 가능한 속성이 요약되어 있습니다. [광고 요청](/retail-media-interface/integration/ko/generating-ads/banner-x-responsive/requesting-banner-x-ads.md) 요청의 경우 및 광고를 수신한 경우의 응답입니다. ## 요청된 항목 | String | 설명 | 필수/선택 | | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- | | `BannerSlotIds` | 요청 중인 배너 slotId의 json 배열입니다. | 필수 | | `catalogId` | 웹사이트의 제품 카탈로그 식별자입니다. | 필수 | | `contentStandardId` | 웹사이트의 콘텐츠 표준 식별자입니다. | 필수 | | `customerId` | 광고를 게재받는 고객의 고유 식별자입니다. | 선택 사항 | | `filterMode` | 요청 구조를 정의하는 선택적 방법입니다. 다음을 참조하세요. [광고 생성 필터링](/retail-media-interface/integration/ko/data-api/api-overview/ad-generation-filtering-1.md) 자세한 정보는 다음을 참조하세요. | 선택 사항, 권장됨 | | `maxNumberOfAds` | 반환받고자 하는 각 배너 슬롯의 최대 개수입니다. | 필수 | | `options` |

요청 구조를 정의하는 선택적 방법입니다. 자세한 정보는 광고 생성 필터링을 참조하세요.

이 객체는 유럽의 다음과 같은 현지 광고 법률을 준수하기 위해 광고주 정보를 요청할 수 있는 객체이기도 합니다. 디지털 서비스 법 .

| 선택 사항, 권장됨 | | `placement` | 광고를 요청하는 고유 게재위치입니다. | 필수 | | `productFilters` | 카테고리, 위치 또는 크기 필터와 같이 요청과 관련된 모든 제품 필터입니다. | 카테고리 게재위치에 필수 | | `searchTerm` | 고객이 웹사이트에 입력한 검색어입니다. | 검색 게재위치에 필수 | | `sessionId` | 고객 세션의 고유 식별자입니다. 표준 연동에서 기여도 측정에 사용됩니다. 다음을 검토하세요. [연동 워크플로 옵션](/retail-media-interface/integration/ko/data-api/api-overview/integration-workflow-options-1.md)자세한 정보는 다음을 참조하세요. | 표준 연동에서 필수 | | `slotId` | 여기에는 컨텍스트에서 요청된 모든 SlotId가 포함됩니다. 하나 이상 있을 수 있습니다. | 필수 | | `dtmCookieId` | 웹사이트에서 생성하고 저장한 쿠키로, 동일한 도메인에서 사용자 행동을 추적하는 데 사용됩니다. | 선택 사항 | | `audience` | 쇼퍼가 속한 특정 타겟 오디언스 세그먼트를 지정합니다. 다음을 사용하는 경우에만 해당됩니다. [오디언스 타겟팅 옵션 3](/retail-media-interface/integration/ko/data-api/audience-targeting-new/integration-option-3-sync-audiences-only.md) | 선택 사항 | ## 반환된 항목 | String | 설명 | 예시 값 | | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ads.backgroundColour` | 배너의 배경색 - HEX 값만 해당됩니다. | `6e6c6c` | | `ads.backgroundImage` | 배너 배경 이미지의 이미지 링크입니다. | `[]\() | | `ads.backgroundImagePosition` | 배경 이미지의 위치 유형을 정의합니다. 값이 없으면 기본값을 다음으로 설정해야 합니다. `leftaligned` . |

leftaligned
rightaligned
fill
repeating

| | `ads.bannerText` | 배너에 표시되는 텍스트입니다. HTML 태그가 포함될 수 있습니다. | `Double Fudge Ice Cream` | | `ads.bannerTextColour` | 배너 텍스트 색상 - HEX 값만 해당됩니다. Citrus는 다음을 전송하지 않습니다. `#`. | `1dc711` | | `ads.citrusAdId` |

광고의 고유 ID입니다.
이는 다음에 이루어진 각 요청마다 고유하며 Epsilon Retail Media 캐시할 수 없습니다.

| `shotgun_wIpZraEXcIu0daC5YMQewPil2S83NzE0MTA3` | | `ads.citrusCampaignName` | 광고의 캠페인 이름입니다. | `Epsilon-Example-Category-Banner-X-Ad-ae536b0d5c3ded28ea624ab4285facd6` | | `ads.citrusContentStandardId` | 슬롯과 관련된 콘텐츠 표준 ID입니다. | `8jsuwnfwe-1435-460b-9d2b-5d838e3dba9c` | | `ads.citrusExpiry` | 광고의 만료 시간입니다. 이는 다음으로 클릭을 보고할 수 있는 마지막 시점입니다. Epsilon Retail Media | `2021-06-01T23:48:16.573967987Z` | | `ads.citrusSlotId` | 요청한 배너의 특정 슬롯 ID입니다. | `Category_Top` | | `ads.contentStandardId` | 슬롯과 관련된 콘텐츠 표준 ID입니다. 다음의 중복입니다. `citrusContentStandardId` | `8jsuwnfwe-1435-460b-9d2b-5d838e3dba9c` | | `ads.ctaFlag` | CTA 표시 여부를 정의합니다. |

true
false

| | `ads.ctaLink` | CTA에서 전달된 URL입니다(배너의 linkUrl과 유사함). ctaFlag가 다음과 같은 경우에만 제공됩니다. `true` | ` | | `ads.ctaText` | CTA 내의 텍스트입니다. | `Shop now` | | `ads.ctaTextAccessibility` | 스크린 리더 사용자를 위한 CTA의 대체 텍스트입니다. | `for Double Fudge Ice Cream` | | `ads.gtins` |

캠페인의 광고 대상 제품 중에서 선택된 최대 20개의 제품 코드 배열입니다.

리테일러는 이 목록을 사용하여 배너 클릭 시 리스터 페이지를 자동화하거나 특정 렌더링 기능(라운델, 가격 설정, 보조 재고 수준 확인)을 자동화할 수 있습니다.

| `[
"7714107",
"7163379",
"7733636",
"7733657",
"7733628"
],` | | `ads.headingText` | 스크린 리더 사용자를 위한 제목 텍스트입니다. | `Banner Advertisement for Fudge Double Ice Cream with a product image and shop now button` | | `ads.heroImageAltText` | 히어로 이미지가 표시되지 않는 드문 경우를 위한 히어로 이미지의 대체 텍스트입니다. | `Image of double fudge iced cream` | | `ads.heroImage` | 배너 히어로 이미지의 이미지 링크입니다. | `[]\() | | `ads.position` | 응답에서 배너의 위치입니다. Epsilon Retail Media 고정 게재 캠페인이 활용되는 경우 이 위치를 준수해야 합니다. | 1 | | `ads.secondaryBackgroundImage` | 보조 배경 이미지의 이미지 링크입니다. | `[]\() | | `ads.secondaryBackgroundImagePosition` | 보조 배경 이미지의 위치 유형을 정의합니다. |

leftaligned
rightaligned

| | `ads.secondaryHeroImageAltText` | 드물게 보조 히어로 이미지가 표시되지 않는 경우를 대비한 대체 텍스트입니다. | `Image of [brand] logo` | | `ads.secondaryHeroImage` | 보조 히어로 이미지의 이미지 링크입니다. | `[]\() | | `ads.secondaryHeroMode` | 보조 히어로 이미지의 표시 모드를 정의합니다. 값이 없으면 기본값으로 설정해야 합니다. `block` . |

block
landscape

| | `ads.slotId` | 요청한 배너의 슬롯 ID입니다. 여러 배너를 요청할 때 요청된 ID를 참조하는 데 사용할 수 있습니다. | `Category_Top` | | `ads.tags` | 이 필드는 광고주가 캠페인에 입력한 제3자 태그를 반환합니다. API 응답 형식은 지정되어 있지만 현재 배너 x에서 지원되는 기능은 아닙니다. | `{}` | | `ads.sellerId` | 판매자의 고유 ID입니다. 팀에 sellerId가 설정되어 있는 경우에만 채워집니다. sellerIds는 일반적으로 마켓플레이스 판매자를 온보딩할 때 사용됩니다. | `73nns-32sxr-32ss` 연동별 맞춤 지정 | | `ads.metadata` |

광고주가 다음과 같은 지역 광고 법률을 준수할 수 있도록 돕는 데 필요한 광고주 정보가 포함된 개체입니다. 디지털 서비스 법 유럽의 경우.

advertiser 은 공급업체 팀의 회사명에서 가져옵니다.

onBehalfOf 은 공급업체 팀의 광고 재정 지원자에서 가져옵니다.

| `"metadata": {
"advertiserInfo": {
"advertiser": "Bob's advertising agency",
"onBehalfOf": "Brand company inc"
}
...` | | `ads.adm` | VAST 태그를 포함한 비디오 광고 세부 정보가 포함된 개체입니다. | "\n\\n \\n \\n \Epsilon Retail Media\\n \!\[CDATA\[]] \\n \\n \!\[CDATA\[]] \\n \\\n \\\n \\n \VAST-4.0-Short-Intro.mp4\\n <크리에이티브s>\n <크리에이티브>\n \VAST-4.0-Short-Intro.mp4\\n \\n \\\n \\n \!\[CDATA\[]] \\n \!\[CDATA\[]] \\n \\n \\n \!\[CDATA\[]] \\n \\\n \\n \\n \\n \\n \\n \\n\" | | `ads.companionProducts` | 컴패니언 상품 세부 정보입니다. |

“companionProducts”: \[
"Banana14-simfk15"
"Oranges5-qgxeb6",
"Incaberries20-ppscn21"

| | `metadata.warnings` | 광고 요청에 대한 경고 정보가 포함된 개체입니다. 현재 세그먼트의 최대 수를 초과한 경우에만 경고합니다. | `"metadata": {
"warnings": [
"Audience Segment IDs exceeded the limit of {maxSegmentIds} and were truncated"
]
}` | {% hint style="info" %} 광고 캠페인의 일부로 구성되지 않은 필드가 있는 경우 제공되지 않습니다. 즉, 광고주가 구성을 하지 않은 경우 `heroImage`, Epsilon Retail Media 은(는) 다음 항목을 제공하지 않습니다: `heroImage` 속성. {% endhint %} --- # 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/banner-x-reference-1.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.