Se o seu eCommerce foi desenvolvido em Magento, você poderá integrá-lo facilmente com o Connectif e começar a coletar dados dos seus clientes para criar suas campanhas.
Neste artigo você aprenderá como instalar e configurar o módulo do Connectif para Magento 2.
Dificuldade: Avançada (requer conhecimentos técnicos).
Quando usar?: Ao abrir sua conta no Connectif.
PASSO 1. Download e instalação do módulo do Magento 2
Dependendo da versão do Magento que seu eCommerce possui, você deverá seguir uns passos ou outros:
- Se você tem uma versão anterior ao Magento 2.2, confira a seção A deste passo.
- Se você tem uma versão posterior ao Magento 2.2, confira a seção B deste passo.
- Se você tem Magento + Hyvä, confira a seção correspondente à sua versão e o ponto 6 das perguntas frequentes.
A. Versões anteriores ao Magento 2.2
A.1. Download do módulo
1. Acesse sua conta do Connectif.
2. Acesse Configurações da Loja no menu lateral esquerdo.
3. Na seção Plataformas e-commerce, busque por 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 dentro da pasta "/app/code/", situada na raiz da instalação do Magento 2.
Se a pasta "/app/code/" não existir, deverá ser criada.
Por exemplo, se o caminho de instalação do Magento 2 for "/var/www/html" deverá copiar a pasta "Connectif" para "/var/www/html/app/code/Connectif".
A.3. Instalação do módulo
6. Acesse o painel de administração do Magento 2 e vá para a seção "System > Web Setup Wizard".
O SetUp wizard foi removido a partir da versão 2.4.0 do Magento, portanto você deverá habilitar a integração por comandos, que encontrará disponível no ponto 2b da documentação de instalação anexada ao arquivo "connectif.zip" baixado no passo 2. Encontre mais informações na documentação do Magento.
7. Em Module Manager, busque pelo módulo Connectif_Integration e selecione Activate.
8. Siga os passos indicados na instalação do módulo do Connectif e clique em Próximo:
Readiness Check: neste passo são feitas verificações relacionadas à versão do PHP, crons, dependências e extensões.
Backup: neste passo é feito um backup do eCommerce antes da instalação do módulo.
Enable module: neste passo é feita a ativação do módulo.
B. Versões posteriores ao Magento 2.2
B.1. Download do módulo
1. Acesse sua conta do Connectif.
2. Acesse Configurações da Loja no menu lateral esquerdo.
3. Na seção Plataformas e-commerce, busque por 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 conexão SSH.
14. Após um login SSH bem-sucedido, usando a linha de comando (shell), vá para o diretório raiz do Magento onde o Magento 2 está instalado.
15. Envie o módulo (como Zip ou tar.gz) para o 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:upgrade20. Compile o módulo instalado com:
php bin/magento setup:upgrade21. Limpe o cache com:
php bin/magento cache:flusO módulo estará 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 em versões anteriores e posteriores ao Magento 2.2.
22. Vá para "Stores > Configuration > " e localize a configuração do Connectif.
23. Em Basic Configuration, selecione a opção Yes no campo Activate, para poder completar as opções Client ID e Secret Key.
Não feche esta aba, você precisará dela para completar os dados da sua conta.
24. Vá para sua conta do Connectif e, na seção "Integrações > Magento" copie o ID do Cliente e a Chave Secreta.
25. Volte para o Magento 2 e cole-os nos campos correspondentes.
26. Clique em "Save Config" para salvar as alterações.
Sucesso!
Sua integração do Connectif com Magento está pronta.
Após finalizar a configuração do plugin, é recomendável verificar a correta integração. Você pode ver como fazer isso neste artigo.
Perguntas frequentes
Tem dúvidas sobre o módulo do Connectif no Magento? Aqui você encontrará informações úteis:
1. Para que serve cada seção do módulo do Connectif no Magento?
O módulo do Connectif no Magento é composto por diferentes seções, cada uma com funções distintas:
- Basic Configuration (1): esta seção serve para configurar os aspectos básicos da sua conta do Connectif no Magento, documentados neste artigo, e poder começar sua estratégia.
- Banners (2): esta seção está obsoleta, pois os conteúdos em formato banner são configurados diretamente no Connectif.
Os conteúdos do tipo "Janelas modais" e "Banners" estão obsoletos desde 2021. Em este artigo é explicado como migrá-los para o Connectif.
- Customer (3): esta seção permite vincular os campos personalizados do contato no Connectif com os do Magento. Para isso, selecione algum dos campos de contato disponíveis no CMS (seletor esquerdo, Customer Field) e associe-o com o ID do campo criado no Connectif (seletor direito, Connectif Field ID).
- Product (4): esta seção permite vincular os campos personalizados do produto no Connectif com os campos nativos no Magento. Para isso, clique no seletor Select Attribute do campo que deseja associar (Custom Field 1, 2 ou 3) e selecione o atributo do produto para esse campo.
- Public Urls (5): esta seção serve para consultar as URLs de ativação do ServiceWorker e as de notificação de inscrição.
Essas URLs são geradas e comunicadas ao Connectif quando o módulo é instalado no Magento.
-
Advanced Configuration (5): esta seção serve para estabelecer determinados comportamentos da integração com o Connectif:
- Print only mandatory fields on cart tags?: esta opção permite determinar 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.
- Use product variants on cart and purchases?: esta opção permite determinar se, ao receber o Connectif a informação dos produtos do carrinho, coletará o produto padrão ou a variante específica.
- Product imagen Id: esta opção permite determinar o tamanho da imagem que o Connectif coletará.
- Notify purchases offline: esta opção permite determinar se o eCommerce notificará ao Connectif as compras offline via API e sem contexto web.
- Order Status: esta opção permite determinar o estado em que as compras devem estar para serem registradas via API (notificações offline) no Connectif.
- Create newsletter subscribers if customer does not exist?: esta opção permite selecionar se o contato será criado no Magento como Assinante da newsletter caso não exista no Magento quando for notificado o cadastro ou cancelamento pelo Connectif.
- Show product view with proper currency when Connectif verify the product: esta opção influencia no caso de a sincronização de produtos ser feita via Scrapping web. Permite indicar se, quando o mecanismo do Connectif visitar o site para sincronizar/verificar um produto, o faça na mesma moeda configurada no Connectif.
2. Como ativar a notificação de compras offline (via API)?
Notificar as compras offline significa que estas não têm contexto web, mas a notificação é feita via API, de forma assíncrona. Se houver alguma estratégia que reaja à compra com um conteúdo web, ela não impactará os contatos cuja compra for registrada via API.
1. Na sua conta do Magento, vá para "Stores > Configuration", clique em Connectif e em Settings.
2. Desative o módulo do Connectif na seção "Basic Configuration > Activate", selecionando a opção No.
3. Clique em Save Config.
É necessário salvar a configuração logo após este passo para poder ativar as compras offline.
4. Vá para a seção "Advanced Configuration > Notify purchases offline", e selecione a opção Yes.
5. Na seção "Order Status" escolha o estado em que as compras devem estar para serem registradas no Connectif de forma offline.
A seleção do estado dependerá do método de pagamento, da configuração do Magento e do modelo de negócio. Só é possível escolher um estado.
6. Reative o módulo do 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 Magento multi-idioma?
O Magento permite criar três níveis de entidades em uma conta:
- Website: geralmente há apenas um e corresponde ao domínio.
- Store: as diferentes lojas, por exemplo, por idioma.
- Store view: outros detalhes para lojas, por exemplo, no mesmo idioma mas com moeda diferente.
O módulo do Connectif pode ser configurado em qualquer um desses níveis conforme as necessidades do eCommerce, mas é preciso considerar alguns aspectos:
- Os tipos de configuração do Magento, pois se a configuração for feita no modo "Default" ela se aplicará a todos os níveis do Magento.
- Para enviar para a mesma loja do Connectif os dados de diferentes níveis do Magento, na configuração devem ser usados o mesmo Client ID e a mesma Secret Key.
- É recomendável, salvo em casos muito complexos, ativar a configuração padrão no momento da integração, para configurar todos os níveis da mesma forma.
Se houver vários idiomas e/ou várias moedas que se queira configurar, é comum fazer os ajustes do artigo a nível de Store View separadamente.
4. Como recuperar carrinhos abandonados com a URL de Recuperação de Carrinho
(Nesta seção é explicado como funciona a URL de Recuperação de Carrinho para obter os itens associados a um carrinho específico).
Através da integração com Magento, é enviada ao Connectif uma URL de Recuperação de Carrinho, ou seja, um link para recuperar os artigos relacionados a esse carrinho, que pode ser usado em workflows e conteúdos.
Para obter a URL de recuperação de carrinho via workflow, deve ser feito através do nó "Obter último carrinho" e "Ao abandonar carrinho", depois, mapear nas variáveis do conteúdo a mostrar ou enviar.
- Aprenda como funciona essa URL nos diferentes CMS e como usá-la neste artigo.
5. Como coletar a marca dos produtos no Magento
Para coletar o campo "Marca" na ficha do produto do Connectif na integração com Magento, é necessário ativar o campo "Manufacturer" do Magento e fornecer os valores correspondentes, para que assim chegue automaticamente.
Este campo não vem ativo por padrão no Magento, portanto, para ativá-lo você deve seguir estes passos:
1. Vá para a seção "Stores > Attributes > Attribute Set".
2. Localize o grupo de atributos "Default".
3. Dê um duplo clique para editar e, uma vez dentro, adicione o campo "manufacturer" à pasta "Product Details", clicando sobre ele e arrastando para dentro da pasta.
4. Clique em Salvar para confirmar esta configuração. Assim, os dados do campo "manufacturer" serão sempre transmitidos nos produtos que tiverem este grupo de atributos.
Para que a marca seja transmitida ao Connectif automaticamente por este processo, você deve tê-la criado dentro deste campo. Se o fez por outro campo, deverá 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, deverá 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 garantir que o campo "manufacturer" está incluído na sua ficha do Magento. Dentro dela, além disso, poderá alterá-lo se precisar através do menu suspenso.
6. O que devo considerar se minha loja Magento 2 usa Hyvä?
Se sua loja usa Magento 2 com Hyvä, você deve verificar se o tema utiliza o sistema padrão de inicialização JavaScript do Magento *-init para lançar corretamente os scripts do Connectif.
Esta configuração é necessária porque o Hyvä modifica o sistema frontend do Magento e pode alterar a forma como alguns scripts são inicializados. O módulo do Connectif apoia-se no mecanismo padrão do Magento para executar os scripts de tracking e identificação do contato.
Para completar a integração, verifique com sua equipe de desenvolvimento que os scripts do Connectif são inicializados através do *-init, usando data-mage-init ou text/x-magento-init, conforme o caso.
Uma vez aplicada esta configuração, valide que a integração captura corretamente os principais eventos da loja. Você pode ver como fazer isso neste artigo.
Continue aprendendo!
Para aproveitar todo o potencial da sua conta no Connectif, recomendamos continuar com os seguintes artigos:
Onboarding, para adquirir habilidade com nossa interface.
Workflows iniciais, para implementar suas primeiras estratégias na conta.
Integrações com sistemas externos, para se integrar com Facebook, formulários e webhooks do seu site.
Integrações via API, para administrar eventos como registros de compras ou cadastros de contatos.