Como configurar cupons (para Magento 1.x)

O que você vai aprender

O Magento oferece suporte às regras de preço do carrinho de compras que podem ser usadas para aplicar um desconto ao pedido de um cliente. Os códigos de cupom podem ser criados para regras de preços existentes, de modo que os compradores possam aproveitar facilmente um determinado código para aplicar um desconto durante o processo de checkout.

O recurso Coupons for Magento da Klaviyo permite que as lojas do Magento 1.0 façam o seguinte:

• Criar novos cupons no Klaviyo associados a regras de preço pré-existentes no Magento.
• Inclua cupons dinâmicos nos e-mails de fluxo, para que cada destinatário receba um código exclusivo.

Este guia explicará como configurar os cupons do Magento no Klaviyo.

Requisitos

Como pré-requisito, certifique-se de que o senhor ativou a integração do Magento no Klaviyo e instalou a extensão do Klaviyo no Magento.

Ativar a API REST

Comece ativando a API REST criando uma nova função REST e concedendo a ela acesso total e, em seguida, atribuindo a função a um dos usuários administradores.

1. Clique em System > Web Services > REST - Roles.
2. Crie uma nova função de administrador. No campo Role Name, digite um nome, por exemplo, "Administrator".
3. Clique na guia Role API Resources (Recursos da API de função ) à esquerda. Defina Resource Access como All e clique em Save Role.
4. Em seguida, navegue até System > Web Services > REST - Attributes (Sistema Serviços da Web REST - Atributos).
5. Selecione Admin na lista de tipos de usuários.
6. Defina Resource Access como All e clique em Save.
7. Em seguida, navegue até System > Permissions > Users.
8. Selecione um usuário administrador na lista e clique em Edit user (Editar usuário).
9. Clique na guia da função REST na barra lateral esquerda.
10. Clique no botão de opção para atribuir a nova função de administrador REST ao seu usuário.
    
11. Clique em Save User (Salvar usuário).

Agora o senhor ativou a REST API para sua loja Magento.

Gerar credenciais REST no Magento

Para ativar o recurso Magento Coupons da Klaviyo, primeiro gere as credenciais da API REST da sua loja Magento usando a conta de administrador REST que você acabou de criar e, em seguida, cole-as na sua conta da Klaviyo.

1. Faça login como o usuário administrador REST que criou na seção Habilitar a API REST acima
2. Clique em System > Configuration e, em seguida, clique em Klaviyo na seção Customers (Clientes ).
3. Clique em Generate OAuth Tokens (Gerar tokens OAuth).

A chave do consumidor, o segredo do consumidor, o token de autorização e o segredo de autorização serão preenchidos. O senhor copiará/colará esses valores na sua conta Klaviyo na próxima etapa.

Configurar cupons do Magento no Klaviyo

1. Em sua conta Klaviyo, navegue até a integração com o Magento.
2. Clique na seta Advanced Options (Opções avançadas ) para expandir as Coupon Settings (Configurações de cupom).
3. Cole as credenciais REST que o senhor criou acima.

   Seu servidor Magento deve suportar assinaturas HMAC-SHA1 para autenticação OAuth.

   

4. Clique em Update Magento Settings (Atualizar configurações do Magento).

A Klaviyo validará suas credenciais REST e o senhor poderá começar a criar cupons na guia Coupons da sua conta.

Criar um cupom Magento no Klaviyo

Quando o senhor navegar pela primeira vez até a guia Coupons (Cupons ) em sua conta Klaviyo após fornecer suas credenciais REST, verá a mensagem: "You haven't added any coupons yet." 

1. Clique em Add Coupon (Adicionar cupom ) para criar um novo cupom.
2. Preencha as seguintes informações: Nome do cupom e ID da regra do Magento.

• Nome do cupom: O nome que o senhor especificar pode consistir apenas de letras, números e sublinhados e pode ter até 32 caracteres
• ID da regra do Magento: crie uma regra no Magento primeiro e cole o ID dessa regra aqui para associá-la a esse cupom

Todos os cupons criados serão exibidos com os seguintes detalhes de visão geral:

• Nome do cupom: Nome do cupom
• Período de tempo ativo: Existem as seguintes opções:
  • Ativo, sem prazo de validade
  • Data A - Sem vencimento
  • Data A - Data B
  • Ativo, 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 nessa guia por meio do menu suspenso no lado direito.

Use um cupom do Magento em um e-mail de fluxo

Depois que um cupom é criado, o senhor pode inseri-lo em um e-mail de fluxo usando a seguinte variável de espaço reservado. O senhor só pode adicionar um código de cupom por e-mail. O senhor pode exibir o mesmo código de cupom em vários locais, mas não pode usar vários códigos.

{% coupon_code 'CouponName' %}

Substitua CouponName pelo nome do seu cupom. Por exemplo:

Use cupons exclusivos em mensagens de fluxo de SMS

Cupons exclusivos também estão disponíveis para suasmensagens SMS/MMS em fluxos. Gere os códigos da mesma forma que o senhor faria para o e-mail. Em seguida, use a tag de modelo abaixo para adicionar o código do cupom à sua mensagem SMS ou MMS:

{% coupon_code 'CouponName' %}.

No snippet, altere CouponName para o nome do cupom que o senhor deseja e adicione-o à mensagem (fluxo ou campanha).

Diferentemente dos e-mails, o senhor só pode usar um código de cupom por mensagem SMS. Com o e-mail, o senhor tem acesso a blocos ocultos para enviar cupons diferentes com base no local onde a pessoa mora ou no que ela fez. Se o senhor tentar adicionar vários cupons a uma mensagem SMS, verá uma mensagem de erro.

Solução de problemas de erros

Mensagem de erro: "Não foi possível conectar-se à API REST com as credenciais REST especificadas. Verifique se essas credenciais são válidas em seu administrador do Magento."

Se o senhor estiver vendo essa mensagem de erro no Klaviyo, há duas causas prováveis:

1. Seu servidor Magento não está configurado para suportar assinaturas HMAC-SHA1 para autenticação OAuth.
2. O senhor pode não ter ativado o acesso total à função para a API REST.

Para resolver esse problema, ative as assinaturas HMAC-SHA1 para a autenticação OAuth em seu servidor Magento. Em seguida, conclua as etapas a seguir para atualizar suas permissões REST:

1. Descomente ou adicione a regra de reescrita em seu .htaccess arquivo. Essa é a linha que o senhor deve garantir que não esteja comentada:
   RewriteRule ^api/rest api.php?type=rest [QSA,L]
2. Verifique novamente se a função REST está configurada corretamente
   Abordamos as instruções para isso em nosso guia de configuração de cupons para o Magento na seção vinculada aqui.
3. Outra causa comum é que vários módulos do Apache podem remover o cabeçalho "Authorization: Basic base64 (user:password)".
   Confira esta postagem para obter mais informações

Os códigos de cupom inseridos nos e-mails pela 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 ser deixada definida como Cupom específico e o senhor deve ter a caixa de seleção "Usar geração automática" marcada.

Clique em sua Price Rule no Magento e, em General Information (Informações gerais), role para baixo até a opção de linha "Coupon" e altere essa configuração para "Specific Coupon". Em seguida, marque a caixa para geração automática aqui. Isso deve corrigir o problema e nos permitir gerar um novo código de cupom exclusivo para cada destinatário de e-mail.