> 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/marketplace-sellerid.md).
# マーケットプレイスのsellerId
## マーケットプレイスとは？
マーケットプレイスは、小売業者がオンラインでの存在感を拡大し、新規顧客やカジュアルバイヤーを簡単に惹きつけるための独自の機会です。マーケットプレイスにより、小規模な事業者でも多様な顧客にアプローチできるようになります。通常、商品はマーケットプレイスセラーから顧客へ直接配送されます。
マーケットプレイスを利用することで、セラーは小売業者のサイト上で自社商品を販売できるようになり、より幅広い層に対して商品の視認性を向上させることができます。一方で小売業者は、より多様な顧客に販売するための商品ラインナップを追加で獲得できます。
マーケットプレイス機能によってサイトを収益化することに加え、小売業者はこのプレミアムなオンライン棚スペースを活用し、マーケットプレイスベンダーに対して以下を通じて上位枠への入札機会を提供することもできます。 Epsilon Retail Media 以下のドキュメントを参照してください。
## マーケットプレイス広告主の設定
統合の拡張（詳細は後述）が完了すると、チームごとに Seller ID を設定できるようになります。これは、リテーラーチームからチームを作成する場合にのみ実行可能で、チームの編集時やサプライヤーによって実行することはできません。
新しいチームを作成する際に、Seller ID を選択できる「任意フィールド」セクションがあります。選択可能な Seller ID は、商品カタログから直接取得されます。商品カタログに存在しない値を入力することはできません。
## 統合要件
### ハイレベルな概要
との標準的な統合に加え Epsilon Retail Media統合を以下の変更で拡張する必要があります。
* 商品カタログファイルまたは API 内のユニーク商品ごとに sellerId を実装する
* 広告レスポンスを解析し、該当する場合は正しいセラーのオファーをレンダリングする
* 注文を報告する際、ユニーク商品ごとに sellerId を報告する Epsilon Retail Media
{% hint style="warning" %}
現在、 Epsilon Retail Mediaの機能は、商品のセラーに seller ID がなく、かつ商品の seller ID バリアントも存在するというユースケースに完全には対応していません。これに対する確認済みの回避策は、非マーケットプレイス商品にリテーラーの seller ID を同期し、マーケットプレイスセラーではない各サプライヤーにこの seller ID を追加することです。詳細については、テクニカルアカウントマネージャーにお問い合わせください。
{% endhint %}
### 商品カタログの拡張。
Citrus と同期する商品カタログにおいて、ユニーク商品コードごとに sellerId を以下に提供する必要があります： Epsilon Retail Media.
#### ファイルによるカタログの同期
カタログファイルに以下の列/セクションを追加する必要があります： `seller_id`すべての `seller_id` と `product_code` の組み合わせはユニークな行である必要があります。非マーケットプレイス商品の場合、 `seller_id` は空にすることができます。
{% hint style="warning" %}
ブランドセラー（商品に sellerId がない場合）とマーケットプレイスセラー（同じ商品に sellerId バリアントがある場合）の両方を持つ商品は、現在互換性がありません。このカテゴリーに該当する商品がある場合は、現時点ではこれらの特定の商品に対してマーケットプレイスセラーのみをオンボーディングすることをお勧めします。
ECサイトがこの特定の商品のユースケースで設定されている場合は、このユースケースの互換性を検討中ですので、 Epsilon Retail Media の担当者にお問い合わせください。
{% endhint %}
例については、以下をご覧ください： [ファイル経由でのカタログおよび商品の同期](/retail-media-interface/integration/ja/data-api/catalog-products-2/syncing-catalog-products-via-file.md)
#### API によるカタログの同期
API 経由で商品を同期する場合、ユニークな `sellerId` 組み合わせごとに `sellerId` & `gtin` を同期する必要があります。
```http
POST $BASE_URL/v1/catalog-products?teamId= HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic
{
"catalogProducts": [
{
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"gtin": "23556578965543",
"sellerId": "327272-sade2-3ja",
"dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
"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"
],
"profit": "1.50"
},
{
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"gtin": "23556578965543",
"sellerId": "09sa-d32s--faasw",
"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"
],
"profit": "1.50"
},
{
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"gtin": "23556578965738",
"inventory": 26,
"price": "8.50",
"tags": [
"imageurl:https://your.image.host.com/image.jpg",
"name:Kelloggs Froot Loops Breakfast Cereal 500g"
],
"filters": [
"Brand:Kelloggs",
"category:Pantry",
"category:BreakfastFoods",
"category:Cereals",
"Special_Flag:0"
],
"profit": "0.50"
}
]
}
```
### 広告レスポンスの機能拡張
次の場合： Epsilon Retail Media が広告を配信する際、 `sellerId` に関連付けられているものがあれば、 `gtin` が配信されます。これはすべての広告タイプに適用されますが、商品広告からの広告レンダリングにのみ関連します。商品広告レスポンスの例は以下の通りです：
```json
{
"ads": [
{
"id": "display_QqHaKRrKlFm1Wxr9c_DXJN4HSE3NzMzNjM2",
"gtin": "7733636",
"discount": {
"amount": 0,
"minPrice": 0,
"maxPerCustomer": 0
},
"expiry": "2021-05-12T04:17:50.400902957Z",
"position": 1
},
{
"id": "display_NzsHqP0_iQedlo9VnrO2vqkwi_k3NzMzNjI4",
"gtin": "7733628",
"sellerId": "2834-ascre-2wcr4",
"discount": {
"amount": 0,
"minPrice": 0,
"maxPerCustomer": 0
},
"expiry": "2021-05-12T04:17:50.400908257Z",
"position": 2
}
],
"banners": [],
"products": [],
"memoryToken":"85ykKVv-luDHMWLZx2d6xcPq6sF7CgkJCSJDb3VudGVyIjogIjIiLAoJCQkiQWRzIjogWwoJCQkJImRpc3BsYXlfV05VV0NwQkRKMUpKNm5wdVZSVExvOU40TUxzNE1UWTBOemt5TWc9PSIsCgkJCQkiZGlzcGxheV9MME5NUHRxNmdCcVFvREJOd3J0dE9UTGJoWk0xTVRFeU9UYzRPUT09IiwKCQkJCSJkaXNwbGF5XzlCcEpmdUpaWk9VXzgyaWpFM3VCczgxd3VVczRNekkwTnpVeE5nPT0iLAoJCQkJImRpc3BsYXlfcW1VU1p4TkpMQ0lqeWQwdTFJRDk0RmxVZ0pnNE16STBOelV4Tnc9PSIsCgkJCQkiZGlzcGxheV9oeHlFZktCUnRrNWlxMThMQzE1SDJHcEN3QjgxTVRFeU9UYzVNQT09IiwKCQkJCSJkaXNwbGF5X1NkcjFEcU5aUEFtcGh0Q1FIUndoYUxFT1B0RXhNamsxT1RJNE5BPT0iLAoJCQkJImRpc3BsYXlfeVlSai1qV2Ntc2ozNzhrel9PMm0yOVlwTjhJeE5EazNPRE00TXc9PSIsCgkJCQkiZGlzcGxheV9Xbm9NZGZuLTRTVmhxcF9xQzVvLWxoT0paNm8xTkRJeE1UUTROdz09IgoJCQldLAoJCQkiVFRMIjogMTYyODk4NTYwMAoJCX0="
}
```
正しいセラーのオファーが表示されるようにするには、 `sellerId` から提供された Epsilon Retail Media を読み取り、正しいセラーのオファーを顧客に表示する必要があります。
### 注文レポートの拡張
注文を報告する際、 Epsilon Retail Mediaに注文を報告するときに `sellerId` 組み合わせごとに `gtin` も指定する必要があります。 Epsilon Retail Media.
{% hint style="warning" %}
このステップは必須であり、省略することはできません。省略した場合、広告が注文に帰属しなくなります。
{% endhint %}
#### ファイルによる注文の同期
注文ファイルに以下の列/セクションを追加する必要があります： `seller_id`すべての `seller_id` と `product_code` の組み合わせはユニークな行である必要があります。購入された非マーケットプレイス商品の場合、 `seller_id` は空にすることができます。
例については、以下をご覧ください： [ファイル経由での注文データ同期](/retail-media-interface/integration/ja/data-api/order-data-1/syncing-order-data-via-file.md)
#### API による注文の同期
API 経由で注文を同期する場合、注文報告時に該当する箇所の `sellerId` を同期する必要があります。購入した商品に `sellerId`がない場合は省略できます。
以下は、1つの商品がマーケットプレイスセラーからのもので、もう1つの商品が非マーケットプレイス商品である注文の例です：
```http
POST $BASE_URL/v1/orders HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic
{
"orders": [
{
"customerId": "npc-s243-ir",
"sessionId": "5cat7-9964-4f",
"orderDate": "2021-12-02T15:00:00Z",
"id": "abcti84ew-c158-4d78-a0af-b48bbwfrcss4",
"orderItems": [
{
"gtin": "9891998566P",
"quantity": 3,
"regularUnitPrice": "1.00",
"totalOrderItemPriceAfterDiscounts": "3.00",
"sellerId": "10sa-3s33-j8e3"
}
]
},
{
"gtin": "351998532P",
"quantity": 1,
"regularUnitPrice": "2.50",
"totalOrderItemPriceAfterDiscounts": "2.50"
}
]
}
]
}
```
## 既存チームの移行
マーケットプレイスセラーをサポートするために統合を拡張する場合、あなたまたは広告主が実行すべき手順がいくつかあります。商品が Epsilon Retail Media システム内でどのように動作するかを理解することが重要です。
seller ID のない商品と seller ID のある商品は、 Epsilon Retail Media システム内では2つの異なるエンティティです。そのため、更新が必要なすべての既存キャンペーンについて、新しい正しい商品バリアントを選択するようにキャンペーンを移行する必要があります。
1. マーケットプレイスの seller ID 機能を有効にする意向を Epsilon Retail Media テクニカルアカウントマネージャーに伝えます
2. テクニカルアカウントマネージャーは、内部アトリビューションがチームの移行を処理できるように設定されていることを確認できるはずです
3. seller ID 商品を使用して商品カタログを拡張します
4. seller ID を報告するように注文レポートを拡張します
5. 既存のチームを移行する場合は、既存のチームを編集して seller ID を指定します
6. チームが編集されたら、各チームのキャンペーンを編集して商品を再選択する必要があります。これは、キャンペーンで seller ID が選択された新しい商品が必要であるのに対し、チームに seller ID が設定される前に作成されたキャンペーンでは商品の正しいバリアントが選択されていないためです。
---
# 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/marketplace-sellerid.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.