> 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/data-api/catalog-products-2.md).

# カタログと商品

統合するには、 Epsilon Retail Media最低でも1つの商品カタログが必要です。

## カタログとは何ですか？

カタログとは、商品とその属性のグループであり、最も一般的にはインテグレーターのサイトのすべての商品を1つのカタログにまとめるために使用されます。

カタログはキャンペーン作成プロセスで広告主によって選択され、広告主のキャンペーンは選択された商品カタログ内でのみ配信されます。インテグレーターのすべての商品を1つのカタログにグループ化して、広告主が選択しやすくするのが一般的です。

複数のカタログを作成すると、キャンペーンのターゲティング目的で、さまざまな小売業者や国での商品の可用性をセグメント化できます。

{% hint style="info" %}
複数のカタログを作成したい場合は、ターゲティングを実装するためのより適した方法がある可能性があるため、テクニカルアカウントマネージャーに問い合わせてベストプラクティスについてご相談ください。
{% endhint %}

{% hint style="warning" %}
ネットワーク名前空間に統合する場合は、単一のカタログを作成する必要があります。
{% endhint %}

## 商品とは何ですか？

商品とは、インテグレーターのサイト上の個々のGTINです。同期された商品は、 Epsilon Retail Media 個々の識別値および属性と同期されます。商品は、現在の商品カタログ内の各GTIN/SKUを表す必要があります。

商品はキャンペーン作成時に広告主によって選択され、広告主が選択したカタログに関連する商品のみが選択用に表示されます。商品は単一の商品GTINを超えて表すために使用されるべきではありません。同じ商品のバリエーションは異なる商品としてリストされる必要があります。例えば、同じ飲料商品の200ml、600ml、2Lのバリエーションは、既存のインテグレーターのベストプラクティスに合わせて、 Epsilon Retail Mediaでは3つの異なる商品と見なされます。

## 商品フィルターについての説明

商品フィルターは主に、広告の生成に使用されるほか、 `imageUrl` や名前などのプロパティを含めるためにも使用されます。広告をリクエストする際、 Epsilon Retail Mediaでは、関連するページ情報を含むコンテキストを送信します。これにより、各ページに適切な広告が配信されるようになります。

フィルターの構造はインテグレーターに委ねられていますが、最も重要な考慮事項は、これらの商品フィルターが広告生成コンテキスト内で送信されることです。商品フィルターは、広告生成でリクエストされているものと正確に一致する必要があります。

以下は、次を含むコンテキストの例です： `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",
    "placement": "search",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "searchTerm": "chocolate",
    "productFilters": [
         ["category:Cupboard"],["dietary:Gluten-free"]
    ],
    "options": {
                             "filterMode": "AndOr"
                             },
    "maxNumberOfAds": 3
}
```

このコンテキストは、関連する配列内のすべてのフィルターを含む商品に関する広告のみを返します。

{% hint style="info" %}
カテゴリーの最低入札価格を活用したい場合は、キャンペーンを作成する広告主にとって分かりやすく理解しやすいカテゴリーにしてください（例：「category:12」よりも「category:Keyboards」の方が理解しやすいです）。
{% endhint %}

## 画像および商品名の提供

Epsilon Retail Media は、 Epsilon Retail Media ポータルでキャンペーンを作成する際に検索可能にするため、商品画像と名称に関する情報を必要としています。これらの値は、以下の例のようにフォーマットされたタグ内で Epsilon Retail Media に送信できます：

```http
POST $BASE_URL/v1/catalog-products?teamId=<YOUR_TEAM_ID> HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "catalogProducts": [
        {
            "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
            "gtin": "23556578965543",
            "inventory": 50,
            "price": "19.99",
            "tags": [
                 ""imageurl:https://your.image.host.com/image.jpg","name:Covergirl Clean 120 Creamy Natural Liquid Foundation30mL"
            ],
            "filters": [
                 "category:Health&Beauty","category:Grocery","Brand:Covergirl","Special_Flag:0"
            ]
        }
    ]
}
```

これらは、以下の例のような商品選択画面を含む、 Epsilon Retail Media ポータルのさまざまな領域に表示されます：

<figure><img src="/files/whcfgx5MWdm2Au0helQD" alt="Screen Shot 2021-05-24 at 12.12.31 pm.png" width="100%"><figcaption><p>参考画像</p></figcaption></figure>


---

# 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/data-api/catalog-products-2.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.