> 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/references/banner-ad-static-reference.md).
# バナー広告（静的）のリファレンス
以下は、次で定義されている標準リクエストで可能なプロパティの概要です [バナー広告をリクエストする](/retail-media-interface/integration/ja/generating-ads/banner-ads-static/requesting-banner-ads.md) リクエストに対するレスポンス（広告を受信した場合）。
{% hint style="info" %}
バナー広告はプロダクト広告と同じ `/generate` エンドポイントでリクエストされます。1回のリクエストで両方の広告タイプを取得できます。
{% endhint %}
## リクエストされた項目
| 文字列 | 説明 | 必須/オプショナル |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `bannerSlots` | バナー広告の受信を希望するバナー枠の配列。バナー枠に maxNumberOfAds を指定することで、その枠に対して複数のバナーを取得できます。このようなユースケースとしてはカルーセル配置などが挙げられます。 | 必須 |
| `bannerSlotIds` | バナー広告の受信を希望するバナー枠の配列 | 必須（bannerSlots により差し替え） |
| `catalogId` | ウェブサイトのプロダクトカタログ識別子。 | 必須 |
| `contentStandardId` | ウェブサイトのコンテンツ標準識別子。 | 必須 |
| `customerId` | 広告が配信される顧客の一意の識別子。 | オプショナル |
| `filterMode` | リクエストの構造を定義するオプショナルな方法。詳細については次を参照してください [広告生成フィルタリング](/retail-media-interface/integration/ja/data-api/api-overview/ad-generation-filtering-1.md) 詳細については、こちらを参照してください。 | オプショナル（推奨） |
| `maxNumberOfAds` | 返されるプロダクト広告の最大数量（最大 15）。 | 必須。同じリクエストでプロダクト広告を配信できるようにします。プロダクト広告が不要な場合は、以下に設定します `0` |
| `options` | リクエストの構造を定義するオプショナルな方法。詳細については次を参照してください 広告生成フィルタリング 詳細については、こちらを参照してください。
これは、ヨーロッパの次のような現地の広告関連法規制に準拠するために、広告主情報をリクエストできるオブジェクトでもあります デジタルサービス法 .
| オプショナル（推奨） |
| `placement` | 広告をリクエストする一意の配置（プレイスメント）。 | 必須 |
| `productFilters` | カテゴリ、場所、サイズなど、リクエストに関連するプロダクトフィルター。 | 必須 |
| `sessionId` | 顧客セッションの一意の識別子。標準的な連携でのアトリビューションに使用されます。詳細については「Integration workflow options」をご確認ください。 | 標準統合で必須 |
| `dtmCookieId` | 同一ドメイン上でユーザーの行動を追跡するために使用され、ウェブサイトによって作成および保存されるクッキー。 | オプショナル |
| `audience` | ショッパーが所属する特定のオーディエンスセグメントを指定します。使用している場合のみ関連します [オーディエンスターゲティングオプション 3](/retail-media-interface/integration/ja/data-api/audience-targeting-new/integration-option-3-sync-audiences-only.md) | オプショナル |
## 返品されたアイテム
| 文字列 | 説明 | 値の例 |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `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` | このフィールドは、広告主がキャンペーンに入力したサードパーティタグを返します。 | `{
"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/ja/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.