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.
5. Como coletar a marca dos produtos no Magento
Para coletar o campo "Marca" na ficha de produto do Connectif na integração com o Magento, é necessário ativar o campo "Manufacturer" do Magento e fornecer os valores correspondentes, para que ele seja transmitido automaticamente.
Esse campo não vem ativado por padrão no Magento, portanto, para ativá-lo, siga os seguintes passos:
1. Vá até a seção "Stores > Attributes > Attribute Set".
2. Localize o grupo de atributos "Default".
3. Dê um duplo clique para acessar a edição e, uma vez dentro, adicione o campo "manufacturer" à pasta "Product Details", clicando sobre ele e arrastando-o para dentro da pasta.
4. Clique em Salvar para confirmar esta configuração. Dessa forma, os dados do campo "manufacturer" serão sempre transmitidos nos produtos que utilizarem este grupo de atributos.
Para que a marca seja transmitida automaticamente ao Connectif por meio deste processo, você deve tê-la criado dentro deste campo. Se foi feito por meio de outro campo, será necessário adaptá-lo a este procedimento.
5. Se você tiver outros grupos de atributos de produtos no seu catálogo dos quais queira transmitir a marca, será necessário repetir o processo.
6. Para garantir que o campo será transmitido nos diferentes grupos de produtos, você pode revisar qualquer produto do seu catálogo que esteja em um deles e verificar se o campo "manufacturer" está incluído na sua ficha do Magento. Dentro dela, você também poderá alterá-lo se necessário, utilizando o menu suspenso.
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.