> 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/es/feature-integrations/marketplace-sellerid.md).
# Marketplace sellerId
## ¿Qué es un marketplace?
Los marketplaces son una oportunidad única para que los minoristas amplíen su presencia en línea y capten con facilidad a compradores nuevos u ocasionales. Los marketplaces permiten a las empresas más pequeñas llegar a una gran variedad de clientes, y normalmente el vendedor del marketplace realiza el envío directamente al cliente.
Los marketplaces permiten a los vendedores vender sus productos en el sitio de un minorista, lo que aumenta la visibilidad de sus productos ante un público más amplio. Mientras que los minoristas obtienen ofertas de productos adicionales para vender a una gama más amplia de clientes.
Además de monetizar su sitio con funcionalidades de marketplace, los minoristas también pueden aprovechar este espacio virtual premium y ofrecer la oportunidad a los vendedores del marketplace de pujar por las primeras posiciones a través de Epsilon Retail Media a través de la documentación que se enumera a continuación.
## Configuración de anunciantes de marketplace
Una vez completadas las mejoras de integración (detalladas a continuación), podrá establecer un Seller ID por equipo. Esto solo se puede hacer al crear un equipo desde el equipo del minorista, no se puede hacer al editar un equipo ni por parte de un proveedor.
Existe una sección de "Campos opcionales" al crear un nuevo equipo en la que se puede seleccionar el Seller ID. Los Seller ID que se pueden seleccionar provienen directamente de su catálogo de productos. No puede introducir un valor que no esté presente en el catálogo de productos.
## Requisitos de integración
### Resumen de alto nivel
Además de una integración estándar con Epsilon Retail Media, su integración deberá mejorarse con los siguientes cambios:
* Implementar un sellerId por producto en el archivo del catálogo de productos o API
* Analizar la respuesta del anuncio y renderizar la oferta del vendedor correcto cuando sea relevante
* Notificar un sellerId por producto único al notificar pedidos a Epsilon Retail Media
{% hint style="warning" %}
Actualmente, Epsilon Retail Mediala función de no cubre completamente el caso de uso en el que un vendedor de un producto no tiene seller ID, y también existen variantes de seller ID de productos. Una solución alternativa identificada para esto es sincronizar un seller ID de minorista en cualquier producto que no sea de marketplace, y cada proveedor que no sea un vendedor de marketplace debe tener este seller ID añadido. Póngase en contacto con su gestor de cuentas técnico para obtener más información.
{% endhint %}
### Mejoras en el catálogo de productos.
En su catálogo de productos sincronizado con Citrus, deberá proporcionar un sellerId por código de producto único a Epsilon Retail Media.
#### Sincronización del catálogo mediante archivo
Deberá añadir una columna/sección adicional al archivo de su catálogo de `seller_id`. Cada `seller_id` y `product_code` la combinación debe ser una fila única. Para los productos que no son de marketplace, el `seller_id` puede estar vacío.
{% hint style="warning" %}
Los productos que tienen tanto un vendedor de marca (donde el producto no tiene sellerId) como vendedores de marketplace (donde el mismo producto tiene variantes de sellerId) son actualmente incompatibles. Si tiene productos que entran en esta categoría, le recomendamos que solo incorpore vendedores de marketplace para estos productos específicos en este momento.
Si su sitio de comercio electrónico está configurado con este caso de uso particular de productos, le rogamos que plantee esta cuestión a su Epsilon Retail Media contacto, ya que estamos considerando hacer que este caso de uso sea compatible.
{% endhint %}
Para ver ejemplos, visite [Sincronización de catálogo y producto mediante archivo](/retail-media-interface/integration/es/data-api/catalog-products-2/syncing-catalog-products-via-file.md)
#### Sincronización del catálogo mediante API
Al sincronizar productos mediante API, deberá sincronizar un `sellerId` por cada combinación única de `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"
}
]
}
```
### Mejoras en la respuesta de anuncios
Cuando Epsilon Retail Media sirve anuncios, se servirá un `sellerId` si el `gtin` tiene uno asociado. Esto se aplica a todos los tipos de anuncios, pero solo es relevante para la representación de anuncios a partir de anuncios de productos. A continuación se muestra un ejemplo de respuesta de anuncio de producto:
```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="
}
```
Para garantizar que se muestre la oferta del vendedor correcto, debe leer el `sellerId` proporcionado por Epsilon Retail Media y mostrar la oferta del vendedor correcto al cliente.
### Mejoras en la notificación de pedidos
Al notificar pedidos a Epsilon Retail Media, también deberá especificar el `sellerId` por cada combinación única de `gtin` cuando notifique pedidos a Epsilon Retail Media.
{% hint style="warning" %}
Este paso es obligatorio y no se puede omitir, o los anuncios no se atribuirán a los pedidos.
{% endhint %}
#### Sincronización de pedidos mediante archivo
Deberá añadir una columna/sección adicional al archivo de pedidos de `seller_id`. Cada `seller_id` y `product_code` la combinación debe ser una fila única. Para los productos comprados que no sean de marketplace, el `seller_id` puede estar vacío.
Para ver ejemplos, visite [Sincronización de datos de pedidos mediante archivo](/retail-media-interface/integration/es/data-api/order-data-1/syncing-order-data-via-file.md)
#### Sincronización de pedidos mediante API
Al sincronizar pedidos mediante API, deberá sincronizar el `sellerId` cuando corresponda al notificar pedidos. En caso de que el producto comprado no tenga un `sellerId`, se puede omitir.
A continuación se muestra un ejemplo de un pedido en el que un producto procede de un vendedor de marketplace y otro no es un producto de marketplace:
```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"
}
]
}
]
}
```
## Migración de equipos existentes
Si está mejorando su integración para admitir vendedores de marketplace, hay una serie de pasos que usted o sus anunciantes deben seguir. Es importante saber cómo funcionan los productos dentro del sistema de Epsilon Retail Media .
Un producto sin seller ID y un producto con seller ID son dos entidades únicas en el sistema de Epsilon Retail Media . Como tal, las campañas deben migrarse para seleccionar la nueva variante de producto correcta para todas las campañas existentes que necesiten actualizarse.
1. Informe a su Epsilon Retail Media gestor de cuentas técnico sobre su intención de habilitar la función de seller ID de marketplace
2. Su gestor de cuentas técnico debería poder garantizar que nuestra atribución interna esté configurada para gestionar la migración de equipos
3. Mejorar el catálogo de productos con productos con seller ID
4. Mejorar la notificación de pedidos para notificar el seller ID
5. Si va a migrar equipos existentes, edite los equipos existentes para especificar el seller ID
6. Una vez editado un equipo, se deben editar las campañas de cada equipo para volver a seleccionar los productos. Esto se debe a que necesitamos que se seleccione en la campaña el nuevo producto con un seller ID, mientras que las campañas creadas antes de que el equipo tuviera un seller ID no tendrán seleccionada la variante correcta del producto.
---
# 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/es/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.