Navigate é a criação automática de URLs para navegação por categorias e atributos de produtos. Esta requisição é utilizada para obter uma lista de produtos filtrados (que atendem um conjunto de requisitos). Pode ser utilizado na montagem de menus, peças de email marketing e banners. Também para construir páginas de navegação de categoria ou de marcas específicas, por exemplo.
Como fazer a consulta?
Para realizar uma consulta, você pode passar um caminho de categoria
https://api.linximpulse.com/engage/search/v3/navigates?apiKey=<loja>&secretKey=<secretKey>&category=games&category=nintendo
Você pode, também, passar um filtro válido
https://api.linximpulse.com/engage/search/v3/navigates?apiKey=<loja>&secretKey=<secretKey>&fields=marca:nintendo
Como é a resposta?
A resposta segue o mesmo formato das consultas ***search***. Consultas com resultado vazio ou não encontrado, possuem código de resposta 404. Os produtos retornados estarão no campo **products**. O formato/conteúdo de cada produto no **products** está listado acima na seção **Parameters** na explicação do campo **productFormat**. É importante notar que alguns valores retornados no **products** são opcionais, ou seja, nem sempre serão retornados, por exemplo o campo **customBusiness**.
Existem outros campos que são retornados conforme a resposta para aquela consulta. Os principais campos estão descritos abaixo.
| Campo | Descrição |
|---|---|
| filters | Lista de filtros retornados pela consulta. Cada filtro pode ser de um tipo, identificaod no campo type. Os valores possíveis são:
|
| banners | Banner a ser exibido na página de resultados. Algumas consultas podem ter banners associados a ela, neste caso eles serão retornados neste campo. |
Alguns campos existentes na resposta possuem valores padrões. Abaixo descrevemos alguns desses campos.
O campo pagination traz informações referentes à paginação. Em casos onde o resultado possui muitos produtos, estes são segmentados por páginas. Este campo é um objeto que pode possuir os campos abaixo:
| Campo | Descrição |
|---|---|
| first | Url da primeira página de resultados. Por padrão seu número é 1. |
| last | Url da última página de resultados. |
| next | Url da próxima página de resultados. Por padrão seu valor é a página atual+1. |
| previous | Url da página anterior de resultados. Por padrão seu valor é a página atual-1 |
Tracking de eventos
Eventos de click
Cada produto do resultado da busca contém um campo chamado clickUrl.
Este campo fornece uma URL da API de Busca, na rota /clicks que deverá ser usada para registrar todos os eventos de click dos usuários da aplicação com os produtos do resultado da busca. É por meio destes registros que geramos métricas de performance da busca, além de melhorar as estratégias para acertar em cheio cada resultado.
{
id: "10005354",
name: "oculos",
price: 249.98,
oldPrice: 249.98,
url: "...",
images: {
template-418481: "...",
1000x1000: "..."
},
installment: {
count: 6,
price: 41.66
},
status: "AVAILABLE",
clickUrl: "/search/v3/clicks?apikey=loja&trackingId=eyJzZWFyY2hJZCI6IjQ1NTE5MDkwLTQxMDktNGM1MC1hNGZmLTYwMGM0YTZhOWVkZiIsIm9yaWdpbiI6InNlYXJjaCIsInByb2R1Y3QiOnsicmFua2luZyI6MSwicGlkIjoiMTAwMDUzNTciLCJza3VzIjpbXX19",
categories: [
{
id: "ÓCULOS DE SOL",
name: "ÓCULOS DE SOL",
parents: [ ],
used: true
}
],
tags: [
{
id: "oculos_de_sol",
name: "ÓCULOS DE SOL",
parents: [ ]
}
],
specs: { },
created: "2018-08-02 11:52:51",
brand: null,
collectInfo: {
skuList: [ ],
productId: "10005354"
},
cId: "84",
iId: 10641,
skus: [
{
sku: "2067712",
specs: { },
properties: {
stock: 1,
name: "oculos",
oldPrice: 249.98,
url: "...",
price: 249.98,
eanCode: "7909140245889",
status: "available",
details: {
referenceId: "7909140245889",
measurement: {
unit: "un",
multiplier: 1
}
},
installment: {
price: 41.66,
count: 6
},
images: {
template-418481: "...",
1000x1000: "..."
}
}
}
],
details: {
productReference: [
"..."
],
clusterHighlights: [
{
178: "Mais Vistos",
192: "Todos produtos",
246: "lightbox-oculos",
247: "modal-oculos"
}
],
brand: [
"..."
],
referenceId: [
"7909140245889"
],
measurement: [
{
unit: "un",
multiplier: 1
}
],
categoryName: [
"ÓCULOS DE SOL"
]
},
description: "..."
}
Ao clickUrl deverá ser adicionada a URL base da API no início e ao final os parâmetros exigidos pela rota de click. Detalhes dos parâmetros da rota de click podem ser encontados em /clicks
Por exemplo:
https://api.linximpulse.com/engage/search/v3/clicks?apikey=loja&trackingId=eyJzZWFyY2hJZCI6IjQ1NTE5MDkwLTQxMDktNGM1MC1hNGZmLTYwMGM0YTZhOWVkZiIsIm9yaWdpbiI6InNlYXJjaCIsInByb2R1Y3QiOnsicmFua2luZyI6MSwicGlkIjoiMTAwMDUzNTciLCJza3VzIjpbXX19&deviceid=teste&source=desktop
É recomendado que este evento seja disparado somente depois que o usuário acessar a página do produto, evitando assim que o browser cancele a requisição caso a página de produto seja carregada antes que o disparo tenha sido concluído.