{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","results":{"codes":[]},"settings":"","params":[]},"next":{"description":"","pages":[]},"title":"Regras da Coleta de Dados","type":"basic","slug":"coleta-de-dados","excerpt":"A Busca Personalizada utiliza-se de inteligência para personalizar a ordenação dos resultados de forma a entregar para seus usuários exatamente os produtos que eles estão procurando. Para esta inteligência aumentar orgânicamente com o tempo, precisamos que todos os dados relevantes estejam sendo coletados corretamente.","body":"Para obter uma coleta de dados perfeita, basta seguir algumas regras na implementação dos módulos da sua busca.\n[block:api-header]\n{\n  \"title\": \"1ª Regra: Dispare o clickUrl em todas as interações com os produtos\"\n}\n[/block]\nCada produto listado no resultado da busca contém uma propriedade chamada **clickUrl**.\n\nEste link deverá ser usado para registrar todos os eventos de interação dos usuários com os produtos do resultado da busca, seja ela de **Clique no Produto**, ou de** Adição ao Carrinho.**\n\nEstas interações deverão disparar um HTTP GET com a URL acrescentadas dos parâmetros conforme explicado na documentação da rota [/clicks](doc:clicks) .\n\nImportante: Nas interações que resultam no redirecionamento para outra página, realize o disparo da URL apenas na página destino para evitar que o navegador a cancele. Por exemplo, no clique de um produto que levará para a página de detalhes, sugerimos que salve o clickUrl dentro de um cookie, e que só dispare o mesmo ao chegar na página do produto.\n\n[block:api-header]\n{\n  \"title\": \"2ª Regra: Mantenha os parâmetros das URLs como retornado no JSON\"\n}\n[/block]\nEvite manipular os parâmetros de URLs retornados pela API. Fazemos o tracking das interações com os componentes por meio da adição de parâmetros específicos nas URLs. Alguns exemplos de parâmetros que retornaremos, e precisamos que não sejam removidos ou manipulados:\n\n`&origin=suggestions` , `&origin=autocomplete` , `&ranking=2`  ,  `&prefix=camiset`  \n\nAssim sendo, utilize as URLs exatamente como as retornamos no JSON.\n\n[block:api-header]\n{\n  \"title\": \"3ª Regra: Copie o searchId para o Tagueamento\"\n}\n[/block]\nNo JSON retorno da API você irá encontrar uma propriedade `searchId`. Esta propriedade deverá ser copiada para dentro do objeto de tagueamento, nas páginas de Busca e Categorias com dados servidos pela API de Busca. **Lembre-se de inserir a propriedade no objeto antes da execução do script.**\n\n```javascript\nwindow.linxMeta.searchId = \"dd906867-214a-4fb8-98fb-85c753481217\";\n```\n\n\nO objeto do tagueamento depende de qual a versão de integração você está utilizando. As integrações mais recentes utilizam o script `ìmpulse.js` com o objeto `window.linxMeta`, e as mais antigas o script `loader.js` e objeto `window.chaordic_meta`.\n\nMais informações em:  \n[Página de Categoria e Subcategoria](doc:tagging-category) \n[Página de Busca](doc:tagging-search)","updates":[],"order":2,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5d2f535c66ac4300120a9cdc","project":"55c3572a57f7f32d0016ec3d","version":{"version":"3-search","version_clean":"3.0.0-search","codename":"API de Busca pelo time de Integração","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5d00029d39c2920014e316db","5d00029d39c2920014e316dc","5d00029d39c2920014e316dd","5d00029d39c2920014e316de","5d00029d39c2920014e316df","5d00029d39c2920014e316e0","5d00029d39c2920014e316e1","5d00029d39c2920014e316e2","5d00029d39c2920014e316e3","5d00029d39c2920014e316e4","5d00029d39c2920014e316e5","5d00029d39c2920014e316e6"],"_id":"5d00029d39c2920014e31722","project":"55c3572a57f7f32d0016ec3d","__v":0,"forked_from":"590a413d12d47a3700f83c8e","createdAt":"2017-05-03T20:44:45.480Z","releaseDate":"2017-05-03T20:44:45.480Z"},"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"API de busca","slug":"api-de-busca","order":8,"from_sync":false,"reference":false,"_id":"5d00029d39c2920014e316e3","project":"55c3572a57f7f32d0016ec3d","createdAt":"2017-03-06T13:18:21.954Z","__v":0,"version":"5d00029d39c2920014e31722"},"user":"5bc5e6f88c00820013a35211","createdAt":"2019-07-17T16:57:00.607Z","__v":0,"parentDoc":null}

Regras da Coleta de Dados

A Busca Personalizada utiliza-se de inteligência para personalizar a ordenação dos resultados de forma a entregar para seus usuários exatamente os produtos que eles estão procurando. Para esta inteligência aumentar orgânicamente com o tempo, precisamos que todos os dados relevantes estejam sendo coletados corretamente.

Para obter uma coleta de dados perfeita, basta seguir algumas regras na implementação dos módulos da sua busca. [block:api-header] { "title": "1ª Regra: Dispare o clickUrl em todas as interações com os produtos" } [/block] Cada produto listado no resultado da busca contém uma propriedade chamada **clickUrl**. Este link deverá ser usado para registrar todos os eventos de interação dos usuários com os produtos do resultado da busca, seja ela de **Clique no Produto**, ou de** Adição ao Carrinho.** Estas interações deverão disparar um HTTP GET com a URL acrescentadas dos parâmetros conforme explicado na documentação da rota [/clicks](doc:clicks) . Importante: Nas interações que resultam no redirecionamento para outra página, realize o disparo da URL apenas na página destino para evitar que o navegador a cancele. Por exemplo, no clique de um produto que levará para a página de detalhes, sugerimos que salve o clickUrl dentro de um cookie, e que só dispare o mesmo ao chegar na página do produto. [block:api-header] { "title": "2ª Regra: Mantenha os parâmetros das URLs como retornado no JSON" } [/block] Evite manipular os parâmetros de URLs retornados pela API. Fazemos o tracking das interações com os componentes por meio da adição de parâmetros específicos nas URLs. Alguns exemplos de parâmetros que retornaremos, e precisamos que não sejam removidos ou manipulados: `&origin=suggestions` , `&origin=autocomplete` , `&ranking=2` , `&prefix=camiset` Assim sendo, utilize as URLs exatamente como as retornamos no JSON. [block:api-header] { "title": "3ª Regra: Copie o searchId para o Tagueamento" } [/block] No JSON retorno da API você irá encontrar uma propriedade `searchId`. Esta propriedade deverá ser copiada para dentro do objeto de tagueamento, nas páginas de Busca e Categorias com dados servidos pela API de Busca. **Lembre-se de inserir a propriedade no objeto antes da execução do script.** ```javascript window.linxMeta.searchId = "dd906867-214a-4fb8-98fb-85c753481217"; ``` O objeto do tagueamento depende de qual a versão de integração você está utilizando. As integrações mais recentes utilizam o script `ìmpulse.js` com o objeto `window.linxMeta`, e as mais antigas o script `loader.js` e objeto `window.chaordic_meta`. Mais informações em: [Página de Categoria e Subcategoria](doc:tagging-category) [Página de Busca](doc:tagging-search)