> 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/product-ad-reference-1.md).
# 商品広告のリファレンス
以下は、標準的なリクエストで可能なプロパティと、広告を受信した場合のレスポンスの概要です。
## リクエストされたアイテム
| String | 説明 | 必須/任意 |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- |
| `catalogId` | Webサイトの商品カタログ識別子。 | 必須 |
| `customerId` | 広告が配信される顧客の一意の識別子。 | 任意 |
| `filterMode` | リクエストの構造を定義するオプションの方法。詳細については「広告生成のフィルタリング」を参照してください。 | 任意、推奨 |
| `maxNumberOfAds` | 返される広告の最大数（最大10個）。 | 必須 |
| `options` | リクエストの構造を定義するオプションの方法。詳細については「広告生成のフィルタリング」を参照してください。
これは、ヨーロッパの法律などの地域の広告法を遵守するために広告主情報をリクエストできるオブジェクトでもあります。 デジタルサービス法.
| 任意、推奨 |
| `placement` | 広告をリクエストする一意の配置。 | 必須 |
| `productFilters` | カテゴリ、場所、サイズなど、リクエストに関連する商品フィルター。 | 必須 |
| `sessionId` | 顧客セッションの一意の識別子。標準的な統合でのアトリビューションに使用されます。詳細については「統合ワークフローのオプション」を確認してください。 | 標準的な統合では必須 |
| `memoryToken` | ページネーションに使用されます。以前の広告リクエストで提供されたトークンを使用して、 Epsilon Retail Media が新しい広告のみを顧客に配信するようにします。
指定された場合、 Epsilon Retail Media は以前に配信された広告を広告レスポンスから除外します。詳細については ページネーション を参照してください。
| 任意 |
| `dtmCookieId` | ウェブサイトによって作成および保存され、同一ドメイン上でのユーザー行動の追跡に使用されるクッキー。 | 任意 |
| `audience` | ショッパーが所属する特定のオーディエンスセグメントを指定します。使用している場合のみ関連します [オーディエンスターゲティングオプション 3](/retail-media-interface/integration/ja/data-api/audience-targeting-new/integration-option-3-sync-audiences-only.md) | 任意 |
## 返品されたアイテム
| String | 説明 | 値の例 |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `ads.customPayload` | カタログファイルから広告生成に引き継ぐ必要がある、このカスタムペイロード。
このフィールドには、バイト配列にシリアル化されBase64エンコードされた有効なJSONオブジェクトを含める必要があります。JSONオブジェクトはスキーマに従う必要があります。
| 統合ごとのカスタム |
| `ads.sellerId` | セラーの一意のID。チームに sellerId が設定されている場合にのみ設定されます。sellerIds は通常、マーケットプレイスセラーのオンボーディング時に使用されます。 | `73nns-32sxr-32ss` 統合ごとのカスタム |
| `ads.id` | 広告の一意のID。
これは、次へのリクエストごとに一意であり、 Epsilon Retail Media キャッシュすることはできません。
| `display_yCaCIy_kKaJnRnzrenBkVSytwr8yNTgxMzM4` |
| `ads.gtin` | 広告の要素コード。これは商品カタログ内で同期された要素コードになります。 | `25813383` |
| `ads.discount` | 非推奨。無視できます。 | `{
"amount": 0,
"minPrice": 0,
"maxPerCustomer": 0
}` |
| `ads.position` | 応答内での広告の位置。 Epsilon Retail Media 固定掲載キャンペーンが利用されている場合は、この位置を尊重する必要があります。 | 1 |
| `ads.memoryToken` | ページネーションおよび広告リクエストのチェーン接続に使用されます。
同じコンテキストに対する次の広告リクエストで提供された場合、 Epsilon Retail Media は以前に配信された広告を広告レスポンスから除外します。詳細については ページネーション を参照してください。
| |
| `ads.metadata` | 広告主がヨーロッパにおける デジタルサービス法などの地域の広告法規制を遵守するのに役立つ、必要な広告主情報を含むオブジェクト。
advertiser サプライチームの会社名から引き継がれます。
onBehalfOf サプライチームの広告融資者から引き継がれます。
| `"metadata": {
"advertiserInfo": {
"advertiser": "Bob's advertising agency",
"onBehalfOf": "Brand company inc"
}
...` |
| `banners` | バナーオブジェクトで構成されます。以下を参照してください： [バナー広告 (静止画) リファレンス](/retail-media-interface/integration/ja/references/banner-ad-static-reference.md) を参照してください。 | `"banners": [],` |
| `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/product-ad-reference-1.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.