Introdução à Shopware

O que você vai aprender

Saiba como fazer a integração com a Shopware 6 para transferir dados de atividade do site, pedidos, catálogos e assinante para a Klaviyo.

Antes de começar

Observe o seguinte:

• Antes de fazer a integração, verifique se você está conectado à conta Klaviyo que deseja integrar.
• A integração com o Shopware 6 é compatível com o Klaviyo por meio de um fornecedor terceirizado. Se você precisar entrar em contato com o suporte, consulte a seção abaixo sobre como fazer isso.

Adicione o plugin à sua conta da Shopware

1. Acesse a página do plugin da Klaviyo na Shopware Store.
2. Faça login quando solicitado e selecione Adicionar ao carrinho.
3. Continue para fazer o checkout e concluir seu pedido.
4. Depois que o pedido for confirmado, clique na opção para acessar sua conta da Shopware.
5. Em sua conta da Shopware, navegue até Comerciante > Lojas.
6. Selecione a loja onde você comprou o plugin.
7. Na seção Licenças, localize o plugin da Klaviyo e abra a página de detalhes do plugin.

Baixe e instale a extensão

Você pode instalar por meio de um de dois métodos: via Composer ou por meio do download da nossa extensão. Depois de selecionar um método de instalação, você deve usar esse mesmo método sempre que atualizar.

Instale com o Composer

Ao instalar via Composer, é preciso especificar a versão da extensão da Klaviyo; nem todas as extensões funcionam para todas as versões da Shopware.

Você está usando uma versão da Shopware entre 6.4.4.0 e 6.4.XX.XX? Execute o comando com a seguinte versão de extensão:

composer require klaviyo/shopware-klaviyo:1.24.0

Você está usando uma versão da Shopware entre 6.5.0.0 e 6.5.XX.XX? Execute o comando com a seguinte versão de extensão:

composer require klaviyo/shopware-klaviyo:2.24.0

Você está usando uma versão da Shopware entre 6.6.0.0 e 6.6.XX.XX? Execute o comando com a seguinte versão de extensão:

composer require klaviyo/shopware-klaviyo:3.8.0

Você está usando o Shopware versão 6.7.0.0 ou superior? Execute o comando com a seguinte versão de extensão:

composter require klaviyo/shopware-klaviyo:4.4.0

Instalar via upload

1. Abra a página de detalhes do plugin e baixe a versão mais recente disponível (ou qualquer versão necessária):
   
   • Você está usando uma versão do Shopware entre 6.4.4.0 e 6.4.XX.XX? Baixe a versão 1.24.0 da extensão da Klaviyo.
   • Você está usando uma versão do Shopware entre 6.5.0.0 e 6.5.XX.XX? Baixe a versão 2.24.0 da extensão da Klaviyo.
   • Você está usando uma versão do Shopware entre 6.6.0.0 e 6.6.XX.XX? Baixe a versão 3.8.0 da extensão da Klaviyo.
   • Você está usando a versão 6.7.0.0 do Shopware ou superior? Baixe a versão 4.4.0 da extensão da Klaviyo.
2. Entre na sua conta de administrador da Shopware para acessar a loja que deseja integrar.
3. Clique em Extensões > Minhas extensões.
4. Clique em Upload extension e selecione o arquivo ZIP que você baixou de sua conta da Shopware. Você pode ver uma mensagem de aviso durante o upload. Clique em Confirmar para continuar.
   

5. Quando a extensão aparecer na sua lista de extensões, clique em Instalar.
   

6. Ativar a extensão da Klaviyo.
   

Configure a extensão na Shopware

1. No admin da loja da Shopware, navegue até Configurações e clique na aba Extensões .
2. Selecione Klaviyo. Você será levado para a página de configurações de extensão da Klaviyo.
3. Em Canais de vendas, selecione o canal de vendas que deseja integrar com a Klaviyo no menu suspenso. Integre apenas um canal de vendas com a Klaviyo por loja da Shopware. Você também deve definir suas configurações para cada canal de vendas individualmente.
4. Em Configurações de interação, selecione a ferramenta de consentimento de cookies que deseja usar com essa integração. Os visitantes que não aceitarem cookies da Klaviyo não serão rastreados pela Klaviyo, nem poderão visualizar formulários da Klaviyo. As opções da ferramenta de consentimento de cookies são:
   • Nada
     Se essa opção for selecionada, a Klaviyo terá acesso gratuito aos cookies da loja.
   • Padrão da Shopware
     Se essa opção for selecionada, o gerenciamento de cookies será implementado por meio do método padrão do Shopware, desde que esteja ativado. Para ativá-lo, navegue até Settings > Shop > Basic information, localize a seção Security and Privacy e, em seguida, ative Use Default Cookie Notification.
   • CookieBot
     Se essa opção for selecionada, o gerenciamento de cookies será implementado pelo CookieBot. Se quiser selecionar o CookieBot, é preciso tê-lo instalado na sua loja da Shopware.
   • Gerenciador de Consentimento
   • Se essa opção for selecionada, o gerenciamento de consentimento será implementado por meio do Gerenciador de Consentimentos. Se quiser selecionar o Gerenciador de consentimento, é preciso tê-lo instalado na sua loja da Shopware.
   • CMP do Usercentrics
     Se essa opção for selecionada, o gerenciamento de consentimento será implementado por meio do CMP do Usercentrics. Se quiser selecionar o CMP do Usercentrics, é preciso tê-lo instalado na sua loja da Shopware.
5. Se você não usa uma ferramenta de gerenciamento de cookies (que já bloqueia o carregamento do script da Klaviyo) e deseja acelerar o carregamento da página, ative a configuração Initialize Klaviyo After First Interaction With Page. Isso habilitará o seguinte comportamento:
   • Depois que o cliente começar a interagir com a página, os scripts da Klaviyo serão inicializados.
   • Nas transições de página subsequentes, os scripts serão inicializados imediatamente.
     

6. Para continuar, obtenha suas chaves de API públicas e privadas da Klaviyo. Para isso, abra uma nova aba e faça login na conta Klaviyo que deseja integrar com a Shopware.
   1. Clique no nome da sua conta no canto inferior esquerdo e selecione Configurações.
   2. Selecione as chaves de API.
   3. Clique em Criar chave de API privada. Dê um nome à chave "Integração com a Shopware", selecione Chave de acesso total e clique em Criar. Na página seguinte, clique em Copiar chave.
   4. Cole a chave de API privada na configuração correspondente na Shopware.
   5. Na Klaviyo, clique em Concluído. Em seguida, copie sua chave de API pública da página.
   6. Cole a chave de API pública no Shopware na caixa correspondente.
7. Em seguida, escolha uma lista da Klaviyo no menu suspenso para perfis que se inscrevem por meio de um formulário da Shopware a ser adicionado.
   

1. Selecione um identificador a ser usado para o mapeamento de campo da variante de Reposição de Estoque. Você deve usar o identificador que corresponde ao que você usa no seu catálogo.
2. Ative todas as métricas que deseja sincronizar da Shopware para a Klaviyo.
   

3. Se optar por rastrear a reposição de estoque, você poderá personalizar a cor do texto e o plano de fundo do botão de abertura do pop-up de reposição de estoque, do botão de fechamento do pop-up e do botão de inscrição. Clique no quadrado e, em seguida, use o seletor para escolher uma cor ou, se você tiver os códigos de cores hexadecimais para as cores da sua marca, cole-os na caixa correspondente.
   

4. Em Nomes de snippet, você encontrará uma referência sobre como se referir a diferentes componentes de reposição de estoque em HTML. Você pode optar por personalizá-los no código do seu site.
   

5. Mapeamento de campo personalizado: aqui, você verá os campos personalizados que configurou na Shopware (com o nome técnico em cinza). Qualquer campo atribuído ao objeto Cliente pode ser sincronizado com a Klaviyo. Para sincronizar esses campos personalizados com os perfis da Klaviyo, alterne o campo individual para Ativo. Em seguida, em Nome do campo, digite o nome correspondente que você gostaria que o campo tivesse na Klaviyo.
   

6. Quando terminar, clique em Salvar.
7. Para executar uma sincronização de eventos históricos, clique em Sincronizar eventos históricos na parte superior da página.
8. Para executar uma sincronização de assinantes existentes, clique em Sincronizar assinantes na parte superior da página.

Sincronizar seu feed de catálogo

Para concluir sua integração com a Klaviyo, é preciso gerar um feed do seu catálogo de produtos e, em seguida, sincronizá-lo com a Klaviyo. Para gerar o feed:

1. Entre na sua loja Shopware admin.
2. Clique em + ao lado de Canais de vendas para adicionar um novo canal.
3. Ao lado de Comparação de produtos, clique em Adicionar canal de vendas.
4. Em Modelo, escolha Klaviyo XML.
5. Dê um nome ao canal, como Klaviyo Export.
6. Em Cobrança de impostos, selecione Cálculo linha por linha (horizontal).
7. Em Storefront Sales Channel:
   • Selecione o Canal de Vendas de Vitrine para o qual esse catálogo se destina.
   • Selecione o domínio Storefront.
   • Selecione a moeda.
   • Selecione o idioma.
   • Selecione o Grupo de Clientes.
8. Em Exportação de produtos:
   • Dê um nome ao arquivo (por exemplo, klaviyo.xml).
   • Selecione a codificação UTF-8.
   • Selecione o formato de arquivo XML.
9. Deixe as variantes de Exportação como produtos discretos desativados.
10. Selecione o intervalo: 1 dia.
11. Deixar Gerar via agendador desativado.
12. Selecione seu grupo de produtos dinâmico.
13. Em Status, ative Ativo.
14. Clique em Save no canto superior direito.
15. Role a tela para baixo e copie o URL de exportação, que será usado para a sincronização da Klaviyo.
16. Agora que o feed foi gerado, você precisa sincronizá-lo com a Klaviyo. Siga as instruções para sincronizar um feed de catálogo personalizado com a Klaviyo.

Dados sincronizados da Shopware

Para saber tudo sobre os dados sincronizados do Shopware e como acessá-los no Klaviyo, leia nossa referência de dados do Shopware.

Formulários de registro da Klaviyo

Você pode adicionar formulários de registro da Klaviyo à sua loja Shopware para coletar assinantes. Observe que apenas visitantes do site que aceitarem os cookies da Klaviyo poderão ver os formulários de registro da Klaviyo.

Como entrar em contato com o suporte

A integração do Klaviyo com o Shopware 6 é compatível e suportada pelo Klaviyo por meio de um terceiro. Se você tiver dúvidas sobre as integrações e precisar de suporte, entre em contato com o suporte específico para integrações preenchendo nosso formulário.

Se você precisar de suporte geral para dúvidas relacionadas ao Klaviyo, entre em contato com o suporte do Klaviyo.

Resultado

Você integrou o Shopware 6 à Klaviyo para trazer a atividade do site, pedidos, catálogo e dados de assinantes para a Klaviyo. Agora você pode começar a usar a Klaviyo para suas próprias necessidades de marketing.

Recursos adicionais