> 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/feature-integrations/category-cross-sell/integration-requirements.md).

# 連携要件

## ハイレベルの概要

この統合の一環として、以下を行う必要があります

1. クロスセルカテゴリー枠の広告リクエストを実装します。
   1. これには、サイト上での広告の配置およびレンダリングの作業と、クリックおよびインプレッションのレポートが含まれます
   2. 注文情報は以下に提供する必要があります： Epsilon Retail Media 標準的な統合の一環として
2. カテゴリーIDを以下と同期している場合： Epsilon Retail Media, UIでのカテゴリー選択用に人間が読み取れる値を提供するために以下を使用する必要があります： [filterMapping](/retail-media-interface/integration/ja/citrus-filter-mapping-api/filtermapping.md) API
   1. これは、名前ではなくカテゴリーIDと統合している場合にのみ適用されます。（広告をリクエストする際、フィルターが以下のようになっている場合など： `category:123j-dsef-er` ではなく `category:Milk`
3. （推奨） - 承認を自動化し、キャンペーン管理の負荷を軽減するために、カテゴリーのクロスセルマッピングを同期します。

## 広告リクエストとサイトの統合

### 広告リクエスト

カテゴリークロスセルには独立した枠が必要となるため、カテゴリークロスセルを統合する広告タイプごとに広告リクエストを追加で統合する必要があります。

リクエストの形式は、以下に記載されているクロスセルカテゴリーの広告リクエストと一致する必要があります

* [商品広告 - カテゴリークロスセル広告のリクエスト](/retail-media-interface/integration/ja/generating-ads/product-ads/requesting-product-ads-1.md#cross-sell-category-placements)
* [バナー広告 - カテゴリークロスセル広告のリクエスト](/retail-media-interface/integration/ja/generating-ads/banner-ads-static/requesting-banner-ads.md#cross-sell-category-placements)
* Banner X - カテゴリークロスセル広告のリクエスト

### インプレッションとクリックのレポート

広告リクエストを統合したら、表示された広告ごとにクリックとインプレッションを正しくレポートしていることも確認する必要があります。以下を必ずお読みください [インプレッションとクリックのレポート](/retail-media-interface/integration/ja/data-api/api-overview/reporting-impressions-clicks.md).

### 注文のレポート

通常、ほとんどの統合では、すべての注文情報を以下にレポートします： Epsilon Retail Media （標準的な統合に従って）。すべての注文を正確に以下にレポートしていることを確認する必要があります： Epsilon Retail Media に従って [注文データ](/retail-media-interface/integration/ja/data-api/order-data-1.md).

## フィルターマッピング

フィルターマッピングエンドポイントを使用すると、カテゴリーIDを人間が読み取れる値にマッピングできます。UIにはユーザーに対してその値が表示されるため、カテゴリーIDを同期する場合はこれが必要になります。

{% hint style="info" %}
商品カタログ内の人間が読み取れるカテゴリーを以下と同期している場合： Epsilon Retail Media, このステップは不要です。
{% endhint %}

ユーザーは以下が何であるかを理解できません： `category:12345-abcde` 。filterMapping APIを使用すると、その値をサイト上の関連するカテゴリー名（以下など）にマッピングできます： `category:Pantry`。

この情報を同期するためのファイルベースの方法はありません。以下を介して行う必要があります： [filterMapping](/retail-media-interface/integration/ja/citrus-filter-mapping-api/filtermapping.md) API。

{% hint style="warning" %}
サイトで追加のカテゴリーを作成した場合は、filterMapping APIを使用してカテゴリーを更新する必要があります。
{% endhint %}

## カテゴリークロスセルマッピング（推奨）

このタイプの枠を統合する際は、どのカテゴリーが互いにターゲティング可能かのマッピングを提供することを強くお勧めします。これにより、最初の統合作業後の運用を効率化できます。広告主の操作体験が効率化され、すでに許可されているカテゴリーのみを選択できるようになります。

さらに、クロスセルマッピングが提供されている場合は、クロスセルカテゴリーキャンペーンの自動承認を設定することも可能です。

### 統合方法

* 以下を使用できます： [crossSellCategory](/retail-media-interface/integration/ja/crosssellcategory-api/crosssellcategory.md) 必要に応じてマッピングを作成および管理するための API。
* または、主催する GCS バケットに、以下の形式で TSV ファイルを提供することもできます Epsilon Retail Media 形式は以下のとおりです。

#### API 連携

必要な情報はすべて、次の場所で確認できます [crossSellCategory](/retail-media-interface/integration/ja/crosssellcategory-api/crosssellcategory.md) API リファレンス。

#### ファイル連携

ファイルで連携する場合、 Epsilon Retail Media カタログごとにファイルが必要です。このファイルでは、カテゴリ同士で相互にターゲット設定できるカテゴリを指定します。

ファイル内の各行は、カテゴリと、そのカテゴリがターゲットにできるカテゴリの単一のマッピングを表します。各マッピングは一方向です（チョコ -> 牛乳 を同期した場合、チョコレート製品は牛乳カテゴリに表示されます。牛乳製品をチョコレートに表示できるようにするには、行を追加する必要があります）。

以下の仕様に準拠した TSV 形式のデータフィードが必要です。

| 列名                  | 必須 | データ型 | 説明                                                     | 例                  |
| ------------------- | -- | ---- | ------------------------------------------------------ | ------------------ |
| `category`          | 必須 | テキスト | これは、掲載広告商品のカテゴリを識別する一意のカテゴリ ID です。                     | `category:cookies` |
| `cross_category_id` | 必須 | テキスト | これは、category\_id の商品をクロスセルできる対象カテゴリを識別する一意のカテゴリ ID です。 | `category:milk`    |

その他のファイルの仕様は以下のとおりです。

* TSV ファイルのみがサポートされています
* TSV は CRLF ではなく LF にする必要があります
* TSV は UTF-8 エンコードにする必要があります。その他のタイプではフィードが失敗します
* 必要な命名規則: `^cross_sell_category.*.tsv$`

スニペットの例は以下のとおりです。

| カテゴリ      | クロスカテゴリ ID  |
| --------- | ----------- |
| カテゴリ:クッキー | カテゴリ:牛乳     |
| カテゴリ:クッキー | カテゴリ:チョコレート |
| カテゴリ:牛乳   | カテゴリ:クッキー   |

上のスニペットでは、**クッキー** カテゴリを **牛乳** および **チョコレート** カテゴリにクロスセルできます。**牛乳** カテゴリは **クッキー** カテゴリにクロスセルできます。**チョコレート** カテゴリはターゲットに指定できますが、他のカテゴリをターゲットにすることはできません。

{% hint style="danger" %}
️ 各行は一意のマッピングの組み合わせです

一意のクロスセルカテゴリマッピングごとに、一意の行を同期する必要があります。1 つの行で複数の cross\_category\_id を同期しようとすると、ファイル取込が失敗します。
{% endhint %}

{% hint style="warning" %}
列の順序

ファイルには必ず最初の列として `category` 列があることを確認してください。同期する場合 `cross_category_id` が最初の列として存在しない場合、取り込みは失敗します。
{% endhint %}

## 機能の有効化プロセス

推奨検索語フィードの同期を開始する準備ができたら、 Epsilon Retail Media ファイルを取り込むための GCS バケットを構成します。

この機能は GCS バケットでのみサポートされています。AWS/Azure/その他などの外部バケットはサポートされていません。

テクニカルアカウントマネージャーが、この機能の有効化手順をご案内します。 Epsilon Retail Mediaのプラットフォーム運用チームによる構成対応が必要となるため、有効化までに別途お時間をいただくことをあらかじめご了承ください。


---

# 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/feature-integrations/category-cross-sell/integration-requirements.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.