Precisa de ajuda com sua integração Topsort?
Fale conosco, a equipe de engenharia de integrações.
Entre em contato através do seu canal de mensagens dedicado ou em{" "}
support@topsort.com.
Se você ainda não é cliente,{" "}
agende uma demo com nossa
equipe de vendas.
;
};
O proxy é uma camada intermediária entre o backend do marketplace e o servidor de resultados (servidor do Algolia, por exemplo). Ele atua como uma ponte entre o marketplace, o mecanismo de busca e o Topsort. Isso permite que o proxy ingira os vencedores do leilão recuperados do Topsort na resposta fornecida pelo mecanismo de busca e retorne a resposta mesclada final ao marketplace.
O proxy é compatível com a maioria dos stacks tecnológicos e foi testado com plataformas como VTEX, Algolia e Salesforce.
## Como Usar o Proxy
Para começar a usar o proxy, você só precisa alterar o hostname na sua chamada de API existente, do seu catálogo ou mecanismo de busca para nosso proxy. Por exemplo, mude de:
```http theme={null}
https://api.site.com/catalog/query?taxonomy=clothes
```
para:
```http theme={null}
https://site.proxy.topsort.com/catalog/query?taxonomy=clothes
```
E nós cuidamos do resto. Enviamos a solicitação para o motor de leilão do Topsort e para o catálogo ou mecanismo de busca. Se algum dos produtos retornados pelo catálogo ou mecanismo de busca for promovido, indicaremos isso na resposta mesclada que construiremos, que será retornada ao marketplace.
Atualmente, o proxy suporta respostas application/json. Suporte para XML e GraphQL está planejado.
## Como Produtos Promovidos São Adicionados
Considere a seguinte solicitação, que busca produtos da taxonomia 'office':
```http theme={null}
GET https://api.site.com/catalog/query?taxonomy=office
```
A resposta do catálogo ou servidor de busca sem a integração do proxy do Topsort:
```json theme={null}
{
"products": [
{ "id": "1", "name": "Impressora Laser Colorida de Alta Velocidade" },
{ "id": "2", "name": "Mesa de Pé Ajustável" },
{ "id": "3", "name": "Cadeira de Escritório Giratória Ergonômica" },
{ "id": "4", "name": "Combo de Teclado e Mouse Sem Fio" },
{ "id": "5", "name": "Quadro Branco Magnético com Conjunto de Marcadores" }
]
}
```
Após mesclar produtos promovidos na resposta:
```json theme={null}
{
"products": [
{
"id": "3",
"name": "Cadeira de Escritório Giratória Ergonômica",
"rank": 1,
"resolvedBidId": "..."
},
{
"id": "6",
"name": "Armário de Arquivo com Múltiplas Gavetas",
"rank": 2,
"resolvedBidId": "..."
},
{ "id": "1", "name": "Impressora Laser Colorida de Alta Velocidade" },
{ "id": "2", "name": "Mesa de Pé Ajustável" },
{ "id": "4", "name": "Combo de Teclado e Mouse Sem Fio" }
],
"topsort": {
"winners": [
{ "rank": 1, "type": "product", "id": "3", "resolvedBidId": "..." },
{ "rank": 2, "type": "product", "id": "6", "resolvedBidId": "..." }
]
}
}
```
## Entendendo os Novos Campos
* **rank**: A posição do produto promovido no leilão.
* **resolvedBidId**: Um ID único usado para rastrear o produto em análises.
Um novo objeto chamado **topsort** é adicionado no nível raiz apenas quando produtos promovidos são incluídos.
## Como Rastrear Eventos
Se você usar a biblioteca analytics.js do Topsort ou a API de Eventos, use os campos product id e resolvedBidId para rastrear interações do usuário:
```html theme={null}
