> 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-ad-static-reference.md).
# 배너 광고(정적) 참조
아래는 다음 문서에 개요가 설명된 표준 요청에서 가능한 속성을 개략적으로 설명합니다: [배너 광고 요청하기](/retail-media-interface/integration/ko/generating-ads/banner-ads-static/requesting-banner-ads.md) 요청에 대한 정보 및 광고를 수신한 경우의 응답입니다.
{% hint style="info" %}
배너 광고는 상품 광고와 동일한 `/generate` 엔드포인트에서 요청됩니다. 단일 요청을 사용하여 두 광고 유형을 모두 조회할 수 있습니다.
{% endhint %}
## 요청된 항목
| String | 설명 | 필수/선택 |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| `bannerSlots` | 배너 광고를 수신하려는 배너 슬롯의 배열입니다. 배너 슬롯에 maxNumberOfAds를 지정하면 해당 슬롯에 대해 둘 이상의 배너를 조회할 수 있습니다. 이러한 유스케이스는 캐러셀 지면에 해당합니다. | 필수 |
| `bannerSlotIds` | 배너 광고를 수신하려는 배너 슬롯의 배열입니다. | 필수, bannerSlots에 의해 대체됨 |
| `catalogId` | 웹사이트의 상품 카탈로그 식별자입니다. | 필수 |
| `contentStandardId` | 웹사이트의 콘텐츠 표준 식별자입니다. | 필수 |
| `customerId` | 광고를 게재받는 고객의 고유 식별자입니다. | 선택 |
| `filterMode` | 요청 구조를 정의하는 선택적 방법입니다. 다음을 참조하세요: [광고 생성 필터링](/retail-media-interface/integration/ko/data-api/api-overview/ad-generation-filtering-1.md) 자세한 정보. | 선택, 권장됨 |
| `maxNumberOfAds` | 반환받고자 하는 상품 광고의 최대 개수(최대 15개)입니다. | 필수, 동일한 요청에서 상품 광고가 게재되도록 설정합니다. 상품 광고를 원하지 않는 경우 다음과 같이 설정하세요: `0` |
| `options` | 요청 구조를 정의하는 선택적 방법입니다. 다음을 참조하세요: 광고 생성 필터링 자세한 정보.
유럽의 다음 법률과 같은 현지 광고 법률을 준수하기 위해 광고주 정보를 요청할 수 있는 객체이기도 합니다: 디지털 서비스법 .
| 선택, 권장됨 |
| `placement` | 광고를 요청하는 고유 지면입니다. | 필수 |
| `productFilters` | 카테고리, 위치 또는 크기와 같이 요청과 관련된 모든 상품 필터입니다. | 필수 |
| `sessionId` | 고객 세션의 고유 식별자입니다. 표준 연동에서 기여도 측정에 사용됩니다. 자세한 내용은 연동 워크플로 옵션을 검토하세요. | 표준 연동에서 필수 |
| `dtmCookieId` | 동일한 도메인에서 사용자 행동을 추적하는 데 사용되며 웹사이트에서 생성 및 저장되는 쿠키입니다. | 선택 |
| `audience` | 쇼퍼가 속한 특정 오디언스 세그먼트를 지정합니다. 다음을 사용하는 경우에만 관련이 있습니다: [오디언스 타겟팅 옵션 3](/retail-media-interface/integration/ko/data-api/audience-targeting-new/integration-option-3-sync-audiences-only.md) | 선택 |
## 반환된 항목
| String | 설명 | 예시 값 |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `banners.altText` | 히어로 이미지가 표시되지 않는 드문 경우에 사용되는 대체 텍스트입니다. | `Advertisement for <BRAND>. Art of the Burger. Create your delicious masterpiece. Shop Now.` |
| `banners.contentStandardId` | 웹사이트의 콘텐츠 표준 식별자입니다. | \`4ffb80ba-b9a9-4567-8069-79b2eca93473 |
| `banners.expiry` | 광고의 만료 시간입니다. 이는 클릭을 다음에 보고할 수 있는 마지막 시점입니다: Epsilon Retail Media | `2021-06-01T23:48:16.573967987Z` |
| `banners.id` | 광고의 고유 ID입니다.
이는 다음으로 전송되는 각 요청마다 고유하며 Epsilon Retail Media 캐시할 수 없습니다.
| `banner_j2vfi9pN2BiQZk4X9sC55PgNu5k3ODIzOTlfMDAwODc2ODQwMDEwNzM=` |
| `banners.imageUrl` | 배너의 이미지 링크입니다. | `[]\() |
| `banners.gtins` | 캠페인의 광고 상품에서 선택된 최대 20개의 상품 코드 배열입니다. | `[
"7714107",
"7163379",
"7733636",
"7733657",
"7733628"
],` |
| `banners.linkUrl` | 고객이 배너를 클릭할 때 배너에서 전달되는 URL입니다. | ` |
| `banners.slotId` | 요청한 배너의 특정 슬롯 ID입니다. | `Category_Top` |
| `banners.tags` | 이 필드는 광고주가 캠페인에 입력한 제3자 태그를 반환합니다. | `{
"dv": "<script src=\"" type=\"text/javascript\"></script>"
}` |
| `banners.text` | 맞춤형 연동에서 추가 텍스트 필드로 사용됩니다. | |
| `banners.position` | 응답에서 광고의 위치입니다. Epsilon Retail Media 고정 게재 캠페인이 활용되는 경우 이 위치를 준수해야 합니다. | 1 |
| `banners.sellerId` | 판매자의 고유 Id입니다. 팀에 sellerId가 설정된 경우에만 채워집니다. sellerIds는 일반적으로 마켓플레이스 판매자를 온보딩할 때 사용됩니다. | `73nns-32sxr-32ss` 연동별 맞춤 설정 |
| `banners.metadata` | 유럽의 다음 법률과 같은 현지 광고 법률을 광고주가 준수하도록 지원하는 데 필요한 광고주 정보를 포함하는 객체입니다: 디지털 서비스법 에서.
advertiser 은 공급업체 팀의 회사 이름에서 가져옵니다.
onBehalfOf 은 공급업체 팀의 광고 재정 지원자에서 가져옵니다.
| `"metadata": {
"advertiserInfo": {
"advertiser": "Bob's advertising agency",
"onBehalfOf": "Brand company inc"
}
...` |
| `metadata.warnings` | 광고 요청에 대한 경고 정보를 포함하는 객체입니다. 현재는 최대 세그먼트 수를 초과한 경우에만 경고합니다. | `"metadata": {
"warnings": [
"Audience Segment IDs exceeded the limit of 100 and were truncated"
]
}` |
---
# 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-ad-static-reference.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.