> 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-ads-static/requesting-banner-ads.md).

# 배너 광고 요청

## 광고 요청하기

상품 광고와 배너는 동일한 엔드포인트에서 생성되므로 지면의 컨텍스트가 같은 경우 배너와 동일한 요청에서 상품 광고를 요청할 수 있습니다.

수신할 수 있는 상품 광고 수는 다음을 정의하여 설정합니다: `maxNumberOfAds` 파라미터. 수신할 수 있는 배너 광고 수는 다음으로 설정할 수 있습니다: `maxNumberOfAds` 고유 slotId당 속성

모든 배너 광고 요청에는 다음이 필요합니다. `contentStandardId` 및 `bannerSlots` 광고를 요청하는 대상입니다. 또한 배너 호출에는 컨텍스트의 다음 항목이 포함되어야 합니다. `customerId`,`sessionId`,`placement`, 및 `catalogId`.

{% hint style="info" %}
여기에 약간의 변경 사항이 있음을 확인하실 수 있습니다!

에서 배너 광고를 요청하는 방식에 대한 변경 사항을 도입하는 중입니다 Epsilon Retail Media. 이미 연동되어 있는 경우 다음이라는 속성으로 요청할 수 있습니다 `bannerSlotIds`. 이것은 당사의 새로운 `bannerSlots` 기능으로 대체되었습니다. 다음 속성으로 광고를 요청하는 방법을 검토하려면 `bannerSlotIds` 속성의 경우 이 페이지 하단으로 이동하세요.

이 `bannerSlots` 기능은 2022년 9월에 출시되었습니다.
{% endhint %}

### 검색 게재위치

검색 게재위치는 일반적으로 가장 요청하기 쉽습니다. 요청 시 다음이 지정되어야 합니다 `searchTerm` 아래 예시와 같이 요청 시 지정되어야 합니다:

```http
POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customerId": "wertg5432a",
    "sessionId": "ec9-4e07-881d-3e9",
    "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
    "placement": "search",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "searchTerm": "chocolate",
    "options": {
   						 "filterMode": "AndOr"
 							 },
    "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9",
    "bannerSlots": [
           {
      "slotId": "<SLOT_ID>",
      "maxNumberOfAds": 1
    },
    {
      "slotId": "<SLOT_ID>",
      "maxNumberOfAds": 2
    }
    ],
    "maxNumberOfAds": 3
}
```

### 카테고리 지면

카테고리 지면에는 다음 항목을 `productFilters` 요청에 지정해야 합니다. 아래는 카테고리 필터를 전송하는 위치의 예시입니다.

```http
POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customerId": "wertg5432a",
    "sessionId": "ec9-4e07-881d-3e9",
    "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
    "placement": "category",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "productFilters": [
     	 ["category:Cupboard/Snacks"]
    ],
    "options": {
   							 "filterMode": "AndOr"
 							 },
    "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9",
    "bannerSlots": [
           {
      "slotId": "<SLOT_ID>",
      "maxNumberOfAds": 1
    },
    {
      "slotId": "<SLOT_ID>",
      "maxNumberOfAds": 2
    }
    ],
    "maxNumberOfAds": 3
}
```

추가 카테고리를 찾아볼 때 그에 맞게 API 호출을 업데이트해야 합니다.

### 교차 판매 카테고리 지면

교차 판매 카테고리 지면은 카테고리 지면과 매우 유사한 요청을 가집니다. 광고를 요청하는 정확한 카테고리를 지정해야 합니다. 이는 일반적으로 현재 있는 페이지입니다. 다음 항목에 카테고리를 지정하세요: `productFilters` 요청의 일부입니다. 아래 예시는 카테고리 필터를 전송하는 위치를 보여줍니다.

```http
POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customerId": "wertg5432a",
    "sessionId": "ec9-4e07-881d-3e9",
    "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
    "placement": "category-cross-sell",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "productFilters": [
     	 ["category:Cupboard/Snacks"]
    ],
    "options": {
   							 "filterMode": "AndOr"
 							 },
    "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9",
    "bannerSlots": [
           {
      "slotId": "<SLOT_ID>",
      "maxNumberOfAds": 1
    },
    {
      "slotId": "<SLOT_ID>",
      "maxNumberOfAds": 2
    }
    ],
    "maxNumberOfAds": 3
}
```

추가 카테고리를 찾아볼 때 그에 맞게 API 호출을 업데이트해야 합니다.

{% hint style="info" %}
오가닉 및 교차 판매 카테고리 타겟팅을 병합하시겠습니까?

오가닉 및 교차 판매 카테고리 광고 요청을 단일 지면으로 병합하려는 경우, 고객에게 병합 및 전달 로직을 구현해야 합니다. 이는 연동 담당자의 책임이지만, Epsilon Retail Media 기꺼이 자문을 제공해 드립니다.

일반적으로 오가닉 카테고리 광고를 먼저 표시하고, 오가닉 지면 뒤에 위치 및 카테고리 교차 판매 광고를 게재하는 것을 권장합니다.
{% endhint %}

### 확장 검색 지면

홈 또는 결제 페이지와 같은 확장 지면에는 어떠한 `productFilters` 도 요청에 지정할 필요가 없습니다. 리테일러가 지정하고자 하는 모든 필터(할인 중, 신상품 등)는 다음 항목에 지정할 수 있습니다: `productFilters` 을(를) 보장하려면 Epsilon Retail Media 아래 예시와 같이 요구 사항 내에서만 광고를 노출합니다.

```http
POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customerId": "wertg5432a",
    "sessionId": "ec9-4e07-881d-3e9",
    "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
    "placement": "home",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "productFilters": [
     	 []
    ],
    "options": {
   							 "filterMode": "AndOr"
 							 },
    "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9",
    "bannerSlots": [
           {
      "slotId": "<SLOT_ID>",
      "maxNumberOfAds": 1
    },
    {
      "slotId": "<SLOT_ID>",
      "maxNumberOfAds": 2
    }
    ],
    "maxNumberOfAds": 3
}
```

### 요청 개선 사항

사용자 경험을 향상시키기 위해 아래의 개선 사항을 고려하는 것이 좋습니다.

#### 필터링된 검색

고객이 검색 결과를 필터링하는 경우 문맥을 확장하여 다음을 제공할 수 있습니다: `productFilters`. 아래는 고객이 "Cupboard" 카테고리와 "Gluten-free" 식이 제한으로 필터링하는 예시입니다. 이와 동일한 원칙을 모든 카테고리 또는 확장 검색 지면에 적용할 수 있습니다.

```http
POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customerId": "wertg5432a",
    "sessionId": "ec9-4e07-881d-3e9",
    "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
    "placement": "search",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "searchTerm": "chocolate",
    "productFilters": [
     	 ["category:Cupboard"],["dietary:Gluten-free"]
    ],
    "options": {
   							 "filterMode": "AndOr"
 							 },
    "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9",
    "bannerSlots": [
           {
      "slotId": "<SLOT_ID>",
      "maxNumberOfAds": 1
    },
    {
      "slotId": "<SLOT_ID>",
      "maxNumberOfAds": 2
    }
    ],
    "maxNumberOfAds": 3
}
```

#### 위치별 필터링

카탈로그에서 위치 필터를 동기화하는 경우 컨텍스트를 확장하여 다음에서 고객의 매장 위치를 제공할 수 있습니다. `productFilters`, 아래 예시와 같이:

```http
POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customerId": "wertg5432a",
    "sessionId": "ec9-4e07-881d-3e9",
    "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
    "placement": "search",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "searchTerm": "chocolate",
    "productFilters": [
     	 ["category:Cupboard"],["dietary:Gluten-free"],["location:Westenbury"]
    ],
    "options": {
   							 "filterMode": "AndOr"
 							 },
    "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9",
    "bannerSlots": [
           {
      "slotId": "<SLOT_ID>",
      "maxNumberOfAds": 1
    },
    {
      "slotId": "<SLOT_ID>",
      "maxNumberOfAds": 2
    }
    ],
    "maxNumberOfAds": 3
}
```

### 사용 중 bannerSlotIds 매개변수(기존 방식)

이미 연동된 경우 다음과 같이 광고를 요청할 수 있습니다. `bannerSlotIds` 대신 . `bannerSlots`. 이것은 필요한 배너 슬롯의 광고를 지정하는 문자열 배열입니다. 동일한 배너 슬롯에 대해 둘 이상의 광고를 요청할 수 있도록 기능을 개선했습니다. 관심이 있는 경우 연동 방식을 향상시켜 위에 개요가 설명된 `bannerSlots` 메서드로 업그레이드해야 합니다.

```http
POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customerId": "wertg5432a",
    "sessionId": "ec9-4e07-881d-3e9",
    "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
    "placement": "search",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "searchTerm": "chocolate",
    "productFilters": [
     	 ["category:Cupboard"],["dietary:Gluten-free"],["location:Westenbury"]
    ],
    "options": {
   							 "filterMode": "AndOr"
 							 },
    "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9",
    "bannerSlotIds": [
        "<SLOT_ID>","<SLOT_ID>"
    ],
    "maxNumberOfAds": 3
}
```

## 배너 광고 응답

모든 응답은 동일한 JSON 형식을 따릅니다. 상품 광고를 요청하는 경우 `ads` 배열은 아래 예시와 같이 채워집니다. 배너는 `banners` 배열을 채우므로 광고가 있는 배너 슬롯에 대해서만 콘텐츠가 반환됩니다.

```json
{
    "ads": [
        {
            "id": "display__QqHaKRrKlFm1Wxr9c_DXJN4HSE3NzMzNjM2",
            "gtin": "7733636",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400902957Z",
            "position": 1
        },
        {
            "id": "display_NzsHqP0_iQedlo9VnrO2vqkwi_k3NzMzNjI4",
            "gtin": "7733628",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400908257Z",
            "position": 2
        }
    ],
    "banners": [
				{
            "id": "banner_XeemTeq59HapGSp4vccOYfBq_yvc3zMzNjM2",
            "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9",
            "slotId": "<SLOT_ID>",
            "imageUrl": "https://cdn.flavedo.io/s/-oW-C3cEViSSO2krWkwOBUXOhvUdhHOySx-YQLGZ1lA=",
            "linkUrl": "https://www.retailer.com/link",
            "altText": "Your local ice cream",
            "text": "",
            "gtins": [
                "7733628",
                "7714107",
                "7163379",
                "7733636",
                "7733657"
            ],
            "expiry": "2021-05-17T01:49:17.75503253Z",
            "tags": {},
            "position": 1
        },
				{
            "id": "banner_A0KA6mNmFs6sZPb_FvwWe5k6x6c3NzMzNjM3",
            "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9",
            "slotId": "<SLOT_ID>",
            "imageUrl": "https://cdn.flavedo.io/s/-oW-dfsgrerWkwOBUXOhvUdhHOySx-YQLreGZ1lw=",
            "linkUrl": "https://www.retailer.com/link",
            "altText": "Advertisement for pet food.",
            "text": "",
            "gtins": [
                "16309011",
                "57312011",
                "65250011"
            ],
            "expiry": "2021-05-17T01:49:17.75503253Z",
            "tags": {},
            "position": 2
        }
				],
    "products": [],
     "memoryToken":"85ykKVv-luDHMWLZx2d6xcPq6sF7CgkJCSJDb3VudGVyIjogIjIiLAoJCQkiQWRzIjogWwoJCQkJImRpc3BsYXlfV05VV0NwQkRKMUpKNm5wdVZSVExvOU40TUxzNE1UWTBOemt5TWc9PSIsCgkJCQkiZGlzcGxheV9MME5NUHRxNmdCcVFvREJOd3J0dE9UTGJoWk0xTVRFeU9UYzRPUT09IiwKCQkJCSJkaXNwbGF5XzlCcEpmdUpaWk9VXzgyaWpFM3VCczgxd3VVczRNekkwTnpVeE5nPT0iLAoJCQkJImRpc3BsYXlfcW1VU1p4TkpMQ0lqeWQwdTFJRDk0RmxVZ0pnNE16STBOelV4Tnc9PSIsCgkJCQkiZGlzcGxheV9oeHlFZktCUnRrNWlxMThMQzE1SDJHcEN3QjgxTVRFeU9UYzVNQT09IiwKCQkJCSJkaXNwbGF5X1NkcjFEcU5aUEFtcGh0Q1FIUndoYUxFT1B0RXhNamsxT1RJNE5BPT0iLAoJCQkJImRpc3BsYXlfeVlSai1qV2Ntc2ozNzhrel9PMm0yOVlwTjhJeE5EazNPRE00TXc9PSIsCgkJCQkiZGlzcGxheV9Xbm9NZGZuLTRTVmhxcF9xQzVvLWxoT0paNm8xTkRJeE1UUTROdz09IgoJCQldLAoJCQkiVFRMIjogMTYyODk4NTYwMAoJCX0="
}
```

The `id` 필드는 노출 및 클릭 보고서에 사용되는 광고 ID입니다. 각 문자열에 대한 자세한 내용은 레퍼런스를 참조하세요.

### 마켓플레이스 sellerId

마켓플레이스 판매자를 온보딩하는 경우 응답의 광고당 추가 `sellerId` 가 표시될 수 있습니다. 이는 제공되는 캠페인을 소유한 팀의 UI에 판매자 ID가 구성되어 있는 경우에만 나타납니다. 아래 예시는 sellerId가 있는 광고 하나와 없는 광고 하나를 보여줍니다.

```json
{
    "ads": [
        {
            "id": "display_QqHaKRrKlFm1Wxr9c_DXJN4HSE3NzMzNjM2",
            "gtin": "7733636",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400902957Z",
            "position": 1
        },
        {
            "id": "display_NzsHqP0_iQedlo9VnrO2vqkwi_k3NzMzNjI4",
            "gtin": "7733628",
            "sellerId": "2834-ascre-2wcr4",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400908257Z",
            "position": 2
        }
    ],
     "banners": [
				{
            "id": "banner_XeemTeq59HapGSp4vccOYfBq_yvc3zMzNjM2",
            "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9",
            "slotId": "<SLOT_ID>",
            "sellerId": "43d-w4-2wcr4",
            "imageUrl": "https://cdn.flavedo.io/s/-oW-C3cEViSSO2krWkwOBUXOhvUdhHOySx-YQLGZ1lA=",
            "linkUrl": "https://www.retailer.com/link",
            "altText": "Your local ice cream",
            "text": "",
            "gtins": [
                "7733628",
                "7714107",
                "7163379",
                "7733636",
                "7733657"
            ],
            "expiry": "2021-05-17T01:49:17.75503253Z",
            "tags": {},
            "position": 1
        },
				{
            "id": "banner_A0KA6mNmFs6sZPb_FvwWe5k6x6c3NzMzNjM3",
            "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9",
            "slotId": "<SLOT_ID>",
            "imageUrl": "https://cdn.flavedo.io/s/-oW-dfsgrerWkwOBUXOhvUdhHOySx-YQLreGZ1lw=",
            "linkUrl": "https://www.retailer.com/link",
            "altText": "Advertisement for pet food.",
            "text": "",
            "gtins": [
                "16309011",
                "57312011",
                "65250011"
            ],
            "expiry": "2021-05-17T01:49:17.75503253Z",
            "tags": {},
            "position": 2
        }
				],
    "products": [],
    "memoryToken":"85ykKVv-luDHMWLZx2d6xcPq6sF7CgkJCSJDb3VudGVyIjogIjIiLAoJCQkiQWRzIjogWwoJCQkJImRpc3BsYXlfV05VV0NwQkRKMUpKNm5wdVZSVExvOU40TUxzNE1UWTBOemt5TWc9PSIsCgkJCQkiZGlzcGxheV9MME5NUHRxNmdCcVFvREJOd3J0dE9UTGJoWk0xTVRFeU9UYzRPUT09IiwKCQkJCSJkaXNwbGF5XzlCcEpmdUpaWk9VXzgyaWpFM3VCczgxd3VVczRNekkwTnpVeE5nPT0iLAoJCQkJImRpc3BsYXlfcW1VU1p4TkpMQ0lqeWQwdTFJRDk0RmxVZ0pnNE16STBOelV4Tnc9PSIsCgkJCQkiZGlzcGxheV9oeHlFZktCUnRrNWlxMThMQzE1SDJHcEN3QjgxTVRFeU9UYzVNQT09IiwKCQkJCSJkaXNwbGF5X1NkcjFEcU5aUEFtcGh0Q1FIUndoYUxFT1B0RXhNamsxT1RJNE5BPT0iLAoJCQkJImRpc3BsYXlfeVlSai1qV2Ntc2ozNzhrel9PMm0yOVlwTjhJeE5EazNPRE00TXc9PSIsCgkJCQkiZGlzcGxheV9Xbm9NZGZuLTRTVmhxcF9xQzVvLWxoT0paNm8xTkRJeE1UUTROdz09IgoJCQldLAoJCQkiVFRMIjogMTYyODk4NTYwMAoJCX0="
}
```

{% hint style="info" %}
이 섹션의 문자열에 대해 잘 모르겠다면 다음을 방문하세요. [Reference](/retail-media-interface/integration/ko/references/banner-ad-static-reference.md) 페이지.
{% endhint %}

### 서드파티 추적 태그

배너 광고의 경우, Epsilon Retail Media 는 리테일러에게 서드파티 추적 태그를 전달하는 기능을 지원합니다. 이러한 태그는 신뢰할 수 있는 서드파티를 통해 성과를 검증하기 위해 광고주가 사용합니다.

다음 추적 태그가 지원됩니다.

* DoubleVerify
* DCM Click
* DCM Impression
* IAS

캠페인에 추적 태그가 구성되어 있는 경우 아래 `tags` 객체에 관련 필드로 나타납니다. 캠페인에 태그가 구성되어 있지 않으면 `tags` 객체는 빈 상태로 유지됩니다.

```json
{
    "ads": [],
    "banners": [
				{
            "id": "banner_XeemTeq59HapGSp4vccOYfBq_yvc3zMzNjM2",
            "contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9",
            "slotId": "<SLOT_ID>",
            "imageUrl": "https://cdn.flavedo.io/s/-oW-C3cEViSSO2krWkwOBUXOhvUdhHOySx-YQLGZ1lA=",
            "linkUrl": "https://www.retailer.com/link",
            "altText": "Your local ice cream",
            "text": "",
            "gtins": [
                "7733628",
                "7714107",
                "7163379",
                "7733636",
                "7733657"
            ],
            "expiry": "2021-05-17T01:49:17.75503253Z",
            "tags": {
                "dv": "<script src=\"https://cdn.doubleverify.com/dvtp_src.js?ctx=919421&cmp=1074060503&sid=1073907024&plc=1075810393&adsrv=115&btreg=&btadsrv=&crt=&tagtype=&dvtagver=6.1.src\" type=\"text/javascript\"></script>",
                "dcmClick": "<script ..../>",
                "dcmImpression": "<script.... />",
                "ias": "<script.... />"            }
        }
				],
    "products": [],
     "memoryToken":"85ykKVv-luDHMWLZx2d6xcPq6sF7CgkJCSJDb3VudGVyIjogIjIiLAoJCQkiQWRzIjogWwoJCQkJImRpc3BsYXlfV05VV0NwQkRKMUpKNm5wdVZSVExvOU40TUxzNE1UWTBOemt5TWc9PSIsCgkJCQkiZGlzcGxheV9MME5NUHRxNmdCcVFvREJOd3J0dE9UTGJoWk0xTVRFeU9UYzRPUT09IiwKCQkJCSJkaXNwbGF5XzlCcEpmdUpaWk9VXzgyaWpFM3VCczgxd3VVczRNekkwTnpVeE5nPT0iLAoJCQkJImRpc3BsYXlfcW1VU1p4TkpMQ0lqeWQwdTFJRDk0RmxVZ0pnNE16STBOelV4Tnc9PSIsCgkJCQkiZGlzcGxheV9oeHlFZktCUnRrNWlxMThMQzE1SDJHcEN3QjgxTVRFeU9UYzVNQT09IiwKCQkJCSJkaXNwbGF5X1NkcjFEcU5aUEFtcGh0Q1FIUndoYUxFT1B0RXhNamsxT1RJNE5BPT0iLAoJCQkJImRpc3BsYXlfeVlSai1qV2Ntc2ozNzhrel9PMm0yOVlwTjhJeE5EazNPRE00TXc9PSIsCgkJCQkiZGlzcGxheV9Xbm9NZGZuLTRTVmhxcF9xQzVvLWxoT0paNm8xTkRJeE1UUTROdz09IgoJCQldLAoJCQkiVFRMIjogMTYyODk4NTYwMAoJCX0="
}
```

As Epsilon Retail Media 는 서버 간(server-to-server) 연동이므로 서드파티 추적 태그를 사용하려면 리테일러의 추가 개발이 필요합니다. 이 기능을 활용하려면 담당 기술 계정 매니저(Technical Account Manager)에게 문의하세요.

## 디지털 서비스 법

Epsilon Retail Media 은 리테일러가 유럽 연합(EU) [디지털 서비스 법](https://commission.europa.eu/strategy-and-policy/priorities-2019-2024/europe-fit-digital-age/digital-services-act_en) (DSA) 의무를 준수할 수 있도록 지원합니다. DSA는 온라인 콘텐츠 규제, 투명한 광고 및 허위 정보 차단을 목표로 EU 전역에 통일된 규칙 세트를 설정합니다. 자세한 내용은 다음을 참조하세요. [디지털 서비스 법](/retail-media-interface/integration/ko/feature-integrations/digital-services-act.md).

### 광고 요청 예시

```
{
    "catalogId": "fbf0aee8-0916-4dad-9988-101a76dc35cc",
    "maxNumberOfAds": 0,
    "customerId": "tempore8742",
    "placement": "broad-display-187f4189-041a-4940-8613-e6e27db317c7",
    "contentStandardId": "339fd058-29ce-401e-a131-46eb769de8f9",
    "bannerSlotIds": [
        "Search"
    ],
    "options": {
        "includeAdvertiserInfo": true
    }
}
```

### 예시 광고 응답

```
{
  "ads": [],
  "banners": [
    {
      "id": "banner_edUhN_ja2MzgMbOvPC_Zl1qSStwKEgoQUGFwYXlhMTAtbnJkZHAxMhIAGgwI_POvvQYQqqmyhQEiAggB",
      "contentStandardId": "339fd058-29ce-401e-a131-46eb769de8f9",
      "slotId": "Search",
      "imageUrl": "https://dev3.flavedo.io./citrus/RUn6QEY0a4Si2Enu29ZgldByi1EAyGEMygRdNWSC0VU=",
      "linkUrl": "http://citrusad.com/",
      "altText": "search banner",
      "text": "",
      "gtins": [
        "Papaya10-nrddp12",
        "Mangosteens17-gridu18",
        "Mulberries23-jxvbv24",
        "Butternut_pumpkin2-cflci4",
        "Custard_Apples_Daikon29-gujlg30"
      ],
      "sellerId": "",
      "expiry": "2025-02-12T01:31:40.279745706Z",
      "tags": {},
      "position": 1,
      "metadata": {
        "advertiserInfo": {
          "advertiser": "Bob's advertising agency",
          "onBehalfOf": "Brand company inc"
        }
      }
    }
  ],
  "products": [],
  "memoryToken": "SSIhP6dA/mu+6uMOg18+1z6QgO0KDhIMCMDzr70GEL7IooMBGgIIAiIA"
}
```


---

# 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-ads-static/requesting-banner-ads.md?ask=<question>&goal=<endgoal>
```

`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.