Utilizar Trusted Shops com Shopware 6

Utiliza o Shopware 5? O plugin gratuito Trusted Shops para Shopware 5 com o respetivo manual de integração pode ser encontrado aqui: Instalar o plugin Shopware 5

O novo plugin é compatível com as seguintes versões do sistema da sua loja:

a partir da versão 6.4.14

Além disso, o seu sistema deve cumprir os seguintes requisitos:

Pode encontrar informações detalhadas sobre o sistema de aplicações da Shopware aqui: Apps
O seu sistema deve utilizar um dos idiomas suportados pelo plug-in. Atualmente, são suportados os idiomas com os seguintes códigos ISO: de_DE, en_EN, es_ES, fr_FR, it_IT, nl_NL, pl_PL, pt_PT.
A APP_URL do ficheiro .env tem de estar acessível para serviços externos.
A APP_URL tem de especificar o domínio do primeiro canal de vendas.
O valor de core.app.shopId na tabela system_config tem de corresponder à APP_URL correspondente.

Pode encontrar mais informações sobre a APP_URL aqui: Notes to the APP_URL

A sua versão não é compatível? Depois pode continuar a utilizar o plugin que tem vindo a utilizar até à data. No entanto, tenha em atenção que interrompemos o apoio técnico ao plugin utilizado até ao dia 30 de março de 2023. Após esta data, poderão ocorrer problemas técnicos.
Por conseguinte, recomendamos que actualize o seu sistema de loja o mais rapidamente possível e depois mude para o novo plugin.

Para Shopware 6, está disponível um novo plugin desde novembro de 2022. Por isso, existem dois métodos de instalação:

Método de instalação 1: Já utiliza um plugin da Trusted Shops para o Shopware 6.

Primeiro, desinstale o plugin utilizado usando o capítulo "Desinstalação".
De seguida, instale o plugin atual utilizando o capítulo "Instalação".

Método de instalação 2: Ainda não utilizou nenhum plugin da Trusted Shops para o Shopware 6.

Salte o capítulo "Desinstalação".
Instale o plugin atual utilizando o capítulo "Instalação".

Desinstalação

Iniciar sessão no Shopware 6 Backend.
Clique em "Extensões" () na navegação principal. Depois clique em "Minhas extensões" ().
Aparece a visão geral "Minhas extensões". Clique nos três pequenos pontos () do lado direito, ao lado da "Trusted Shops Integration". De seguida, clique em "Desinstalar" ().
É aberta uma janela adicional. Ative o interruptor junto a "Remover todos os dados do aplicativo permanentemente" (). De seguida, clique em "Desinstalar" ().
Aparece a visão geral "Minhas extensões". Clique nos três pequenos pontos () do lado direito, ao lado da "Trusted Shops Integration". De seguida, clique em "Remover" ().

O seu plugin utilizado até agora foi desinstalado com sucesso. Siga agora o capítulo "Instalação" para instalar o plugin atual.

Instalação

A extensão gratuita Trusted Shops para Shopware está disponível aqui. Pode encontrar uma descrição detalhada sobre como adicionar extensões com o Shopware aqui.

Depois disso, o plug-in Trusted Shops deve ser instalado no seu sistema. Para tal, selecione primeiro o item do menu "Extensões" () na navegação principal e clique no item do menu "Minhas extensões" () no menu pendente que aparece agora.

Agora aparece uma vista geral das suas extensões. Nesta vista geral, clique no botão "Instalar aplicativo" ao lado do plug-in adicionado para instalar totalmente o plug-in.

Em seguida, ative o plug-in colocando o interruptor de "desativado" para "ativado". Após a instalação e ativação bem sucedidas do plug-in, pode começar com a configuração. Para isso, clique no botão "..." ao lado do plug-in na vista geral "Minhas extensões" e selecione "Abrir extensão".

Login

Tem de ser membro da Trusted Shops para poder utilizar o plug-in. Ainda não é membro? Então clique no link "Ainda não é cliente?" no canto superior direito do ecrã de Login. Depois de clicar, será encaminhado para o nosso website, onde poderá informar-se sobre as possibilidades de adesão.

Para iniciar sessão no plug-in, precisa de dados de acesso individuais – as designadas API Client Credentials. As API Client Credencials não são idênticas aos seus dados de acesso para o Centro de Controlo eTrusted. A seguir, ficará a saber como criar as suas API Client Credentials e iniciar sessão com elas no plug-in.

Abra o plug-in. Aparece o ecrã de Login.
Clique em "Pedir".
A página de Login eTrusted aparece num novo separador do browser. Introduza o seu nome de utilizador () e palavra-passe () e clique em "Log in" ().
É apresentada uma vista geral "API Client Management" numa janela pop-up. Clique no símbolo de documento azul superior para copiar o seu Client ID para a sua cache.
Abra o separador do browser com a página de Login do plug-in. Insira o Client ID guardado temporariamente, clicando no botão direito do rato e em "Inserir" no campo "Client ID".
Aceda à janela pop-up com a vista geral "API Client Management". Clique no símbolo do documento azul inferior para copiar o seu Client Secret para a sua cache.
Abra o separador do browser com a página de Login do plug-in. Insira o Client Secret guardado temporariamente, clicando no botão direito do rato e em "Inserir" no campo "Client Secret" (). De seguida, clique em "Ligar" ().

O passo seguinte não é necessário se o seu canal de venda registado na Trusted Shops puder ser atribuído inequivocamente a um canal eTrusted. Neste caso, o plug-in abre-se diretamente.

É aberta uma janela pop-up. Associe os seus canais de venda registados na Trusted Shops (p. ex., lojas com diferentes idiomas, domínios) ao respetivo canal eTrusted por meio dos menus suspensos (). Depois, clique em "Guardar" ().

Tem de associar pelo menos um dos seus canais de venda ao eTrusted para poder clicar em "Guardar". Recomendamos que associe todos os seus canais de venda ao eTrusted antes de iniciar a configuração. Caso contrário, as configurações que fez não serão visualizáveis na sua loja. Através do separador "Ajustes" no plug-in, tem sempre a possibilidade de alterar as suas associações.

Com isto, iniciou a sessão no seu plug-in com sucesso e associou os canais.

Configuração

A seguir, mostramos-lhe como pode exibir a tecnologia Trustbadge® e configurá-la de acordo com as suas preferências individuais:

Exibir Trustbadge, integrar a Proteção ao Comprador e recolher as avaliações
Exibir na sua loja as avaliações da loja e do produto que foram recolhidas
Enviar convites de avaliação de modo otimizado
Outras opções de ajuste

Exibir Trustbadge, integrar a Proteção ao Comprador e recolher as avaliações

Com a tecnologia única Trustbadge, pode recolher, gerir e exibir as avaliações dos seus clientes na sua loja sem qualquer esforço. Além disso, pode simplesmente integrar o seu Selo de Qualidade e oferecer a Proteção ao Comprador.

Abra o separador "Trustbadge" no plug-in.
No menu suspenso "Canal selecionado" (), selecione o canal de venda para o qual pretende efetuar a configuração.

Tem a possibilidade de efetuar configurações individuais para cada um dos seus canais de venda. A configuração efetuada para um canal não será assumida para os seus outros canais de venda. Por isso, não se esqueça de configurar também os seus outros canais.

Verifique se o botão está definido para "ativo" (). Esta configuração ativa o Trustbadge.
Agora, tem várias possibilidades de configurar o Trustbadge:
- Selecione "Standard" (). Neste caso, o Trustbadge é exibido na vista de ambiente de trabalho (Desktop), na parte inferior direita, e na vista móvel, no canto inferior esquerdo da sua loja. Se pretender alterar esta posição, pode fazê-lo de várias formas:
  - Clique no menu suspenso "Posicionamento para utilizadores de dispositivos de secretária" (). Isto permite-lhe decidir se pretende que o Trustbadge seja apresentado na vista do ambiente de trabalho à direita ou à esquerda.
  - Clique no menu suspenso "Posicionamento para utilizadores móveis" (). Isto permite-lhe decidir se pretende que o Trustbadge seja apresentado na vista móvel à direita ou à esquerda.
  - Introduza um número de píxéis nos campos de introdução "Deslocar para cima para" (). Assim, na respetiva vista, pode mover o Trustbadge para cima, para o número de píxeis pretendido.
- Selecione "Editar o código de integração" (). Neste caso, pode processar manualmente o código Trustbadge.

O processamento manual do código oferece-lhe mais possibilidades de adaptar a integração e a exibição do Trustbadge na sua loja de forma ainda mais personalizada às suas necessidades. Para tal, deverá ter conhecimentos avançados sobre a utilização do código. Neste artigo, vamos explicar-lhe todas as possibilidades de configuração que pode fazer através do código Trustbadge: Como posso adaptar o Trustbadge® às minhas necessidades?

Clique em "Guardar alterações" ().

Teste agora o funcionamento do seu Trustbadge. Para isso, efetue um pedido-teste na sua loja. Se, no final do seu pedido, aparecer o chamado Trustcard, terá integrado com sucesso o Trustbadge na sua loja, a Proteção ao Comprador estará ativa e as avaliações serão recolhidas.

Exibir na sua loja as avaliações da loja e do produto que foram recolhidas

Para exibir as avaliações recolhidas e a pontuação global na sua loja, tem à sua disposição inúmeros widgets. Os widgets podem ser ajustados individualmente e a seleção é constantemente ampliada.

Este artigo oferece-lhe uma vista geral de todos os widgets disponíveis: Como aparecem os widgets no meu site?
Tenha em atenção que os widgets previstos para a exibição de avaliações do produto só estão disponíveis se tiver marcado as avaliações do produto.

Abra o separador "Widgets" no plug-in.

Se já estiverem configurados widgets para o canal de venda selecionado, estes serão exibidos na caixa "Widgets atuais". Se ainda não tiver configurado widgets, a caixa apresenta-se vazia.

Clique em "Crie um novo widget". É aberta uma janela pop-up.
Clique em "Ir para eTrusted" e inicie sessão no Centro de Controlo eTrusted. Aparece a biblioteca de widgets do Centro de Controlo eTrusted.
Selecione um widget e clique no botão "Criado" correspondente. É apresentada a vista geral da configuração do widget.
Configure o widget de acordo com as suas preferências. De seguida, clique em "Criar código de widget".
Volte ao plug-in. Clique em "Reload list". O widget que acabou de ser gerado está agora listado na caixa "Widgets atuais".

Não há widgets listados na sua caixa? Então verifique através do menu suspenso "Canal selecionado" no canto superior esquerdo se foi selecionado o canal de venda correto.

Utilize o menu suspenso "Selecione uma localização" () para determinar em que páginas e em que posição na sua loja deve aparecer o widget.
Está a configurar um widget de avaliação do produto? Em caso afirmativo, utilize também o menu suspenso "ID do produto" () para determinar que identificador de produto deve o widget utilizar para identificar o produto.

Pretende visualizar o widget antes de o integrar na sua loja? Então, passe o cursor sobre o símbolo do olho (

) para obter uma imagem exemplificativa do widget.

Clique em "Guardar alterações".

Desta forma, integrou com sucesso o widget na sua loja.

Na caixa "Widgets atuais" são-lhe disponibilizadas várias informações sobre os seus widgets. Para lhe facilitar o trabalho com as informações, explicamos na imagem seguinte, bem como numa tabela, a organização da caixa.

Enviar convites de avaliação de modo otimizado

Ajustar a data de envio do convite de avaliação

Depois de ativar o Trustbadge, as opiniões são recolhidas automaticamente. Ao utilizar o plug-in, tem a opção de adaptar às suas necessidades o momento de envio dos convites de avaliação. Associe o tempo de envio a um dos estados de pedido guardados no sistema da sua loja.

Para touchpoints fora do "Checkout", você deve garantir que todos os destinatários tenham consentido que os seus endereços de e-mail sejam transmitido à Trusted Shops para eles poderem receber um lembrete para realizar uma avaliação. Para mais informações, clique aqui: Consentimento para Recordatório de Avaliação online

Dentro do plugin, abra o separador "Convites de avaliação" ().
Desloque-se até à área "Envie convites para avaliações na altura certa para obter mais e melhores avaliações".
Utilize o menu pendente "Comentários sobre o serviço" () para selecionar o estado do pedido a que pretende associar a hora de envio dos seus convites de avaliação do serviço.
Utilize o menu pendente "Comentários de produtos" () para selecionar o estado do pedido a que pretende associar a hora de envio dos seus convites de avaliação do produto.

Para poder recolher Avaliações do Produto, tem de as agendar primeiro. Clique em "contacte a nossa equipa de vendas" (

) se quiser reservar avaliações do produto.

Clique em "Guardar" ().

Associou agora com sucesso a hora de envio a um estado do pedido.

Assim que o estado do pedido for atingido, é iniciado um atraso de envio. A duração do atraso de envio baseia-se nos dados da Trusted Shops para o tempo de envio ideal. Uma vez decorrido o atraso de envio, é enviado o convite de avaliação.

Pretende decidir quanto tempo deve decorrer entre o estado do pedido e o envio do convite de avaliação? Em seguida, crie uma regra de convites no Centro de Controlo da eTrusted. Este artigo pode ajudar: Como envio convites automáticos aos meus clientes?

Enviar convites de avaliação manuais

Se não quiser recolher as suas avaliações de forma automatizada ou se, para além do envio de convite automatizado pretender também convidar manualmente os clientes a submeterem uma avaliação, poderá utilizar o Compilador de Avaliações. Para tal, precisa de um ficheiro CSV com os dados do cliente para o qual pretende enviar convites de avaliação. Pode criar este ficheiro CSV utilizando o plug-in.

Abra o separador "Convites de avaliação" no plug-in.
Role para a área "Envie os convites de avaliação relativamente a pedidos anteriores".
Utilize a caixa de seleção "Exportação pedidos" () para determinar o momento em que serão exportados os dados do pedido.
Também pretende recolher avaliações de produto manualmente? Então, o ficheiro CSV deve incluir dados sobre os produtos encomendados. Para o fazer, coloque o interruptor "Include product data" () em verde.
De seguida, clique em "Exportação" (). O ficheiro CSV é descarregado.
Mude para o Centro de Controlo eTrusted.
Utilize o Compilador de Avaliações por meio deste artigo: O que é o Review Collector?

Outras opções de ajuste

Associar canais de venda ao eTrusted

Abra o separador "Ajustes" no plug-in.
Role para a área "Ajustes do canal".
Associe os seus canais de venda (p. ex., lojas com diferentes idiomas) ao respetivo canal eTrusted através dos menus suspensos ().
Clique em "Guardar alterações".

Anular a associação a Trusted Shops

Se anular a associação entre o seu sistema de loja e a Trusted Shops, todas as configurações serão perdidas. Não poderá reverter a eliminação.

Abra o separador "Ajustes" no plug-in.
Role para a área "Separar Trusted Shops".
Clique em "Desligar ligação".

Problemas de integração?

Nesta secção encontrará soluções para possíveis problemas com a configuração do seu plugin.

Quero mudar a minha loja para um novo domínio. O que devo ter em conta?

Se mudar a sua loja para um novo domínio, tem de configurar a variável de ambiente APP_URL para que a loja permaneça acessível a plug-ins externos. Só assim o nosso plug-in pode continuar a trocar dados com a sua loja e a funcionar.

Efetuar a mudança de domínio.
Iniciar sessão no Shopware Backend.
O Shopware reconhece automaticamente que o domínio foi alterado. É aberta uma janela pop-up "Domain change detected".
Selecionar uma das opções disponíveis ().

Se selecionar a opção "Copy apps to current domain", a sua loja receberá um novo ID de loja. Desta forma, os dados associados ao ID de loja antigo já não podem ser consultados. As aplicações já instaladas continuam a funcionar na instância antiga.

Clicar em « Confirm » ().

Deste modo, o APP_URL foi configurado com sucesso. O plug-in continua a funcionar corretamente.

Se ignorar ou fechar a janela pop-up "Domain change detected", o APP_URL permanece inalterado. Nesse caso, o plug-in não pode trocar dados com o novo domínio – o Trustbadge não é exibido, os seus clientes não podem contratar Proteção ao Comprador e não recebem um convite de avaliação. Aqui pode saber como resolver este problema posteriormente: O meu plug-in deixou de funcionar após uma mudança de domínio. O que deverei fazer?

O meu plug-in deixou de funcionar após uma mudança de domínio. O que deverei fazer?

O Shopware guarda o seu URL da loja atual na variável de ambiente APP_URL. Através desta variável, o nosso plug-in troca dados com o Shopware para que os seus produtos reservados funcionem.

Se mudar a sua loja para um novo domínio, o Shopware exibe o pop-up "Domain change detected" no Backend.

Se ignorar este pop-up ou o fechar, o APP_URL permanece inalterado. Nesse caso, o plug-in não poderá trocar dados com o novo domínio. Deste modo, o Trustbadge não é exibido, os seus clientes não podem contratar Proteção ao Comprador et n não recebem um convite de avaliação.

Atualizar o APP_URL posteriormente

Abrir o Shopware Backend.
Abrir o painel de comando e executar o seguinte comando:
```
bin/console app:url-change:resolve
```
Uma vista geral das opções disponíveis é exibida. Selecionar uma das opções. Executar o comando correspondente no painel de comando.

Se selecionar a opção "reinstall-apps", a sua loja receberá um novo ID de loja. Desta forma, os dados associados ao ID de loja antigo já não podem ser consultados. As aplicações já instaladas continuam a funcionar na instância antiga.

Deste modo, o APP_URL foi atualizado com sucesso. O seu plug-in volta a funcionar corretamente.

No plug-in só vejo um ecrã de carregamento. O que deverei fazer?

Se o plug-in exibir apenas um ecrã de carregamento, isso pode ter várias causas. Para delimitar o problema, os passos abaixo devem ser seguidos.

Passo 1: Recarregar página e verificar mensagem de erro

Recarregar a página se o ecrã de carregamento for exibido durante mais de 30 segundos.
Verificar se é exibida uma das seguintes mensagens de erro. Neste caso, clicar no respetivo link:
- App registration for "TrustedShopsEasyIntegrationS6" failed: Already existing Shop ID. Please ensure each environment uses a unique Shop ID and reinstall the app afterwards.
- Something went wrong. The provided shop signature is not valid. One of the reasons could be that your APP_URL in the Shopware .env is wrong.
É exibida outra mensagem de erro ou novamente o ecrã de carregamento? Então, prosseguir para o passo 2.

Passo 2: Fornecer informações para análise

Para resolver rapidamente o seu problema, precisamos do seguinte:

URL de administração do seu Shopware Backend
Captura de ecrã do painel de comando do navegador assim que o ecrã de carregamento ou a mensagem de erro for exibido(a)
Valor do APP_URL do seu ficheiro .env ou .env.local
Captura de ecrã da entrada da base de dados do URL na coluna core.app.shopId na base de dados system_config

Executar os seguintes passos para fornecer as informações:

Copiar o URL completo da barra de endereços do seu navegador para obter o URL de administração do seu Shopware Backend..
Clicar em "F12" no teclado. Em seguida, abrir o separador "Consola" para abrir o painel de comando do navegador. Criar uma captura de ecrã.
Abrir o diretório raiz da sua instalação de Shopware através de FTP ou do Hosting Manager. Abrir o ficheiro .env ou .env.local. Copiar o valor que está atrás de APP_URL.
Abrir a sua base de dados Shopware. Abrir a base de dados "system_config". Abrir a entrada da base de dados da coluna "core.app.shopId". Criar uma captura de ecrã.

Caso não esteja familiarizado com o acesso à base de dados, pedir ajuda à respetiva equipa de TI.

Assim, todas as informações foram fornecidas. Prosseguir agora para o passo 3.

Passo 3: Transmitir informações à Trusted Shops

Reunir todas as informações fornecidas no passo 2 num único correio eletrónico.
Enviar o correio eletrónico para members@trustedshops.com.

Assim, todas as informações foram submetidas com sucesso. A nossa equipa de apoio analisará o seu problema e irá entrar em contacto com uma solução adequada.

Recebo a mensagem de erro durante a instalação "App registration for "TrustedShopsEasyIntegrationS6" failed: Already existing Shop ID. Please ensure each environment uses a unique Shop ID and reinstall the app afterwards.". O que posso fazer?

Esta mensagem de erro indica que a sua loja está a utilizar o mesmo ID de loja de outra instância.

Cada instância de Shopware recebe um ID de loja inequívoco durante a instalação, através do qual é identificada. Se vários ambientes (por exemplo, Live/Staging ou após a mudança de domínio) utilizarem o mesmo ID de loja, o plug-in não pode ser registado corretamente.

Para que o seu plug-in possa ser instalado corretamente, cada uma das suas lojas precisa de um ID de loja próprio. Para resolver o problema, seguir os passos abaixo:

Abrir a sua base de dados Shopware, por exemplo, com o plug-in Adminer ou a ferramenta de base de dados do seu Hosting.
Abrir a base de dados "system_config". Com a ajuda das entradas da base de dados na coluna "core.app.shopId", verificar se várias instâncias utilizam o mesmo ID de loja.
Garantir que cada instância de Shopware utiliza um ID de loja próprio. Para o efeito, utilizar estas instruções de Shopware: Handling the migration of shops

Caso não esteja familiarizado com os passos descritos aí, pedir ajuda à respetiva equipa de TI.

Desinstalar o plug-in.
Reinstalar o plug-in.

Deste modo, o plug-in foi instalado com sucesso. A configuração do plug-in deve agora ser possível sem problemas.

A instalação continua a falhar? Então é preciso enviar-nos um correio eletrónico com as informações aqui listadas para members@trustedshops.com.

Recebo a mensagem de erro durante a configuração do plug-in "Something went wrong. The provided shop signature is not valid. One of the reasons could be that your APP_URL in the Shopware .env is wrong.". O que posso fazer?

Esta mensagem de erro indica que a sua loja está a utilizar o mesmo ID de loja de outra instância.

Para poder configurar corretamente o seu plug-in, cada uma das suas lojas precisa de um ID de loja próprio. Para resolver o problema, seguir os passos abaixo:

Abrir a sua base de dados Shopware, por exemplo, com o plug-in Adminer ou a ferramenta de base de dados do seu Hosting.
Abrir a base de dados "system_config". Com a ajuda das entradas da base de dados na coluna "core.app.shopId", verificar se várias instâncias utilizam o mesmo ID de loja.
Garantir que cada instância de Shopware utiliza um ID de loja próprio. Para o efeito, utilizar estas instruções de Shopware: Handling the migration of shops

Caso não esteja familiarizado com os passos descritos aí, pedir ajuda à respetiva equipa de TI.

Desinstalar o plug-in.
Reinstalar o plug-in.

Deste modo, o plug-in foi instalado com sucesso. A configuração do plug-in deve agora ser possível sem problemas.

A instalação continua a falhar? Então é preciso enviar-nos um correio eletrónico com as informações aqui listadas para members@trustedshops.com.

Tenho uma pergunta que não é mencionada aqui. A quem me posso dirigir?

A Equipa de Sucesso do Cliente irá apoiá-lo se não conseguir avançar na integração. Para o efeito, são necessários dois passos:

Determinar o número da versão
Contactar a Equipa de Sucesso do Cliente

Passo 1: Determinar o número da versão

Para que possamos ajudá-lo de forma rápida e direcionada, a Equipa de Sucesso do Cliente precisa das seguintes informações:

Número da versão do seu sistema de loja
Número da versão do plugin Trusted Shops

Como encontrar o número da versão do seu sistema de loja

Iniciar sessão no Shopware 6 Backend.
O número da versão encontra-se acima da navegação principal, no lado superior esquerdo.

Como encontrar o número da versão do plugin Trusted Shops

Iniciar sessão no Shopware 6 Backend.
Clique em "Extensions" () na navegação principal. Depois, clique "My extensions" ().
É exibida a vista geral "My extensions". O número da versão encontra-se no lado direito da entrada "Trusted Shops Easy Integration for Shopware 6".

Passo 2: Contactar a Equipa de Sucesso do Cliente

Assim que tiver identificado os números da versão, pode contactar a equipa de Customer Success. Indique os dois números da versão diretamente no seu pedido.

Como contactar a equipa:

E-mail: members@trustedshops.com
Telefone: +49 221 775 367 013