Se o seu eCommerce foi desenvolvido no Magento, você pode integrá-lo facilmente com o Connectif e começar a coletar dados de seus clientes para criar suas campanhas.
Neste artigo, você aprenderá como instalar e configurar o módulo Connectif para Magento 2.
Dificuldade: Avançada (requer conhecimentos técnicos).
Quando utilizá-lo?: Ao abrir sua conta no Connectif.
PASSO 1. Download e instalação do módulo Magento 2
Dependendo da versão do Magento que seu eCommerce utiliza, você deve seguir etapas diferentes:
- Se você tiver uma versão anterior ao Magento 2.2, revise a seção A deste passo.
- Se você tiver uma versão posterior ao Magento 2.2, revise a seção B deste passo.
A. Versões anteriores ao Magento 2.2
A.1. Baixar o módulo
1. Acesse sua conta Connectif.
2. Vá para Integrações no menu lateral esquerdo.
3. Na seção ERPs e CRMs, encontre Magento e clique em Editar.
4. Na seção Configuração, clique em Baixar Módulo Magento 2 para baixar o arquivo “connectif.zip” no seu computador.
A.2. Copiar a pasta Connectif para a instalação do Magento
5. Copie a pasta "Connectif" e todo o seu conteúdo para dentro da pasta "/app/code/", localizada na raiz da instalação do Magento 2.
Caso a pasta "/app/code/" não exista, ela deve ser criada.
Por exemplo, se o caminho de instalação do Magento 2 for "/var/www/html", você deve copiar a pasta "Connectif" para "/var/www/html/app/code/Connectif".
A.3. Instalar o módulo
6. Acesse o painel de administração do Magento 2 e vá para "System > Web Setup Wizard".
O Setup Wizard foi removido a partir da versão 2.4.0 do Magento. Portanto, você precisará habilitar a integração via comandos, disponíveis na seção 2b da documentação de instalação incluída no arquivo "connectif.zip" baixado no passo 2. Para mais informações, consulte a documentação do Magento.
7. No Gerenciador de Módulos, localize o módulo Connectif_Integration e selecione Ativar.
8. Siga as etapas indicadas durante a instalação do módulo Connectif e clique em Próximo:
- Verificação de Prontidão: nesta etapa, são feitas verificações relacionadas à versão do PHP, crons, dependências e extensões.
- Backup: nesta etapa, é feito um backup do eCommerce antes da instalação do módulo.
- Habilitar módulo: nesta etapa, o módulo é ativado.
B. Versões posteriores ao Magento 2.2
B.1. Baixar o módulo
9. Acesse sua conta Connectif.
10. Vá para Integrações no menu lateral esquerdo.
11. Na seção ERPs e CRMs, encontre Magento e clique em Editar.
12. Na seção Configuração, clique em Baixar Módulo Magento 2 para baixar o arquivo “connectif.zip” no seu computador.
B.2. Copiar a pasta Connectif para a instalação do Magento
13. Faça login na loja Magento 2.x por meio de uma conexão SSH.
14. Após um login SSH bem-sucedido, usando a linha de comando (shell), navegue até o diretório raiz do Magento onde o Magento 2 está instalado.
15. Carregue o módulo (como Zip ou tar.gz) no diretório raiz da instalação do Magento 2.
16. Descompacte o arquivo em um diretório temporário.
17. O local para copiar o módulo descompactado deve ser “app/code/Connectif/”. Crie essa pasta com o seguinte comando:
mkdir –p app/code/Connectif/
18. Copie o conteúdo da pasta descompactada para a pasta criada no passo anterior:
cp -R Connectif/* app/code/Connectif/
19. Execute o comando de instalação do Magento 2 a partir da raiz:
php bin/magento setup:upgrade
20. Compile o módulo instalado com:
php bin/magento setup:di:compile
21. Limpe o cache com:
php bin/magento cache:flush
O módulo será instalado e visível em Stores > Configuration > Advanced > Advanced. O módulo aparecerá nesta seção na lista de módulos instalados do Magento.
PASSO 2. Ativação do módulo
Esta configuração é a mesma para versões anteriores e posteriores ao Magento 2.2.
22. Vá para "Stores > Configuration > " e localize a configuração do Connectif.
23. Na seção Configuração Básica, selecione a opção Yes no campo Ativar, para poder preencher as opções Client ID e Secret Key.
Não feche esta aba, você precisará dela para completar os dados da sua conta.
24. Acesse sua conta Connectif e, na seção "Integrações > Magento", copie o Client ID e a Secret Key.
25. Volte ao Magento 2 e cole-os nos campos correspondentes.
26. Clique em "Salvar Configuração" para salvar as alterações.
Sucesso!
Sua integração do Connectif com o Magento está pronta.
Após finalizar a configuração do plugin, é recomendável verificar a integração. Veja como fazer isso neste artigo.
Perguntas Frequentes
Tem dúvidas sobre o módulo Connectif no Magento? Aqui você encontra informações úteis:
1. Para que serve cada seção do módulo Connectif no Magento?
O módulo Connectif no Magento possui diferentes seções, cada uma com funções específicas:
- Configuração Básica (1): essa seção serve para configurar os aspectos básicos da sua conta Connectif no Magento, documentados neste artigo, permitindo que você inicie sua estratégia.
- Banners (2): essa seção está em desuso, pois os conteúdos em formato de banner são configurados diretamente no Connectif.
Os conteúdos tipo "Janela Modal" e "Banners" estão em desuso desde 2021. Veja neste artigo como migrá-los para o Connectif.
- URLs Públicas (3): essa seção é usada para consultar as URLs de ativação do ServiceWorker e das notificações de inscrição.
Essas URLs são geradas e comunicadas ao Connectif quando o módulo é instalado no Magento.
-
Configuração Avançada (4): essa seção define determinados comportamentos na integração com o Connectif:
- Exibir apenas campos obrigatórios nas tags do carrinho?: essa opção define se o script do Connectif coletará apenas os campos obrigatórios do carrinho (ID do produto, nome, preço e URL). Esta opção melhora o desempenho da tag do carrinho no Magento.
- Usar variantes de produto no carrinho e nas compras?: essa opção define se o Connectif coletará o produto padrão ou a variante específica ao receber informações dos produtos no carrinho.
- ID da imagem do produto: define o tamanho da imagem que o Connectif coletará.
- Notificar compras offline: define se o eCommerce notificará o Connectif das compras offline via API, sem contexto web.
- Status do Pedido: define o status que os pedidos devem ter para serem registrados via API (notificações offline) no Connectif.
2. Como ativar a notificação de compras offline (via API)?
Notificar compras offline significa que elas não têm contexto web, pois a notificação é feita via API, de forma assíncrona. Se existir alguma estratégia que reage à compra com conteúdo web, ela não impactará os contatos cujas compras sejam registradas por meio da API.
1. Na sua conta do Magento, vá para "Stores > Configuration", clique em Connectif e depois em Settings.
2. Desative o módulo Connectif na seção "Basic Configuration > Activate", selecionando a opção No.
3. Clique em Save Config.
É necessário salvar a configuração imediatamente após essa etapa para habilitar as compras offline.
4. Vá até "Configuração Avançada > Notificar compras offline" e selecione a opção Yes.
5. Em "Order Status", escolha o status que os pedidos devem ter para serem registrados offline no Connectif.
O status selecionado dependerá do método de pagamento, da configuração do Magento e do modelo de negócio. Apenas um status pode ser selecionado.
6. Ative novamente o módulo Connectif na seção "Basic Configuration > Activate", selecionando a opção Yes.
7. Clique em Save Config.
3. Como configurar o Connectif em uma loja multilingue no Magento?
O Magento permite a criação de três níveis de entidades em uma conta:
- Website: geralmente apenas um, que corresponde ao domínio.
- Store: as diferentes lojas, por exemplo, por idioma.
- Store view: detalhes adicionais das lojas, como o mesmo idioma com uma moeda diferente.
O módulo Connectif pode ser configurado em qualquer um desses níveis de acordo com as necessidades do eCommerce, mas alguns aspectos devem ser considerados:
- Os tipos de configuração do Magento, pois uma configuração em "Default" se aplica a todos os níveis do Magento.
-
Para enviar dados de diferentes níveis do Magento para a mesma loja no Connectif, o mesmo Client ID e Secret Key devem ser usados na configuração.
- Recomenda-se, exceto em casos muito complexos, ativar a configuração padrão no momento da integração, para configurar todos os níveis igualmente.
Se você tiver vários idiomas e/ou moedas a serem configurados, é comum fazer os ajustes no nível Store View separadamente.
4. Como recuperar carrinhos abandonados com a URL de Recuperação de Carrinho
(Esta seção explica como a URL de Recuperação de Carrinho funciona para recuperar itens associados a um carrinho específico).
Através da integração com o Magento, o Connectif fornece uma URL de Recuperação de Carrinho, um link que pode ser usado para recuperar itens relacionados ao carrinho e ser usado em fluxos de trabalho e conteúdos.
Para obter a URL de recuperação de carrinho por meio de um fluxo de trabalho, use os nós "Obter último carrinho" e "Ao abandonar carrinho", e depois mapeie-a nas variáveis do conteúdo a ser exibido ou enviado.
- Saiba como essa URL funciona em diferentes CMS e como utilizá-la neste artigo.
Continue aprendendo!
Para aproveitar ao máximo sua conta Connectif, recomendamos continuar com os seguintes artigos:
-
Onboarding, para se familiarizar com nossa interface.
-
Workflows iniciais, para implementar suas primeiras estratégias na conta.
-
Integrações com sistemas externos, para integrar com Facebook, formulários e webhooks no seu site.
-
Integrações via API, para gerenciar eventos como registros de compras ou novos contatos.