Este artigo documenta os passos necessários que um parceiro precisa seguir para permitir que os lojistas da plataforma de e-commerce utilizem os serviços da Trustvox de maneira plena.

1. Integração com API Trustvox

Para instruções sobre como realizar a integração Back-end (Criação de lojas e envio de informações sobre vendas das lojas via API da Trustvox), por favor, consulte este artigo (disponível somente em inglês).

Uma vez que a plataforma esteja integrado com nossa API, agora precisamos inserir no template da loja os scripts responsáveis pelos Widgets Trustvox.

2. Instalação Front-end

2.1. Widget de Opiniões e Perguntas

O script abaixo deve ser inserido na página de produto, preferencialmente dentro de "<head>".

<script type="text/javascript">
window._trustvox = [];
_trustvox.push(['_storeId', 'Id-Loja']);

_trustvox.push(['_productId', productId]);
_trustvox.push(['_productName', productName]);
_trustvox.push(['_productPhotos', [url.image]]);

<!-- Ambiente de produção -->
<script async="true" type="text/javascript" src="//static.trustvox.com.br/sincero/sincero.js"></script>

<!-- Ambiente de teste -->
<!-- <script async="true" type="text/javascript" src="//static.trustvox.com.br/sincero-staging/sincero.js"></script> -->

No local que deseja exibir o Widget, insira a DIV abaixo:

<div id="_trustvox_widget"></div>

O resultado deve ser:

2.1.1. Importação de sellers

Além das informações do produto, o widget permite que sejam enviadas informação pertencentes aos sellers de determinado produto, possibilitando a filtragem de opiniões e perguntas de produtos que são vendidos por determinados vendedores. Para isso é preciso que na instalação do widget, o script seja iniciado juntamente com a lista de sellers, que realiza a venda daquela produto, contendo a identificação, nome e logo de cada um deles.


<script type="text/javascript">
window._trustvox = [];
var sellers = [{ id: '123', name: 'Nome', logo: 'https://logo.url' }];
_trustvox.push(['_sellers', sellers]);
</script>

Para que a importação dos sellers ocorra, é necessário que a loja possua a preferencia enable_marketplace habilitada. Caso contrário, os sellers enviados serão ignorados.

2.2. Widget de Estrelas

2.2.1. Widget de Estrelas nas Prateleiras

É possível exibir a nota de cada produto na listagem dos produtos e também na página de produto próximo ao nome do mesmo.

O script abaixo deve ser inserido em todas as página que deseja exibir as estrelinhas, preferencialmente em "<head>".

<script type="text/javascript">
var _trustvox_shelf_rate = _trustvox_shelf_rate || [];
_trustvox_shelf_rate.push(['_storeId', 'Id-Loja']);
</script>

<!-- Ambiente de produção -->
<script type="text/javascript" async="true" src="//rate.trustvox.com.br/widget.js"></script>

<!-- Ambiente de teste -->
<!-- <script type="text/javascript" async="true" src="//static.trustvox.com.br/trustvox-rate-staging/widget.js"></script> -->

IMPORTANTE: Caso sua loja tenha prateleiras que carreguem dinamicamente (Scroll infinito é exemplo), será necessário adicionar a seguinte linha no script acima, identificando as mesmas:

_trustvox_shelf_rate.push(['_productContainer', '.exemploClassePrateleira, #exemploDivPrateleira']);

No local que deseja exibir as estrelas, insira o código abaixo:

<div data-trustvox-product-code="productId"></div>

O resultado deve ser:

2.2.2. Widget de Estrelas na página do Produto

Dentro do template da página de produto, próximo ao nome, deve inserir o código:

a class="trustvox-fluid-jump trustvox-widget-rating" href="#trustvox-reviews" title="Pergunte e veja opiniões de quem já comprou">
<div class="trustvox-shelf-container" data-trustvox-product-code-js="productId" data-trustvox-should-skip-filter="true" data-trustvox-display-rate-schema="true"></div>
<span class="rating-click-here">Clique e veja!</span>
</a>

<style type="text/css">
.trustvox-widget-rating .ts-shelf-container,
.trustvox-widget-rating .trustvox-shelf-container {display: inline-block;}
.trustvox-widget-rating:hover span.rating-click-here {text-decoration: underline;}
.trustvox-widget-rating span.rating-click-here {
top: -3px;
display: inline-block;
position: relative;
color: #DAA81D;
}
</style>

O estilo css pode ser inserido no css padrão da loja. Você tem total liberdade para altera-lo.

O resultado deve ser:

2.2.3. Indexação das estrelas pelo Google

Para maximizar a chance do Google indexar seu produto e no resultado de busca exibir seu produto com Rich Snippets é necessário seguir os seguintes passos...

Adicionar as propriedades aos elementos visíveis:

<div id="content" itemscope="" itemtype="http://schema.org/Product">
<div id="name" class="product-name">
<h1 class="name" itemprop="name">Nome do seu produto</h1>
...

As <divs> são apenas ilustrativas, o importante são as propriedades "itemscope", "itemtype" e "itemprop".

Ferramenta do Google para validar seu código: Structured Data Testing Tool

2.3. Instalação do Selo Reviews Verdadeiros

Artigo de apoio: Quem pode ter o selo?

Script de instalação:

<!-- Ambiente de produção -->
<script type="text/javascript" async="true" src="//certificate.trustvox.com.br/widget.js"></script>

<!-- Ambiente de teste -->
<!-- <script type="text/javascript" async="true" src="//static.trustvox.com.br/certificate-widget-staging/widget.js"></script> --><br>

Com isto você já consegue habilitar a versão flutuante do selo, através do painel Trustvox.

2.3.1. Em seu painel Trustvox, vá até o canto superior direito e clique no seu usuário; Depois, clique em "Selo e Certificado":

Em "Personalize a aparência do seu selo", habilite o Selo e escolha a melhor opção de localização.

O Selo, dispõe de diversas configurações para um posicionamento adequado na sua página:

Usar posição flutuante

Nenhum elemento adicional é necessário ao selecionar a versão flutuante. Para utilizá-la basta marcar a opção "Posição flutuante", e então escolher qual sua posição.

Usar posição fixa

Para utilizar a opção "Posição fixa" é necessário incluir também um elemento específico na página, logo após o script de instalação acima.

<div data-trustvox-certificate-fixed="data-trustvox-certificate-fixed"></div>

Formato de exibição do certificado Reviews Verdadeiros

O Certificado Reviews Verdadeiros é exibido ao clicar no Selo. Existem duas formas de exibição disponíveis deste certificado. Uma delas é utilizando-o apenas como um link que carrega na mesma página, e a outra é utilizando-o como um pop-up.

Link

Esse é o comportamento padrão do selo. Ele apenas imprime na página da loja a imagem do selo Reviews Verdadeiros e ao ser clicada, redireciona para o endereço correspondente do certificado. Para ativá-lo basta manter a opção "Exibir em pop-up/modal" desmarcada.

Pop-Up/Modal

A opção "Exibir selo em modal" já vem pré-selecionada inicialmente. Ela exibe o selo dentro de uma espécie de pop-up/modal dentro da própria página da loja (conforme mostra a figura abaixo):

Caso fique com alguma dúvida, entre em contato com a RA Trustvox através do chat 💬 disponível no menu 'Dúvidas e Suporte' no símbolo de interrogação ❔ do seu painel (de Segunda a Sexta das 9h às 17h - exceto feriados). Conte com a gente! 💚

Encontrou sua resposta?