Primeiros passos com o Magento 2.x (CE e EE)

O que você vai aprender

Saiba como integrar a Klaviyo com sua loja Magento 2 CE ou EE. Você precisará instalar a extensão da Klaviyo na Magento, configurar a extensão e configurar o OAuth e, em seguida, ativar a integração na Klaviyo. Este guia abrange todas as etapas de integração necessárias e como confirmar se a sincronização de dados históricos foi bem-sucedida.

Antes de começar

Observe que não há suporte para versões do Magento 2 inferiores à 2.4.0.

Para garantir que a Klaviyo possa fazer as chamadas de API necessárias para a integração, seu servidor Magento 2 deve ter um nome de host acessível publicamente. Os servidores Magento 2 hospedados localmente não poderão se integrar totalmente ao Klaviyo.

É altamente recomendável adicionar IPs da Klaviyo à lista de permissões do seu provedor de firewall para minimizar problemas de autenticação e configuração. Para mais informações, consulte a lista Como permitir a integração com a Klaviyo e os endereços IP de tráfego.

A extensão Magento 2 da Klaviyo deve ser instalada via Composer. Observe que a instalação via Composer requer um administrador de TI com acesso SSH ao servidor onde o Magento 2 está hospedado.

Instalar a extensão Klaviyo no Magento 2

1. Faça login no seu servidor Magento 2 e navegue até o diretório raiz do seu aplicativo Magento a partir da sua ferramenta de linha de comando. Este guia mostra exemplos de saídas para o Terminal, mas essas etapas podem ser modificadas para qualquer ferramenta de linha de comando de sua escolha.
2. Execute o comando a seguir para acessar a versão mais recente da extensão da Klaviyo da Packagist. Packagist é um repositório para bibliotecas de código PHP que permite que você instale facilmente a versão mais recente da extensão. O Composer requer a extensão Klaviyo/Magento2
3. Execute o seguinte comando para habilitar a extensão da Klaviyo que acabou de baixar: php bin/magento module:enable Klaviyo_Reclaim --clear-static-content
   
4. Conforme exibido no exemplo de saída, agora você deve habilitar todos os módulos adicionais. Execute o seguinte comando para habilitá-los: php bin/magento setup:upgrade
5. Examine o resultado do Módulo 'Klaviyo_Reclaim' para confirmar se o módulo Klaviyo está ativado e em execução.
6. Para garantir que o CSS e o JS em sua loja Magento 2 continuem funcionando corretamente, você ’precisará executar um comando de implantação de conteúdo estático. Configuração do PHP BIN/Magento: static-content:deploy -f
   
7. Agora o senhor pode retornar ao painel de administração do Magento a partir do navegador.

A instalação via Composer está concluída! Prossiga para a próxima seção para obter instruções de configuração.

Configurar a extensão Klaviyo

Vídeo de instruções

1. Na sua conta Klaviyo, navegue até a aba Chaves de API.
2. Em uma nova guia, navegue até o administrador da loja Magento.
3. Em Settings (Configurações), clique em Stores > Configuration (Configuração).
4. No menu suspenso do Klaviyo, clique em General (Geral).
5. Defina Enable Klaviyo Extension como Yes.
6. Copie sua chave de API pública de seis dígitos da Klaviyo na guia API keys e cole-a na caixa correspondente no Magento.
7. Na guia Klaviyo API keys (Chaves de API do Klaviyo), gere uma nova chave privada e cole-a na caixa correspondente no Magento. A autenticação com sua chave de API privada permitirá que o senhor sincronize as assinaturas da Newsletter do Magento com o Klaviyo.

Na próxima seção, você configurará o OAuth, que habilita outros aspectos da integração.

Configurar o OAuth

Em seguida, você habilitará a autenticação OAuth para conectar com segurança sua conta Klaviyo à extensão da Magento 2.

1. Navegue até a guia Setup OAuth (Configurar OAuth ) no Magento.
2. Dê um nome memorável à sua integração, pois você precisará localizá-la com esse nome mais tarde.
3. Clique em Salvar configuração para prosseguir.
   
4. Localize Sistema no painel de navegação à esquerda e selecione Integrações na bandeja Sistema.
5. Localize o nome da sua integração e clique em Ativar. A ativação da integração abrirá uma janela solicitando que você aprove o acesso.
   
6. Clique em Permitir para ser redirecionado para a Klaviyo, onde você concluirá a configuração da integração.
   
7. Faça login na Klaviyo se solicitado ou confirme se o nome da sua conta está correto e clique em Integrar. Isso adicionará a integração da Magento 2 à conta Klaviyo associada à chave de API usada para a configuração. Se estiver conectado a várias contas Klaviyo e a conta correta não estiver sendo exibida, desconecte-se de qualquer outra sessão.

Se a janela fechar automaticamente, a conexão foi bem-sucedida. Você também pode confirmar o sucesso abrindo sua conta Klaviyo em uma nova aba ou janela do navegador, selecionando a aba Integrações e procurando a Magento 2 na lista.

Se você receber o seguinte erro, verifique se as chaves de API usadas na primeira etapa correspondem à conta na qual você está conectado no momento.

Ao estabelecer a conexão entre o Magento e a Klaviyo, se, em vez disso, o senhor receber uma lista de erros, poderá clicar em cada erro para saber mais sobre a causa.

Definir uma lista de boletins informativos

Em seguida, o senhor selecionará uma lista do Klaviyo para sincronizar os assinantes do boletim informativo. O senhor também tem a opção de usar as configurações de opt-in do Klaviyo ou as configurações de opt-in do Magento 2 para a lista escolhida.

1. No Magento, clique em Newsletter.
2. Selecione a lista do Klaviyo com a qual deseja sincronizar o formulário de inscrição do Magento no menu suspenso.
3. Clique em Salvar configuração.

Habilitar o consentimento no checkout

Em seguida, o senhor pode optar por ativar o consentimento no checkout para e-mail e SMS.

Observe que, se você habilitar o consentimento no checkout, também precisará habilitar os webhooks (abaixo) para que o consentimento no checkout funcione corretamente.

1. Na página Configuration, em Klaviyo, navegue até Consent at Checkout.
   
2. Você ’ verá uma seção para coletar consentimento para e-mail e SMS. Os dois são tratados separadamente, para que você possa coletar apenas e-mail, apenas SMS ou ambos. Se você reunir assinantes de SMS e e-mail, escolha uma lista diferente para SMS e e-mail. Isso garante que o consentimento seja sempre atribuído corretamente ao canal correto.
   
   • O consentimento não será sincronizado (tanto para e-mail quanto para SMS) até que o cliente termine de fazer o pedido e, se aplicável, confirme sua assinatura devido ao double opt-in.
   • Observe que, para os usuários já conectados à sua loja do Magento 2, a caixa de seleção de consentimento por e-mail não aparecerá no checkout por padrão.
3. Em E-mail, selecione Sim para Inscrever contatos em marketing por e-mail no checkout.
4. Selecione uma lista de e-mail para sincronizar os assinantes, como um boletim informativo.
5. Digite o texto da caixa de seleção de consentimento para e-mail que deseja usar.
   
6. Em SMS, selecione Sim para Inscrever contatos no marketing por SMS durante o checkout.
7. Escolha a lista para a qual deseja sincronizar seus contatos de SMS. Para mais detalhes sobre essas configurações, consulte nosso guia para coletar consentimento para SMS durante o checkout.
   
8. A ordem de classificação permite que o senhor altere o posicionamento das caixas de consentimento de e-mail e SMS. Por padrão, essas caixas aparecem abaixo da primeira entrada de e-mail e do campo de número de telefone para envio, respectivamente. Portanto, se o senhor não tiver reorganizado a página de checkout, não precisará alterar a ordem de classificação. Se o senhor tiver alterado o layout, ajuste a ordem de classificação de acordo.
9. Quando terminar, clique em Salvar configuração no canto superior direito.

Habilitar webhooks

Em seguida, você habilitará os webhooks da Klaviyo na sua conta da Magento 2. Observe que a ativação de webhooks é necessária para que o consentimento no checkout funcione corretamente.

1. No painel de controle do administrador, navegue até Stores > Configuration.
2. Clique na Klaviyo e selecione a aba Webhooks.
3. Crie um segredo de webhook e insira-o no campo Segredo de webhook correspondente. O segredo do webhook é uma chave que a Klaviyo usará para validação. Esse segredo pode ser qualquer coisa que você escolher, mas recomendamos criar uma sequência segura de letras e números. A Magento ocultará seu segredo de webhook com asteriscos por motivos de segurança, portanto, tenha cuidado para inseri-lo corretamente. Se estiver usando uma integração de várias lojas, o segredo do webhook nesse campo deverá ser inserido em sua configuração padrão, e o mesmo segredo será usado como validação para cada configuração de loja. O segredo do webhook só deve ser adicionado à configuração padrão e não deve ser adicionado por loja.
   
4. Ao lado dos webhooks que deseja habilitar, selecione Sim no menu suspenso. Para saber mais sobre os webhooks compatíveis com a Klaviyo, consulte nosso guia de webhooks para a Magento 2.
5. Clique em Salvar configuração.

Habilitar a integração do Magento 2 no Klaviyo

Vídeo de instruções

1. Abra o site Klaviyo e selecione integrações na navegação à esquerda. Localize o Magento 2 na lista e selecione-o.
2. Na página seguinte, você terá a opção de adicionar novos clientes da Magento 2 a uma lista da Klaviyo. Clique na caixa de seleção para Adicionar novos clientes da Magento 2 a uma lista da Klaviyo e selecione uma lista no menu suspenso. Ao verificar essa configuração, você adicionará apenas clientes à lista selecionada, mas não os inscreverá em mensagens de marketing. Essa configuração só sincronizará novos clientes; os clientes existentes precisam ser migrados manualmente da sua lista da Magento para a Klaviyo.
   
3. Em seguida, selecione quais exibições de loja do Magento 2 você gostaria de sincronizar com o Klaviyo. Por padrão, todas as visualizações de loja são sincronizadas com o Klaviyo. Essa configuração permite que você seja seletivo em relação às lojas com as quais se integra. Se você estiver usando o Multi-Source Inventory (MSI) no Magento 2, verifique Specific Magento 2 store views e selecione as lojas que deseja sincronizar para ver seu inventário corretamente representado no Klaviyo.
4. Em Avançado, ative as seguintes configurações conforme necessário:
   
   • Configurações de preço especial Essa configuração se refere a um preço de venda especial para itens que podem opcionalmente entrar em vigor em uma determinada faixa de datas. Recomendamos que você ative esse recurso se quiser usá-lo, pois fica mais difícil ativá-lo mais tarde. Quando você ativar Usar preço especial para preços de produtos quando aplicável, o bloco de produtos exibirá o preço especial quando aplicável. Ao usar um feed de produtos dinâmico, o preço especial será preenchido no horário de envio. Ao selecionar manualmente os itens do seu catálogo, o preço especial será preenchido assim que você selecionar os produtos. Para cada produto, há 4 campos de metadados que serão sincronizados:
     • preço (Obrigatório, flutuante) O preço padrão do item.
     • special_price (Opcional, flutuante) Este é um preço de venda especial para o item. Quando esse preço estiver em vigor, você verá esse special_price ao lado de um strikethrough do preço.
     • special_from_date (Opcional, data) Especifica uma data inicial para o special_price entrar em vigor.
     • special_to_date (Opcional, data) Especifica uma data final para o special_price que está em vigor.
   • URL Raiz de Mídia Personalizada Essa configuração permite que você altere o caminho padrão das imagens do seu site. Habilite essa configuração se você hospedar as imagens do seu produto em um URL diferente do seu site.
5. Clique em Save.

Agora você habilitou a integração com a Magento 2! Seus dados começarão a ser sincronizados com a Klaviyo em minutos.

Após a conclusão da sincronização inicial dos dados históricos, a integração do Magento 2 é sincronizada a cada 30 minutos.

Dados sincronizados com a integração do Magento 2

A integração do Klaviyo com o Magento 2 extrai as principais informações dos clientes de sua plataforma Magento.

Aqui estão alguns dos dados que sincronizamos do Magento:

• Informações sobre o cliente, incluindo nome, sobrenome e local.
• Dados de vendas e pedidos, incluindo quais itens foram comprados, imagens de itens, categorias de itens e quaisquer descontos aplicados.
• Dados de pedidos atendidos, reembolsados e cancelados.
• Quando as pessoas visitam seu site e quais itens elas visualizam, o rastreamento da Web é feito pela extensão.

Para saber mais, acesse nossa referência de dados da Magento 2.

Converta os valores dos pedidos do Magento em uma única moeda

A Klaviyo suporta a conversão de todas as moedas estrangeiras na Magento em uma moeda principal na Klaviyo. Entre em contato com o suporte para habilitar esse recurso. Isso é especialmente útil se você tiver várias lojas com transações em moedas diferentes.

Quando esse recurso está ativado:

• A conversão acontece quando a Magento sincroniza os dados do pedido com a Klaviyo.
• A Klaviyo verificará se o order_currency_code é o mesmo que o set global_currency_code. Caso contrário, a Klaviyo converterá o total do pedido da moeda do pedido para a moeda global especificada para garantir que suas análises financeiras estejam precisas. Observe que os itens da linha da ordem permanecerão no código da moeda da ordem e não serão convertidos.

Atualize sua extensão

Deseja atualizar sua extensão da Klaviyo Magento 2? Siga as instruções detalhadas na seção Instalar acima e execute o comando para instalar a versão mais recente. Isso substituirá sua versão atual e sua atualização será concluída. Não há necessidade de reconfigurar a extensão ou reabilitar a integração na Klaviyo™s.

Sincronizar novamente seu catálogo

Você pode solicitar uma ressincronização histórica completa do seu catálogo da Magento 2 a qualquer momento. Sincronizar novamente seu catálogo pode ajudar você a tirar proveito das atualizações da Klaviyo para recursos relacionados a inventário e variantes.

Para sincronizar novamente seu catálogo:

1. Na Klaviyo, selecione a aba Integrações.
2. Selecione sua Magento 2 integrações na lista.
3. Clique na aba Dados.
4. Em Sincronizar dados do catálogo, clique em Sincronizar novamente.