Como configurar cupons para a Magento 1.x
A integração do Klaviyo com o Magento 1 não está mais aceitando novas instalações e chegará ao fim completo do suporte no fim de 2027. O suporte do Klaviyo não pode mais ajudar com solicitações relacionadas ao Magento 1.
O que você vai aprender
O Magento oferece suporte a Regras de preço do carrinho de compras que podem ser usadas para aplicar um desconto ao pedido de um cliente. É possível criar códigos de cupom para regras de preço existentes, para que os compradores possam usar facilmente um determinado código para aplicar um desconto durante o processo de checkout.
O recurso Cupons para Magento da Klaviyo permite que as lojas do Magento 1.0 façam o seguinte:
- Crie novos cupons na Klaviyo associados a regras de preço já existentes na Magento.
- Inclua cupons únicos em e-mails de fluxo, para que cada destinatário receba um código único.
Este guia vai explicar como fazer a configuração de cupons do Magento no Klaviyo.
No momento, códigos de cupom único não estão disponíveis ao enviar e-mails de campanha. Enviar códigos de cupom único em uma campanha exigiria gerar milhares de códigos por segundo. A Klaviyo não pode garantir que as configurações de limitação de taxa de um servidor específico do Magento não afetarão a geração de cupons únicos nesse volume e velocidade. Por isso, cupons únicos só estão disponíveis ao enviar e-mails de fluxo.
Requisitos
Como pré-requisito, verifique se você ativou a integração do Magento na Klaviyo e instalou a extensão da Klaviyo no Magento.
Habilitar a API REST
Comece ativando a API REST criando uma nova função REST e concedendo a ela acesso total e, em seguida, atribua a função a um dos seus usuários administradores.
- Clique em Sistema > Serviços Web > REST - Funções.
- Crie uma nova função de Administrador. No campo Nome da função, insira um nome, por exemplo "Administrador".
- Clique na guia Role API Resources à esquerda. Defina Resource Access como All e clique em Save Role.
- Em seguida, navegue até Sistema > Serviços Web > REST - Atributos.
- Selecione Administrador na lista de tipos de usuário.
- Defina Acesso ao recurso como Todos e clique em Salvar.
- Em seguida, navegue até Sistema > Permissões > Usuários.
- Selecione um usuário administrador na lista e clique em Editar usuário.
- Clique na guia Função REST na barra lateral esquerda.
- Clique no botão de opção para atribuir a nova função de admin REST ao seu usuário.
- Clique em Salvar usuário.
Agora você habilitou a API REST para sua loja Magento.
Se você não tiver certeza se a sua API REST está configurada corretamente, revise as etapas descritas em nosso recurso sobre solução de problemas de cupons para Magento 1x.
Gere credenciais REST no Magento
Para ativar o recurso Cupons do Magento da Klaviyo, primeiro gere credenciais da API REST na sua loja Magento usando a conta de administrador REST que você acabou de criar e, em seguida, cole-as na sua conta da Klaviyo.
- Faça login como o usuário administrador da REST que você criou na seção Ativar a API REST acima
- Clique em Sistema > Configuração e, em seguida, clique em Klaviyo na seção Clientes.
- Clique em Gerar tokens OAuth.
A Consumer Key, Consumer Secret, Authorization Token e o Authorization Secret serão preenchidos. Na próxima etapa, você vai copiar e colar esses valores na sua conta da Klaviyo.
Configurar cupons do Magento na Klaviyo
- Na sua conta Klaviyo, acesse sua integração com a Magento.
- Clique na seta Opções avançadas para expandir as Configurações de cupom.
- Cole as credenciais de REST que você criou acima.
Seu servidor Magento deve oferecer suporte a assinaturas HMAC-SHA1 para autenticação OAuth.
- Clique em Atualizar configurações do Magento.
A Klaviyo validará suas credenciais REST e você poderá começar a criar cupons com a aba Cupons da sua conta.
Crie um cupom do Magento na Klaviyo
Quando você acessar pela primeira vez a guia Cupons na sua conta da Klaviyo após fornecer suas credenciais REST, verá a mensagem: "Você ainda não adicionou nenhum cupom."
Antes de criar um novo cupom, primeiro você precisará definir uma Regra de preço no Magento que inclua todas as especificações do cupom. As Regras de preço não podem ser criadas na Klaviyo. Um novo cupom criado na Klaviyo deve fazer referência a uma Regra de preço já existente no Magento.
Ao criar uma regra de preço no Magento, observe que a opção de associar uma nova regra de preço a um cupom específico deve permanecer definida como Cupom específico, e a caixa de seleção Use Auto Generation deve estar marcada.
- Clique em Adicionar cupom para criar um novo cupom.
- Preencha as seguintes informações: Nome do cupom e o ID da regra do Magento.
- Nome do cupom: o nome que você especificar pode conter apenas letras, números e sublinhados e pode ter até 32 caracteres
- ID da regra do Magento: primeiro, crie uma regra no Magento e cole o ID dessa regra aqui para associá-la a este cupom
Todos os cupons criados aparecerão com os seguintes detalhes de visão geral:
- Nome do cupom: Nome do cupom
- Período ativo: há as seguintes opções:
- Com atividade, sem validade
- Data A - Sem expiração
- Data A - Data B
- com atividade, data de expiração B
- Data de criação: data em que o cupom foi criado
- Data da última atualização: data em que o cupom foi atualizado pela última vez
Os cupons podem ser editados e excluídos nesta guia pelo menu suspenso no lado direito.
Use um cupom em um e-mail de fluxo
Depois que um cupom é criado, você pode inseri-lo em um e-mail de fluxo usando a seguinte variável de placeholder. Você só pode adicionar um código de cupom por e-mail. Você pode exibir o mesmo código de cupom em vários lugares, mas não pode usar vários códigos.
{% coupon_code 'CouponName' %}Substitua CouponName pelo nome do seu cupom. Por exemplo:
Use cupons únicos em mensagens de SMS no fluxo
Cupons únicos também estão disponíveis para suas mensagens SMS/MMS em fluxos. Gere os códigos da mesma forma que faria para o e-mail. Depois, use a tag de modelo abaixo para adicionar o código de cupom à sua mensagem SMS ou MMS:
{% coupon_code 'CouponName' %}.
No snippet, altere CouponName para o nome do cupom que você quer e adicione-o à mensagem (no fluxo ou na campanha).
Ao contrário dos e-mails, você só pode usar um código de cupom por mensagem SMS. No e-mail, você tem a opção de usar blocos ocultos para enviar cupons diferentes com base no local onde alguém mora ou no que essa pessoa fez. Se você tentar adicionar vários cupons a uma mensagem SMS, verá uma mensagem de erro.
Solucionar erros
Mensagem de erro: “Não foi possível se conectar à API REST com as credenciais REST especificadas. Verifique se essas credenciais são válidas no seu admin do Magento."
Se você estiver vendo esta mensagem de erro no Klaviyo, há duas causas-raiz prováveis:
- Seu servidor Magento não está configurado para oferecer suporte a assinaturas HMAC-SHA1 para autenticação OAuth.
- Talvez você não tenha ativado o acesso completo de função para a API REST.
Para resolver esse problema, ative assinaturas HMAC-SHA1 para autenticação OAuth no seu servidor Magento. Em seguida, conclua as seguintes etapas para atualizar suas permissões de REST:
- Remova o comentário ou adicione a regra de reescrita no seu .htaccess arquivo .htaccess novamente. Esta é a linha em que você vai querer garantir que o comentário foi removido:
RewriteRule ^api/rest api.php?type=rest [QSA,L] - Verifique se a sua Função REST está configurada corretamente
Cobrimos as instruções para isso no nosso guia de configuração de cupom para Magento na seção vinculada aqui. - Outra causa comum é que vários módulos do Apache podem remover o cabeçalho “Authorization: Basic base64 (user:password)”.
Confira este post para mais informações
Os códigos de cupom inseridos em e-mails pelo Klaviyo não são exclusivos — todos os destinatários parecem estar recebendo o mesmo código.
Ao criar uma Regra de preço no Magento, a opção de associar uma nova Regra de preço a um cupom específico deve permanecer definida como Cupom específico, e você deve marcar a caixa de seleção “Usar geração automática”.
Clique na sua regra de preço no Magento e, em Informações gerais, role para baixo até a opção de linha "cupom" e altere essa configuração para "cupom específico". Em seguida, marque a caixa de seleção de geração automática aqui. Isso deve corrigir o problema e permitir que a gente gere um novo código de cupom único para cada destinatário de e-mail.