Primeiros passos com o Shopware

O que você vai aprender

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

Antes de começar

Antes de fazer a integração, certifique-se de que:

• O senhor fez login na conta da Klaviyo que deseja integrar.

Faça o download e instale a extensão

O senhor pode instalar por meio de um destes dois métodos: via Composer ou baixando nossa extensão do Github e depois fazendo o upload para o Shopware. 

Instalar via Composer

Ao instalar via Composer, o senhor precisará especificar a versão da extensão do Klaviyo; nem todas as extensões funcionam para todas as versões do Shopware. 

O senhor está usando uma versão do Shopware entre 6.4.4.0 e 6.4.20.2? Execute o comando com a seguinte versão de extensão:

composer require Klaviyo/shopware-Klaviyo:1.13.2

O senhor está usando uma versão do Shopware entre 6.5.0.0 e 6.5.8.10? Execute o comando com a seguinte versão de extensão:

composer require Klaviyo/shopware-Klaviyo:2.15.2

O senhor está usando a versão 6.6.0.0 ou superior do Shopware? Execute o comando com a seguinte versão de extensão:

composer require Klaviyo/shopware-Klaviyo:3.2.2

Instalar via upload

1. Encontre a extensão gratuita do Klaviyo nestes links e clique no botão Download:
   
   • O senhor está usando uma versão do Shopware entre 6.4.4.0 e 6.4.20.2? Faça o download da extensão Klaviyo versão 1.13.2.
   • O senhor está usando uma versão do Shopware entre 6.5.0.0 e 6.5.8.10? Faça o download da extensão Klaviyo versão 2.15.2.
   • O senhor está usando a versão 6.6.0.0 ou superior do Shopware? Faça o download da extensão Klaviyo versão 3.2.2.
2. Faça login no seu administrador do Shopware para a loja que deseja integrar.
3. Clique em Extensions (Extensões) > My extensions (Minhas extensões).
4. Clique em Upload extension (Carregar extensão).
   
5. Selecione a extensão Klaviyo em seus arquivos.
6. Quando a extensão aparecer em sua lista de extensões, clique em Install (Instalar).
   
7. Ative a extensão do Klaviyo.
   

Configurar a extensão no Shopware

1. No administrador da loja Shopware, navegue até Settings (Configurações) e clique na guia Extensions (Extensões ).
2. Selecione Klaviyo. O senhor será levado à página de configurações da extensão Klaviyo.
3. Em Sales Channels (Canais de vendas), selecione no menu suspenso o canal de vendas que o senhor deseja integrar ao Klaviyo. Integrar apenas um canal de vendas com o Klaviyo por loja Shopware. O senhor também deve definir suas configurações para cada canal de vendas individualmente.
4. Em Interaction settings (Configurações de interação), selecione a ferramenta de consentimento cookie que o senhor gostaria de usar com essa integração. Observe que os visitantes que não aceitarem o cookie Klaviyo não serão rastreados pelo Klaviyo, nem poderão visualizar os formulários Klaviyo. As opções da ferramenta de consentimento cookie são:
   • Nada
     Se essa opção for selecionada, o site Klaviyo terá acesso livre ao cookie armazenar.
   • Padrão do Shopware
     Se essa opção for selecionada, o gerenciamento do cookie será implementado por meio do método padrão do Shopware, desde que esteja ativado. Para ativá-la, navegue até Settings > Shop > Basic information, localize a seção Security and Privacy e, em seguida, alterne para Use Default cookie Notification.
   • CookieBot
     Se essa opção for selecionada, o gerenciamento do cookie será implementado pelo CookieBot. Se desejar selecionar o CookieBot, o senhor já deve tê-lo instalado em seu armazenador Shopware.
   • Gerente de consentimento
   • Se essa opção for selecionada, o gerenciamento de consentimento será implementado por meio do Consent Manager. Se quiser selecionar o Consent Manager, o senhor já deve tê-lo instalado no seu armazenador Shopware.
   • CMP da Usercentrics
     Se essa opção for selecionada, o gerenciamento de consentimento será implementado por meio do CMP da Usercentrics. Se desejar selecionar o CMP da Usercentrics, o senhor já deve tê-lo instalado no seu armazenador Shopware.
5. Se o senhor não usar uma ferramenta de gerenciamento de cookies (que já impede o carregamento do script do Klaviyo) e quiser acelerar o tempo de carregamento da página, ative a configuração Initialize Klaviyo After First Interaction With Page (Inicializar o Klaviyo após a primeira interação com a página). Isso habilitará o seguinte comportamento:
   • Depois que o cliente começar a interagir com a página, os scripts do 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 guia e faça login na conta da Klaviyo que deseja integrar ao Shopware. 
   1. Clique no nome de sua conta no canto inferior esquerdo e selecione Settings (Configurações).
   2. Selecione as chaves de API.
   3. Clique em Create Private API Key. Dê um nome à chave, selecione Full Access Key e clique em Create. Na próxima página, clique em Copy Key (Copiar chave).
   4. Cole a chave de API privada na configuração correspondente no Shopware.
   5. De volta ao Klaviyo, clique em Done (Concluído). Em seguida, copie sua chave de API pública da página.
   6. Cole a chave pública da API no Shopware na caixa correspondente.
7. Em seguida, escolha uma lista do Klaviyo no menu suspenso para adicionar os perfis que se inscreveram por meio de um formulário do Shopware.
   
8. Selecione um identificador a ser usado para o mapeamento do campo de variantes de estoque. O senhor deve usar o identificador que corresponda ao que usa em seu catálogo.
9. Ative todas as métricas que você deseja sincronizar do Shopware para o Klaviyo.
   
10. Se o senhor optar por rastrear o Back in Stock, poderá personalizar a cor do texto e o plano de fundo do botão pop-up de abertura do Back in Stock, do botão pop-up de fechamento e do botão de assinatura. Clique no quadrado e use o seletor para escolher uma cor ou, se o senhor tiver os códigos de cores hexadecimais das cores da sua marca, cole-os na caixa correspondente.
    
11. Em Nomes de snippets, o senhor encontrará uma referência sobre como se referir a diferentes componentes do Back in Stock em HTML. O senhor pode optar por personalizá-los no código do seu site.
    
12. Mapeamento de campos personalizados: Aqui, o senhor verá os campos personalizados que configurou no Shopware (com o nome técnico em cinza). Qualquer campo atribuído ao objeto Customer pode ser sincronizado com o Klaviyo. Para sincronizar esses campos personalizados com os perfis do Klaviyo, alterne o campo individual para Active (Ativo). Em seguida, em Field Name (Nome do campo), digite o nome correspondente que o senhor gostaria que o campo tivesse no Klaviyo.
    
13. Quando terminar, clique em Save (Salvar). 
14. Para executar uma sincronização de eventos históricos, clique em Synchronize historical events (Sincronizar eventos históricos ) na parte superior da página. 
15. Para executar uma sincronização dos assinantes existentes, clique em Synchronize subscribers (Sincronizar assinantes ) na parte superior da página. 

Sincronizar o feed do catálogo

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

1. Faça login no administrador da loja Shopware.
2. Clique em + ao lado de Sales Channels (Canais de vendas ) para adicionar um novo canal.
3. Ao lado de Product comparison (Comparação de produtos ), clique em Add Sales Channel (Adicionar canal de vendas).
4. Em Template (Modelo), escolha Klaviyo XML.
5. Dê um nome ao canal, como Klaviyo Export.
6. Em Cobrança de impostos, selecione Cálculo linha a linha (horizontal).
7. Canal de vendas em vitrine:
   • Selecione o canal de vendas do Storefront para o qual esse catálogo se destina.
   • Selecione o domínio do Storefront.
   • Selecione a moeda.
   • Selecione o idioma.
   • Selecione o Grupo de clientes.
8. Em Exportação de produtos:
   • Nomeie o arquivo (por exemplo, klaviyo.xml).
   • Selecione a codificação UTF-8.
   • Selecione o formato de arquivo XML.
9. Deixe a opção Exportar variantes como produtos discretos desativada.
10. Selecione o intervalo: 1 dia.
11. Deixe a opção Gerar via agendador desativada. 
12. Selecione seu grupo de produtos dinâmicos.
13. Em Status, ative a opção Active (Ativo). 
14. Clique em Save (Salvar ) no canto superior direito.
15. Role para baixo e copie o Export URL, que será usado para a sincronização com o Klaviyo.
16. Agora que o feed foi gerado, o senhor deve sincronizá-lo com o Klaviyo. Siga as instruções para sincronizar um feed de catálogo personalizado com o Klaviyo.

Dados sincronizados do 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 inscrição no Klaviyo

O senhor pode adicionar formulários de inscrição do Klaviyo à sua loja Shopware para coletar assinantes. Observe que somente os visitantes do site que aceitarem os cookies da Klaviyo poderão ver os formulários de inscrição da Klaviyo. 

Como entrar em contato com o suporte

A integração do Klaviyo Shopware 6 é suportada pela Klaviyo por meio da Overdose Digital. Se o senhor tiver dúvidas sobre a integração e precisar de suporte, poderá entrar em contato com o suporte específico da integração preenchendo nosso formulário.

Se precisar de suporte geral para questões relacionadas ao Klaviyo, entre em contato com o suporte do Klaviyo.

Resultado

O senhor integrou o Shopware 6 ao Klaviyo para trazer os dados de atividade do site, pedidos, catálogos e assinantes para o Klaviyo. Agora o senhor pode começar a usar o Klaviyo para suas necessidades de marketing próprio.

Recursos adicionais

• Como sincronizar um feed de catálogo personalizado com o Klaviyo
• Referência de dados do Shopware 6