Magento 2

Integre o Magento 2 para sincronizar usuários e dados com o Xtremepush

A Integração Magento 2 permite que você sincronize automaticamente os dados do Magento 2, execute campanhas personalizadas de marketing de comércio eletrônico e as analise.

Este guia demonstra como integrar e coletar dados com sucesso do Magento.

Instale a extensão Xtremepush no Magento 2

Como primeiro passo da integração, a extensão Xtremepush precisa ser instalada no Magento 2.

Suporte técnico necessário
A extensão Xtremepush pode ser instalada via compositor. Ele exige suporte de TI com acesso SSH ao servidor onde o Magento 2 foi hospedado.

Para instalar a extensão Xtremepush, quatro passos principais precisam ser tomados:

Faça login no seu servidor Magento 2 e navegue até o diretório raiz do seu app Magento a partir da sua ferramenta de linha de comando. Este guia mostra exemplos de saídas para o Terminal, mas esses passos podem ser modificados para qualquer ferramenta de linha de comando de sua escolha.
O módulo é instalado via Composer. Primeiro, certifique-se de que suas dependências atuais estejam atualizadas:
```
composer update
```
Depois, execute este comando para adicionar o módulo Xtremepush ao seu ambiente Magento:
```
composer require xtremepush/magento2-plugin
```

Após a atualização, você deve realizar a regeneração do código e reiniciar os serviços:

sudo php -d memory_limit=-1 bin/magento setup:upgrade
sudo php -d memory_limit=-1 bin/magento setup:di:compile
sudo php -d memory_limit=-1 bin/magento setup:static-content:deploy -f

Após implantar o conteúdo estático, reinicie os serviços.

Criar integração no Magento 2

Faça login na sua conta Magento e navegue até Integrações > Sistema > Adicionar Nova Integração.

Preencha os detalhes da integração digitando um nome descritivo e senha, depois navegue até a API (em Configurações Básicas) para atribuir as permissões de nível relevantes.

Permissões necessárias
Você precisará conceder as seguintes permissões de usuário:
Extensões > Integrações de Sistema > Sistema
Marketing > Comunicação > Assinantes de Newsletters
Vendas > Operações > Pedidos > Ações > Visualização
Clientes

Clique em Salvar após definir as permissões. Neste momento, o Magento gerará seu Access Token que você precisará usar na plataforma Xtremepush para completar sua integração. Você pode encontrá-lo em Detalhes de Integração.

Integração completa no Xtremepush

Depois de completar os passos acima em Magento 2, abra uma nova aba no seu navegador e faça login na sua conta Xtremepush. Navegue até Integrações > Marketplace, selecione o cartão Magento na aba Integration Marketplace e clique em Conectar.

Preencha as seções de Conexão e Mapeamento de Dados para completar a integração.

Conecte o Magento

Nesta página, você precisa inserir configurações básicas e detalhes de conexão.

Configurações básicas

Dê um nome à sua conexão que ajude a identificá-la facilmente.

Configurações de conexão

Access Token: Encontrado no Magento navegando para System > Integrations > integração Xtremepush em uma seção chamada Access Token.
URL da loja: Como https://my-shop.com/.

Após completar os detalhes da conexão, clique no botão Buscar Atributos Magento . Ele automaticamente gerará uma seção de mapeamento de dados para atributos assim que as credenciais de integração forem confirmadas.

Mapeamento de dados

Esta seção lista seus atributos do sistema mapeados automaticamente. Ele permite que você selecione qual atributo padrão deseja importar. Você também pode mapear seus atributos personalizados do Magento para seus atributos personalizados no Xtremepush.

Os atributos do sistema do Xtremepush, como user_id e email – serão automaticamente mapeados para Magento id e email atributos (listados nos campos Coluna ).

Você pode definir os atributos padrão do Magento para Importar ou Não Importar nos campos Mapa . Se você selecionar Importar, essas opções serão criadas automaticamente no Xtremepush.

Por fim, você também verá os atributos personalizados do Magento (listados nos campos da Colunha ) como gender , default_billing e default_shipping. Você pode mapear esses atributos para seus atributos personalizados Xtremepush predefinidos.

Criação de atributos
Atributos do sistema e atributos padrão são criados automaticamente no Xtremepush. No entanto, para mapear atributos personalizados, você precisa criar esses atributos primeiro no Xtremepush. Revise nosso guia de Atributos e Tags para ver como fazer isso.

Dados de assinatura por e-mail
Para coletar dados de assinaturas de e-mail, você precisa mapear o atributo do is_subscribed Magento ao atributo do email_subscription Xtremepush.

Depois de concluir o mapeamento de dados, clique em Conectar para concluir a integração.

Depois de completar os passos acima no Xtremepush, pelo seu painel do Magento, navegue até o Xtremepush > Configurações > Geral, verifique as configurações de integração e então ative a integração.

Após ativar sua integração com sucesso, navegue até o General > Webhooks e permita que os webhooks extraiam eventos em tempo real do Magento para o Xtremepush. Você pode ativar o checkout (cotações), eventos relacionados ao cliente e pedidos. Quando você ativa um webhook, poderá usar seus eventos nas suas campanhas, pois eles serão automaticamente criados como eventos personalizados na plataforma Xtremepush quando esse evento for acionado pelo Magento.

Esses eventos podem ser usados quando você cria campanhas desencadeadas por eventos. Você também pode usá-los dentro da segmentação, por exemplo, para e-mails de abandono ou boas-vindas para compradores de primeira viagem.

Os eventos usarão o nome deles de Magento 2. Por exemplo;customer/order/created, customer/quote/updated, customer/customer/registered etc. Você pode verificar a nomeação dos eventos disponíveis nesta página.

Depois de selecionar os webhooks necessários, clique em Salvar Configuração. Uma vez feitas e confirmadas as conexões, sua integração com o Magento será listada na aba Integrações Configuradas dentro do Marketplace e você receberá a página de Detalhes da Integração .

Por fim, para iniciar a sincronização, clique no menu suspenso Ações e selecione Sincronizar. Suas opções serão Sincronização Total, Sincronizar perfis e Compras por Sincronização. Uma sincronização completa inclui sincronização dos usuários (que será criada no Xtremepush) e dados de compra. Uma vez concluído, cada atributo do perfil é exibido junto com um carimbo de data e o status de Concluído. Se houver algum outro status, clique no menu Mais e escolha Detalhes para informações estendidas.

Sincronização dos dados de compra
Depois de sincronizar os dados de compra, não precisa mais sincronizar esses dados. O sistema atualiza automaticamente os dados de compra com base nos detalhes dos pedidos recebidos de eventos em tempo real.

Revise a integração

Navegue até Configurações > Integrações > Marketplace > Integrações Configuradas e clique em Magento para revisar os detalhes da integração (Visão Geral). A seção de Informações mostra o token e o endpoint. Essas informações são automaticamente passadas para o Magento, mas também podem ser confirmadas nesta página para manchetes de segurança. A seção Histórico de Sincronização oferece uma visão geral do histórico de sincronização com o Magento.

Atualize ou exclua uma conexão existente

Selecione a integração que deseja atualizar em Configurações > Integrações > Marketplace > Integrações Configuradas. Vá até a aba Configurações e atualize qualquer configuração necessária, clique em Salvar para confirmar. Se precisar deletar ou desativar a conexão, clique no botão Ações . Você terá a opção de desativar ou excluir a integração. Clicar em qualquer um deles abre uma janela de confirmação.