Referência de requisitos do sistema de integrações do Magento
O que você vai aprender
Saiba mais sobre os requisitos do sistema para uma sincronização ideal com o Magento 1 ou 2. O administrador da sua loja Magento é responsável pelas especificações e configurações do sistema. Garantir que seu sistema esteja configurado para funcionar com o Klaviyo vai permitir uma experiência de integração tranquila.
Configurar permissões de usuário da API
No processo de integrar sua loja Magento ao Klaviyo, você criará uma nova função SOAP (para Magento 1) ou REST (para Magento 2) com acesso total aos recursos e atribuirá um novo usuário a essa função. Verifique se Acesso a recursos está definido como Todos.
Sem as permissões necessárias para esse usuário de API, o Klaviyo não conseguirá interagir corretamente com as APIs da sua loja Magento, o que impedirá a integração de recuperar dados da sua loja.
Ative o acesso aos pontos de extremidade de API necessários
A Klaviyo solicita dados de pontos de extremidade específicos. As configurações do seu sistema precisam permitir o acesso a esses pontos de extremidade; considere o impacto de controles de segurança ou da lógica de redirecionamento de URL na acessibilidade desses pontos de extremidade para a Klaviyo. Se a Klaviyo não tiver acesso aos pontos de extremidade de API esperados, alguns ou todos os dados do Magento não poderão ser sincronizados e você verá relatórios de erro no aplicativo.
Todo o tráfego de integrações de saída do Klaviyo fica por trás de um conjunto de endereços IP estáticos e previsíveis, para que você tenha um alto nível de confiança de que esse tráfego está vindo do Klaviyo; recomendamos adicionar esses endereços à allowlist.
Capacidade do sistema para solicitações de API de sincronização de dados históricos
Quando você ativa a integração, a Klaviyo automaticamente coloca na fila as solicitações de API para sincronizar dados históricos, incluindo registros de clientes, registros de pedidos e o catálogo de produtos. Tentamos fazer isso rapidamente para permitir que profissionais de marketing usem esses dados em suas contas o mais rápido possível. Também tentamos fazer isso de forma responsável, limitando a simultaneidade e lidando com novas tentativas de forma adequada. Se a sua loja tiver um grande volume de dados históricos, capacidade limitada de recursos ou outros aplicativos que façam solicitações substanciais de API, recomendamos consultar o administrador do Magento para garantir que sua infraestrutura esteja preparada para oferecer suporte à sincronização de dados históricos. Seu administrador pode considerar aumentar temporariamente os recursos ou aplicar o dimensionamento automático.
Se você tiver preocupações com o volume de dados históricos ou com a capacidade do servidor de lidar com um aumento temporário de solicitações de API para buscar esses dados, considere aumentar temporariamente os recursos do servidor e aplicar escalonamento automático.
Verificar a validade do certificado SSL
Um certificado SSL autentica digitalmente a identidade de um site e permite uma conexão criptografada entre um navegador e um servidor web. O certificado SSL do seu site é hospedado pelo servidor de origem do site. Um certificado SSL válido é essencial para aceitar pagamentos com segurança, proteger logins com senha e proteger formulários web. Esta ferramenta pode ser usada para verificar o certificado SSL de um site.
As integrações do Magento podem ser desativadas se o certificado SSL do seu site expirar. Nesse caso, o domínio e os certificados intermediários precisam ser atualizados no provedor de hospedagem. Se você não tiver certeza de onde seus certificados estão, entre em contato com seu provedor de hospedagem para obter ajuda
Alocação de memória do servidor suficiente
A quantidade de espaço em disco necessária para um site de e-commerce depende de vários fatores, incluindo o número de produtos, o número de imagens de cada produto, a qualidade das imagens, o número de e-mails armazenados no servidor e as páginas de conteúdo estático.
Recomendamos que você aloque mais de 1 gigabyte de memória para suas integrações do Klaviyo, mas 512 megabytes é o mínimo exigido. Se o seu servidor não conseguir alocar recursos suficientes para responder às solicitações do Klaviyo, ocorrerão erros de integração. A integração Klaviyo-Magento começa com uma sincronização de dados históricos, então é recomendável que você verifique as configurações de memória no Magento e no seu servidor antes de ativar a integração.
A configuração padrão de memória do PHP do Magento é de 128 megabytes. Essa configuração pode ser atualizada no arquivo php.ini, alterando o valor da variável "memory_limit" para os 1.024 megabytes recomendados.
Defina o fuso horário como UTC
O Tempo Universal Coordenado, ou UTC, é o principal padrão de tempo do mundo desde a década de 1960. A Klaviyo usa UTC para agendar sincronizações dos seus dados mais recentes.
Se a sua instância do Magento usar um fuso horário diferente, ficará mais difícil para a Klaviyo determinar quais dados são mais recentes e devem ser sincronizados. Seu fuso horário deve ser atualizado para UTC tanto no back-end do Magento quanto nos arquivos app/Mage.php e app/code/local/Mage/Core/Model/Locale.php.
Recursos adicionais
- Getting started with Magento 2.x (CE and EE)
Learn how to integrate Klaviyo with your Magento 2 CE or EE store. You'll need to install the Klaviyo extension in Magento, configure the extension and set up OAuth, then enable the integration in Klaviyo. This guide covers all required integration steps, as well as how to confirm your historical data sync is successful.