Guia para integrar com Magento 2

Se o seu eCommerce foi desenvolvido em Magento, você poderá integrá-lo facilmente ao 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.

ETAPA 1. Download e instalação do módulo do Magento 2

Dependendo da versão do Magento que seu eCommerce utiliza, você deverá seguir etapas diferentes:

• Se você tiver uma versão anterior ao Magento 2.2, consulte o item A desta etapa.
• Se você tiver uma versão posterior ao Magento 2.2, consulte o item B desta etapa.
• Se você tiver Magento + Hyvä, consulte o item correspondente à sua versão e o item 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 de e-commerce, procure 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. Cópia da 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.

A.3. Instalação do módulo

6. Acesse o painel de administração do Magento 2 e vá até a seção "System > Web Setup Wizard".

7. No Module Manager, procure o módulo Connectif_Integration e selecione Activate.

8. Siga as etapas indicadas pela instalação do módulo do Connectif e clique em Avançar:

• Readiness Check: nesta etapa, são realizadas verificações relacionadas à versão do PHP, crons, dependências e extensões.

• Backup: nesta etapa, é realizado um backup do eCommerce antes da instalação do módulo. 

• Enable module: nesta etapa, o módulo é ativado. 

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 de e-commerce, procure 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. Cópia da 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 fazer login via SSH com sucesso, usando a linha de comando (shell), vá 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 na etapa 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:upgrade

21. Limpe o cache com:

php bin/magento cache:flus

ETAPA 2. Ativação do módulo

22. Vá até "Stores > Configuration > " e localize a configuração do Connectif.

23. Em Basic Configuration, selecione a opção Yes no campo Activate para poder preencher as opções Client ID e Secret Key.

24. Acesse sua conta do Connectif e, na seção "Integrações > Magento" copie o ID do cliente e a Chave secreta.

25. Volte ao Magento 2 e cole-os nos campos correspondentes.

26. Clique em "Save Config" para salvar as alterações.

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 começar sua estratégia. 

• Customer (2): esta seção permite configurar as informações dos contatos do Magento que serão enviadas para a 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 ele não exista no Magento quando a inscrição ou o cancelamento forem notificados pelo Connectif.
  • Configure Customer Fields: esta opção permite vincular os campos de contato disponíveis no CMS (seletor esquerdo, Customer Field) ao ID do campo criado no Connectif (seletor direito, Connectif Field ID).

• Product (3): esta seção serve para configurar os aspectos básicos dos seus produtos do Magento que serão sincronizados com o Connectif:
  • Use product SKU identifier?: esta opção permite usar o SKU como identificador dos produtos no catálogo do Connectif.
  • Product imagen ID: esta opção permite determinar o tamanho da imagem que o Connectif coletará. 
  • Use full category path: esta opção permite enviar o caminho completo das categorias do produto, incluindo as categorias superiores, mesmo que não estejam atribuídas diretamente ao produto.
  • Show product view with proper currency when Connectif verify the product: esta opção influencia o caso em que a sincronização de produtos é feita via Scrapping web. Permite indicar se, quando o mecanismo do Connectif visitar o site para sincronizar/verificar um produto, isso será feito na mesma moeda configurada no Connectif.
  • Custom Field 1, Custom Field 2 y Custom Field 3: estas opções permitem configurar os campos personalizados das variantes de produto que serão enviadas ao Connectif.

• Cart and order (4): esta seção permite configurar as informações dos carrinhos e das compras que você enviará ao Connectif:
  • Print only mandatory fields on cart tags?: esta opção permite determinar se o script do Connectif coletará somente os campos obrigatórios do carrinho (ID do produto, nome, preço e URL). Esta opção melhora o desempenho da tag de carrinho no Magento.
  • Use product variants on cart and orders?: esta opção permite determinar se, ao receber as informações dos produtos do carrinho, o Connectif coletará o produto padrão ou a variante específica.
  • Notify orders offline: esta opção permite determinar se o eCommerce notificará o Connectif sobre as compras offline via API e sem contexto web.
  • Order Status: esta opção permite determinar o status que as compras devem ter para serem registradas via API (notificações offline) no Connectif. 

• Advanced Configuration (5): esta seção serve para definir determinados comportamentos da integração com o Connectif:
  • Use optimized Connectif tags: esta opção permite otimizar a geração das tags do Connectif para melhorar os tempos de carregamento. Ao ativá-la, a sincronização em tempo real dos dados de contato também é ativada automaticamente.
  • Real-time customer data sync: esta opção permite sincronizar em tempo real com o Connectif as alterações realizadas nos dados dos contatos, como suas informações, endereços e assinaturas de newsletter.

• Banners (6): esta seção está obsoleta, pois os conteúdos no formato de banner são configurados diretamente no Connectif.

• Public Urls (7): esta seção serve para consultar as URLs de ativação do ServiceWorker e as URLs de notificação de assinatura.

Essas URLs são geradas e comunicadas ao Connectif quando o módulo é instalado no Magento.

2. Como ativar a notificação de compras offline (via API)?

1. Na sua conta do Magento, vá até "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.

4. Vá até a seção "Cart and Order > Notify purchases offline" e selecione a opção Yes.

5. Na seção "Order Status" escolha o status que as compras registradas offline no Connectif devem ter.

6. Ative novamente 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 multilíngue do Magento?

O Magento permite criar três níveis de entidades em uma conta:

• Website: geralmente há apenas um, correspondente ao domínio.
• Store: a(s) loja(s) diferente(s), por exemplo, por idioma.
• Store view: outros detalhes das lojas, por exemplo, no mesmo idioma, mas com moeda diferente.

O módulo do 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, se uma configuração for feita no modo "Default", ela será aplicada a todos os níveis do Magento.
• Para enviar ao mesmo store do Connectif os dados de diferentes níveis do Magento, a configuração deverá usar o mesmo Client ID e a mesma Secret Key.
• Recomenda-se, exceto 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 você deseja configurar, é comum fazer os ajustes deste artigo separadamente no nível de Store View .

4. Como recuperar carrinhos abandonados com a URL de recuperação de carrinho

(Nesta seção, explicamos como funciona a URL de recuperação de carrinho para obter os itens associados a um carrinho específico).

Por meio da integração com o Magento, uma URL de recuperação de carrinho é enviada ao Connectif, 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 por meio de um workflow, isso deve ser feito usando o nó "Obter último carrinho" e "Ao abandonar o carrinho" e, posteriormente, mapeado nas variáveis do conteúdo a ser exibido ou enviado.

• Saiba como essa URL funciona nos 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 enviado automaticamente.

Esse campo não vem ativado por padrão no Magento. Para ativá-lo, siga estas etapas:

1. Vá até a seção "Stores > Attributes > Attribute Set".

2. Localize o grupo de atributos "Default".

3. Clique duas vezes para acessar sua edição e, uma vez dentro dele, adicione o campo "manufacturer" à pasta "Product Details", clicando nele 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 tiverem esse grupo de atributos.

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 verificar se o campo "manufacturer" está incluído na ficha do Magento. Nela, você também poderá alterá-lo, se necessário, por meio do menu suspenso.

6. O que devo considerar se minha loja Magento 2 usar Hyvä?

Se sua loja utiliza Magento 2 com Hyvä, você deverá verificar se o template utiliza o sistema padrão de inicialização JavaScript do Magento *-init para executar corretamente os scripts do Connectif.

Essa configuração é necessária porque o Hyvä modifica o sistema de frontend do Magento e pode alterar a forma como alguns scripts são inicializados. O módulo do Connectif utiliza o mecanismo padrão do Magento para executar os scripts de tracking e identificação do contato.

Para concluir a integração, verifique com sua equipe de desenvolvimento se os scripts do Connectif são inicializados por meio de *-init, usando data-mage-init ou text/x-magento-init, conforme aplicável.

Depois de aplicar essa configuração, valide se a integração coleta corretamente os principais eventos da loja. Veja como fazer isso neste artigo.

Continue aprendendo!

Para aproveitar todo o potencial da sua conta do Connectif, recomendamos continuar com os seguintes artigos:

• Onboarding, para adquirir familiaridade com nossa interface.

• Workflows iniciais, para implementar suas primeiras estratégias na conta.

• Integrações com sistemas externos, para integrar-se ao Facebook, formulários e webhooks do seu site.

• Integrações via API, para gerenciar eventos como registros de compras ou inscrições de contatos.