> 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/pt-br/feature-integrations/marketplace-sellerid.md).
# sellerId do marketplace
## O que é um marketplace?
Marketplaces são uma oportunidade única para os varejistas expandirem sua presença online, bem como engajarem novos compradores ou compradores ocasionais com facilidade. Os marketplaces permitem que empresas menores alcancem uma grande variedade de clientes, normalmente com envio feito diretamente pelo vendedor do marketplace para o cliente.
Os marketplaces permitem que os vendedores vendam seus produtos no site de um varejista, aumentando a visibilidade de seus produtos para um público mais amplo. Enquanto isso, os varejistas obtêm ofertas adicionais de produtos para vender a uma gama maior de clientes.
Além de monetizar seu site com recursos de marketplace, os varejistas também podem capitalizar esse espaço nobre na prateleira online e oferecer a oportunidade para fornecedores do marketplace darem lances pelas primeiras posições por meio de Epsilon Retail Media por meio da documentação listada abaixo.
## Configuração de anunciantes do marketplace
Assim que as melhorias da sua integração estiverem concluídas (detalhadas abaixo), você poderá definir um Seller ID por equipe. Isso só pode ser feito ao criar uma equipe a partir da equipe do varejista; não é possível fazer isso ao editar uma equipe ou por meio de um fornecedor.
Existe uma seção de "Campos opcionais" ao criar uma nova equipe onde o Seller ID pode ser selecionado. Os Seller IDs disponíveis para seleção são obtidos diretamente do seu catálogo de produtos. Você não pode inserir um valor que não esteja presente no catálogo de produtos.
## Requisitos de integração
### Visão geral de alto nível
Além de uma integração padrão com Epsilon Retail Mediasua integração precisará ser aprimorada com as alterações abaixo:
* Implemente um sellerId por produto no arquivo de catálogo de produtos ou API
* Analise a resposta do anúncio e exiba a oferta do vendedor correto quando relevante
* Informe um sellerId por produto exclusivo ao relatar pedidos para Epsilon Retail Media
{% hint style="warning" %}
Atualmente, o recurso da Epsilon Retail Medianão atende totalmente ao caso de uso em que um vendedor de um produto não possui ID de vendedor e também existem variantes de ID de vendedor para os produtos. Uma solução alternativa identificada para isso é sincronizar um ID de vendedor do varejista em qualquer produto que não seja de marketplace, e cada fornecedor que não seja um vendedor de marketplace deve ter esse ID de vendedor adicionado. Entre em contato com seu gerente de contas técnico para saber mais.
{% endhint %}
### Aprimoramentos no catálogo de produtos.
Em seu catálogo de produtos sincronizado com a Citrus, você precisará fornecer um sellerId por código de produto exclusivo para Epsilon Retail Media.
#### Sincronização de catálogo via arquivo
Você precisará adicionar uma coluna/seção adicional ao seu arquivo de catálogo de `seller_id`. Cada combinação de `seller_id` e `product_code` deve ser uma linha exclusiva. Para produtos que não são de marketplace, o `seller_id` pode ficar em branco.
{% hint style="warning" %}
Produtos que possuem tanto um vendedor da marca (onde o produto não tem sellerId) quanto vendedores do marketplace (onde o mesmo produto possui variantes de sellerId) são atualmente incompatíveis. Se você tiver produtos que se enquadram nessa categoria, recomendamos que você integre apenas vendedores de marketplace para esses produtos específicos no momento.
Se o seu site de e-commerce estiver configurado com esse caso de uso específico de produtos, solicitamos que você levante essa questão com o seu contato da Epsilon Retail Media pois estamos considerando tornar esse caso de uso compatível.
{% endhint %}
Para ver exemplos, visite [Sincronizando catálogo e produto via arquivo](/retail-media-interface/integration/pt-br/data-api/catalog-products-2/syncing-catalog-products-via-file.md)
#### Sincronização de catálogo via API
Ao sincronizar produtos via API, você precisará sincronizar um `sellerId` por combinação exclusiva 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"
}
]
}
```
### Aprimoramentos na resposta do anúncio
Quando Epsilon Retail Media exibe anúncios, um `sellerId` será exibido se o `gtin` possui um associado a ele. Isso se aplica a todos os tipos de anúncios, mas só é relevante para a renderização de anúncios a partir de anúncios de produtos. Um exemplo de resposta de anúncio de produto está abaixo:
```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 garantir que a oferta correta do vendedor seja exibida, você deve ler o `sellerId` fornecido por Epsilon Retail Media e exibir a oferta correta do vendedor para o cliente.
### Melhorias no relatório de pedidos
Ao relatar pedidos para Epsilon Retail Media, você também precisará especificar o `sellerId` por combinação exclusiva de `gtin` quando relatar pedidos para Epsilon Retail Media.
{% hint style="warning" %}
Esta etapa é obrigatória e não pode ser ignorada, caso contrário, os anúncios não serão atribuídos aos pedidos.
{% endhint %}
#### Sincronizando pedidos via arquivo
Você precisará adicionar uma coluna/seção adicional ao seu arquivo de pedidos do `seller_id`. Cada combinação de `seller_id` e `product_code` a combinação deve ser uma linha exclusiva. Para produtos comprados que não sejam de marketplace, o `seller_id` pode estar vazio.
Para exemplos, visite [Sincronizando dados de pedidos via arquivo](/retail-media-interface/integration/pt-br/data-api/order-data-1/syncing-order-data-via-file.md)
#### Sincronizando pedidos via API
Ao sincronizar pedidos via API, você precisará sincronizar o `sellerId` onde aplicável ao relatar pedidos. Caso o produto adquirido não tenha um `sellerId`, ele pode ser omitido.
Abaixo está um exemplo de um pedido em que um produto é de um vendedor do marketplace e outro não é um produto do 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"
}
]
}
]
}
```
## Migrando equipes existentes
Se você estiver aprimorando sua integração para dar suporte a vendedores do marketplace, há uma série de etapas que você ou seus anunciantes precisam seguir. É importante saber como os produtos funcionam dentro do Epsilon Retail Media sistema.
Um produto sem ID de vendedor e um produto com ID de vendedor são duas entidades exclusivas no Epsilon Retail Media sistema. Como tal, as campanhas precisam ser migradas para selecionar a nova variação correta do produto para todas as campanhas existentes que precisam ser atualizadas.
1. Informe seu Epsilon Retail Media gerente de contas técnico sobre sua intenção de ativar o recurso de ID de vendedor do marketplace
2. Seu gerente de contas técnico deve ser capaz de garantir que nossa atribuição interna esteja configurada para lidar com a migração de equipes
3. Aprimorar o catálogo de produtos com produtos com ID de vendedor
4. Aprimorar o relatório de pedidos para relatar o ID do vendedor
5. Se estiver migrando equipes existentes, edite as equipes existentes para especificar o ID do vendedor
6. Depois que uma equipe é editada, as campanhas de cada equipe precisam ser editadas para selecionar os produtos novamente. Isso ocorre porque precisamos do novo produto com um ID de vendedor selecionado na campanha, enquanto as campanhas criadas antes de a equipe ter um ID de vendedor não terão a variação correta do produto selecionada.
---
# 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/pt-br/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.