Como fazer a integração com o Recurly
O que você vai aprender
Saiba como integrar o Recurly com a Klaviyo para personalizar e segmentar e-mails com base em dados de fatura e pagamento dos seus clientes. A Klaviyo sincroniza os seguintes dados da Recurly:
- Quando uma fatura é emitida e os itens incluídos em cada fatura
- Informações de pagamento para quando um cliente falha no pagamento, é reembolsado ou paga com sucesso
- Propriedades do perfil associadas às informações do Recurly
Integrar a Recurly com a Klaviyo.
Você precisa de permissão para gerenciar integrações no Klaviyo e de acesso de desenvolvedor ou administrador no Recurly para recuperar sua chave de API privada.
- Para integrar o Recurly ao Klaviyo, você vai precisar da sua chave de API do Recurly. Então, comece fazendo login na sua conta do Recurly.
- Acesse integrações > Credenciais de API.
- Copie a chave de API privada em Chave de API padrão para usar mais tarde.
As chaves de API privadas, como sua chave padrão usada aqui, devem ser tratadas como senhas; mantenha-as em um local seguro e nunca as exponha ao público.
- Se a sua chave de API padrão já estiver em uso com outra integração de terceiros, você pode gerar uma nova chave de API privada para a integração do Klaviyo clicando em Adicionar chave de API privada.
A Recurly só vai gerar 5 chaves de API privadas para integrar com aplicativos de terceiros.
- Se você criou uma nova chave de API, copie-a para usar na sua conta Klaviyo.
- Na sua conta da Klaviyo, selecione a aba Integrações.
- Clique em Explorar apps para abrir o marketplace de apps em uma nova guia. Procure por Recurly, selecione o cartão e depois clique em Instalar.
- Insira seu subdomínio do Recurly e a chave de API que você copiou anteriormente e, em seguida, clique em Conectar ao Recurly. Por exemplo, insira “yoursubdomain” em https://yoursubdomain.recurly.com.
- Se a integração for bem-sucedida, uma mensagem de sucesso vai aparecer e seus dados históricos vão começar a sincronizar. Você pode acompanhar o progresso da sincronização na aba Dados da sua integração Recurly.
Monitore a sincronização do Recurly
A Klaviyo importa faturas e pagamentos dos últimos 1.825 dias (cerca de 5 anos) quando você conecta a Recurly. As novas faturas e pagamentos são sincronizados a cada 5 minutos, aproximadamente. Faturas e pagamentos de contas da Recurly sem um endereço de e-mail válido são ignorados.
- No Klaviyo, clique no menu suspenso Análises e selecione Métrica.
- Procure por Issued Invoice com o ícone do Recurly, clique no nome da métrica e selecione a guia Feed de atividades.
- Se a sua integração começou a sincronizar dados, você vai começar a ver eventos de Issued Invoice, com o ícone do Recurly, adicionados a este feed de atividades.
- Para comparar os totais de pagamento, volte para Análises > Métricas e abra Pago com sucesso com o ícone do Recurly.
- Na aba Gráfico, escolha um Intervalo de datas que inclua o dia que você quer verificar. Defina Ver por como Diário e Medição como Total.
- Compare o total desse dia com o número de pagamentos bem-sucedidos no Recurly na mesma data. Espere a sincronização histórica terminar antes de verificar datas anteriores.
- Se os totais forem diferentes, verifique se a sincronização foi concluída, se os pagamentos têm endereços de e-mail de cliente válidos e se as suas contas do Klaviyo e do Recurly usam o mesmo fuso horário.
- Para verificar a configuração de fuso horário na Klaviyo:
- Clique no nome da sua conta no canto inferior esquerdo.
- Selecione Configurações.
- Selecione Conta e role a tela até Fuso horário.
Dados sincronizados do Recurly para a Klaviyo
Métricas
A Recurly sincroniza as seguintes métricas com o Klaviyo:
- Pagamento com falha
Registrado sempre que um pagamento feito pelo Recurly é marcado como falho. - Fatura emitida
Registrada sempre que uma fatura é emitida para um cliente pelo Recurly. - Produto pedido
Registrado para itens em uma fatura quando um cliente faz um pagamento bem-sucedido pelo Recurly. Um pagamento pode gerar vários eventos de Produto pedido. - Pagamento reembolsado
Registrado quando você reembolsa um pagamento pelo Recurly. - Pago com sucesso
Registrado sempre que um cliente paga uma fatura com sucesso pelo Recurly.
Propriedades do perfil
As seguintes propriedades são sincronizadas do Recurly para os perfis da Klaviyo:
- Código da conta Recurly
- Data de validade do cartão Recurly
- Códigos de Plano do Recurly
- Planos do Recurly
Planos do Recurly e Códigos de plano do Recurly são preenchidos a partir de assinaturas com atividade quando os dados de pagamento são sincronizados. Data de vencimento do cartão do Recurly é preenchida quando os detalhes de cobrança incluem o mês e o ano de vencimento.
Resultado
Você terminou de integrar o Recurly ao Klaviyo e verificou os dados sincronizados. Agora, você pode personalizar e segmentar e-mails com base nos dados de fatura e pagamento dos seus clientes.
Recursos adicionais
- Getting started with flows
Learn how to use flows, also known as automations or drip campaigns, in Klaviyo for personalized and automated communications to your customers, and learn how to set your first flow live.
- Getting started with segments
Learn how to create and use segments in Klaviyo, which are a powerful tool for understanding your audience and sending targeted messages.
- Understanding the types of information exchanged between Klaviyo and apps
Learn about what types of data are exchanged between Klaviyo and external apps, and where that data is found in your Klaviyo account. When you integrate a third-party application with Klaviyo, the two platforms exchange information. Most data exchange with Klaviyo is one-way; data is pulled into your Klaviyo account so you can leverage a broad scope of your customers' data within Klaviyo.