> 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/ko/feature-integrations/marketplace-sellerid.md).
# 마켓플레이스 sellerId
## 마켓플레이스란 무엇인가요?
마켓플레이스는 리테일러가 온라인 입지를 확장하고 신규 고객이나 일시적 구매자를 손쉽게 유치할 수 있는 특별한 기회입니다. 마켓플레이스를 통해 소규모 비즈니스는 다양한 고객에게 다가갈 수 있으며, 일반적으로 마켓플레이스 판매자가 고객에게 직접 배송합니다.
마켓플레이스를 사용하면 판매자가 리테일러의 사이트에서 제품을 판매하여 더 광범위한 고객층에게 제품 노출도를 높일 수 있습니다. 한편 리테일러는 더 많은 고객에게 판매할 수 있는 추가 제품 제공 범위를 확보하게 됩니다.
마켓플레이스 기능을 통해 사이트를 수익화할 수 있을 뿐만 아니라, 리테일러는 이러한 프리미엄 온라인 진열 공간을 활용하여 마켓플레이스 판매자가 다음을 통해 상위 위치에 입찰할 수 있는 기회를 제공할 수 있습니다. Epsilon Retail Media 아래에 나열된 설명서를 참조하세요.
## 마켓플레이스 광고주 설정하기
연동 개선 작업(아래에 자세히 설명됨)이 완료되면 팀별로 Seller ID를 설정할 수 있습니다. 이는 리테일러 팀에서 팀을 생성할 때만 가능하며, 팀을 수정할 때나 공급업체가 설정할 수는 없습니다.
새 팀을 생성할 때 Seller ID를 선택할 수 있는 "Optional fields" 섹션이 있습니다. 선택할 수 있는 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 변형이 있는 경우)가 모두 있는 제품은 현재 호환되지 않습니다. 이 범주에 해당하는 제품이 있는 경우, 현재로서는 해당 특정 제품에 대해서만 마켓플레이스 판매자를 온보딩하는 것이 좋습니다.
이커머스 사이트가 이러한 특정 제품 사용 사례로 설정되어 있는 경우, 당사에서 이 사용 사례를 호환 가능하도록 검토 중이므로 Epsilon Retail Media 담당자에게 이 문제를 제기해 주시기 바랍니다.
{% endhint %}
예시를 보려면 다음을 방문하세요. [파일을 통해 카탈로그 및 제품 동기화](/retail-media-interface/integration/ko/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/ko/data-api/order-data-1/syncing-order-data-via-file.md)
#### API를 통해 주문 동기화
API를 통해 주문을 동기화할 때 주문을 리포팅할 때 해당되는 경우 `sellerId` 을(를) 동기화해야 합니다. 구매한 제품에 `sellerId`이(가) 없는 경우 생략할 수 있습니다.
아래는 한 제품은 마켓플레이스 판매자의 제품이고 다른 제품은 마켓플레이스 제품이 아닌 주문의 예입니다.
```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 시스템에서 두 개의 고유한 엔티티입니다. 따라서 업데이트해야 하는 모든 기존 캠페인에 대해 올바른 새 제품 변형을 선택하도록 캠페인을 마이그레이션해야 합니다.
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/ko/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.