> 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/partner/ja/campaign-management-api/bannerxcampaign-1.md).

# バナー X キャンペーン

Banner X は、小売業者のウェブサイトにシームレスに統合されることでオンラインショッピング体験を向上させる、応答性の高いマルチコンポーネントのバナー広告を提供します。 Epsilon Retail Media がコンポーネントを提供し、小売業者のフロントエンドがスタイリングを管理してサイトのECデザインとの整合性を確保します。このアプローチにより、ブランドの整合性を維持しながら顧客を効果的に引きつけることができます。

<figure><img src="/files/Nit6VLiURLO7hXqvUHk4" alt="" width="100%"><figcaption></figcaption></figure>

## 主なメリット

* **ネイティブ統合**: 広告は商品カルーセル内に自然に収まり、サイトのスタイルを維持します。
* **パーソナライゼーション**: ユーザーの関心に合わせてリアルタイムでカスタマイズされた広告を配信します。
* **エンゲージメントの向上**: 魅力的なCTAにより、商品の視認性を向上させ、顧客のエンゲージメントを高め、売上を増大させます。

## Banner X コンポーネント

デザインが小売業者の基準に準拠するように、バナー Xのコンポーネントを理解してください。各コンポーネントは、視覚的な一貫性と機能を維持するために不可欠です。

### プライマリ背景画像

プライマリ背景は、デバイス間でのデザインの明確さと一貫性を確保するシンプルな背景です。特にさまざまなデバイスやブラウザ幅でのトリミングの問題を防ぐため、商品画像を埋め込んだり、コンテンツを圧倒したりしないようにしてください。利用可能な6つのプライマリ背景構成は次のとおりです。

* 繰り返し
* 塗りつぶし
* 上揃え
* 下揃え
* 右揃え
* 左揃え

<figure><img src="/files/Z2IYxBq9cxVi3eUALgbD" alt="" width="100%"><figcaption></figcaption></figure>

### セカンダリ背景画像

バナーの装飾を追加するには、セカンダリ背景画像を使用します。利用可能な6つのセカンダリバナー構成は次のとおりです。

* 繰り返し
* 塗りつぶし
* 上揃え
* 下揃え
* 右揃え
* 左揃え

### バナーテキスト

バナーテキストはバナー広告に表示されるテキストであり、太字用の `strong` や斜体用の `i` などの限定的なHTMLタグをサポートしています。テキストの色をカスタマイズすることもできます。例えば、

<figure><img src="/files/dyZo6RDoTLa5UfNvuCIJ" alt="" width="100%"><figcaption></figcaption></figure>

### ヒーロー画像

ヒーロー画像は、通常、商品やロゴを表示するために使用されるメインのプロモーション画像です。ヒーロー画像で利用可能な2つの構成は次のとおりです。

* 横長
* 縦長

<figure><img src="/files/wgsrVe4WBXlCpuw8eKk4" alt="" width="100%"><figcaption></figcaption></figure>

### セカンダリヒーロー画像

商品やロゴを表示するには、セカンダリヒーロー画像を使用します。利用可能な2つの構成は次のとおりです。

* 横長
* 正方形（幅と高さが同じ画像）

<figure><img src="/files/t6g7nOEnQjIDKHMxTC3Z" alt="" width="100%"><figcaption></figcaption></figure>

### コールトゥアクション（CTA）

コールトゥアクション（CTA）は、購入や別のページへの移動など、ユーザーに行動を促すクリック可能なテキストまたはボタンです。エンゲージメントを高めるために、CTAは明確でアクション指向であり、視覚的に目立つ必要があります。例えば、「今すぐ購入」は購入を促進します。

<figure><img src="/files/xBiF2lFkvcxzLBwx8dIO" alt="" width="100%"><figcaption></figcaption></figure>

## 広告配置タイプ

Banner X は、小売ウェブサイトでのさまざまな戦略的 [広告枠](https://developers.citrusad.com/integration/docs/introduction-to-placement-types) をサポートしています。これには以下が含まれます。

* **検索**: 顧客がキャンペーンで設定された検索語（チョコレートなど）を入力したときに広告を表示します。詳細については、以下を参照してください： [検索の配置](https://developers.citrusad.com/integration/docs/introduction-to-placement-types#search).
* **カテゴリー**: 商品に関連するカテゴリーページに広告を表示します。次のような関連する分類情報を指定して、特定のカテゴリーをターゲティングします： `Category:Cupboard/Snacks`。詳細については、以下を参照してください： [カテゴリの配置](https://developers.citrusad.com/integration/docs/introduction-to-placement-types#category).
* **カテゴリーと検索**: 顧客が商品に関連するカテゴリーページを訪問したとき、またはキャンペーンで設定された検索語を使用したときに広告を表示します。
* **カテゴリークロスセル**: カテゴリークロスセル配置により、広告主は商品のデフォルトカテゴリーに加えて、補完的なカテゴリーをターゲティングできます。このアプローチにより、関連カテゴリー内の商品の視認性が向上します（例: 小売業者サイトの乳製品セクションでコーヒー商品を紹介するなど）。詳細については、以下を参照してください： [クロスセル枠](https://help.citrusad.com/retail-media-interface/integration/ja/feature-integrations/category-cross-sell/difference-between-category-and-category-cross-sell-placements).
* **ブロードマッチ**: 特定のカテゴリーや検索語にリンクされていない、トラフィックの多いページに広告を表示します。ホームページやチェックアウトページなどの一般的な場所に最適です。詳細については、以下を参照してください： [部分一致の配置](https://help.citrusad.com/retail-media-interface/integration/ja/generating-ads/banner-x-responsive/requesting-banner-x-ads#broad-match-placements).

## サポートされている広告枠フォーマット

Banner X は次のフォーマットで展開できます。

* シングルタイル
* ダブルタイル
* フルバナー

<figure><img src="/files/Wox7zxs8gcyW256aPhtg" alt="" width="100%"><figcaption></figcaption></figure>

## バナー X広告を実装する

バナー X広告を設定するには、次の手順に従います。

### ステップ 1: 小売業者のコンテンツ基準を確認する

コンテンツ基準は、ウェブサイトやデジタルプラットフォーム上の指定されたスペース内に Banner X 広告を表示する方法を規定するガイドラインおよび技術パラメータです。これらの基準には以下が含まれる場合があります。

* **寸法とサイズ**: バナーの正確な幅と高さに関する仕様。
* **ファイルフォーマット**: JPEG、JPG、PNG、SVG、GIFなどの受け入れ可能な画像または動画ファイルフォーマット。
* **ファイルサイズ制限**: ウェブページでの迅速な読み込み時間と最適なパフォーマンスを確保するための最大の許容ファイルサイズ。
* **解像度と品質**: バナーが鮮明でプロフェッショナルに見えるようにするための最小解像度要件。
* **配置と配置方向**: 利用可能なスペース内でバナーをどのように配置するかに関するガイドライン。
* **コンテンツ制限**: バナー内に含めることができる、または含めることができないコンテンツに関するルール（不快なコンテンツの禁止、必須の法的免責事項の記載など）。
* **インタラクティビティ**: 該当する場合、クリック可能な領域、アニメーション、ユーザー主導のイベントなどのインタラクティブ要素の仕様。

キャンペーンを開始する前に、小売業者のコンテンツ基準ガイドラインを確認してください。これらのガイドラインには、サンプルのURL、ページ内の配置、および特定のグラフィックコンテンツの制限が含まれています。利用可能なバナー Xスロットとその仕様の詳細については、カスタマーインテグレーションエンジニア（CIE）にお問い合わせください。例を以下に示します。

<figure><img src="/files/gKAUqAvsNZ9zMamdmJXm" alt="" width="100%"><figcaption></figcaption></figure>

### ステップ 2: クリエイティブアセットを準備する

小売業者のコンテンツ基準に従ってクリエイティブアセットを作成します。これには、プライマリ背景、セカンダリ背景、ヒーロー画像、セカンダリヒーロー画像などの要素が含まれます。 [Banner Xのコンテンツ標準の詳細を取得する](/retail-media-interface/partner/ja/campaign-management-api/bannerxcontentstandard/getbannerxcontentstandard-1.md) APIを使用してコンテンツ基準の詳細を取得します。

### ステップ 3: 広告枠フォーマットを特定する

展開する広告枠フォーマット（フルバナー、シングルタイル、またはダブルタイル）を決定します。

### ステップ 4: クリエイティブアセットをアップロードする

クリエイティブアセットを作成し、広告枠フォーマットを特定したら、 [クリエイティブアセットをアップロードする](/retail-media-interface/partner/ja/team-user-api/user-1/uploadfile-1.md) APIを使用してこれらをアップロードします。APIは、アップロードされた画像のファイルIDとURLを返します。

* **ファイルID**: ファイルIDは、バナー Xキャンペーンを作成する際に必要です。プライマリ背景、セカンダリ背景、ヒーロー画像、セカンダリヒーロー画像など、アセットタイプごとに特定のファイルIDを提供する必要があります。
* **URL**: URLは主に、アップロードされた画像をプレビューするために使用されます。

### (任意) ステップ 5: 画像の公開 URL を取得する

次を使用します: [ファイルURL取得API](/retail-media-interface/partner/ja/campaign-management-api/creativeassets/getcampaignfileurl.md) を使用して画像の公開URLを取得します。このURLを使用して、ステークホルダーと画像を検証したり共有したりできます。

### ステップ 6: バナー X キャンペーンを作成する

次を使用してバナー X キャンペーンを作成します: [Banner Xキャンペーンを作成する](/retail-media-interface/partner/ja/campaign-management-api/bannerxcampaign-1/createbannerxcampaign-1.md) APIを使用してバナー Xキャンペーンを作成します。以下を用意しているか確認してください： `backgroundImageId`, `secondaryBackgroundImageId`, `heroImageId`、および `secondaryHeroImageId`これは以下から返されるファイルIDです： [クリエイティブアセットをアップロードする](/retail-media-interface/partner/ja/team-user-api/user-1/uploadfile-1.md) API。


---

# 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/partner/ja/campaign-management-api/bannerxcampaign-1.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.