Use a integração da ActiveCampaign com a VTEX para sincronizar contatos, visitas ao site e dados de compras da loja VTEX com a ActiveCampaign.
Importante
- Você precisa ter uma conta da ActiveCampaign e uma conta VTEX com a VTEX IO para usar essa integração.
- Verifique se o ambiente VTEX onde você pretende instalar o app está configurado com um host de site em "Loja" em https://{AccountName}.myvtex.com/admin/license-manager/#/account-details. OBSERVAÇÃO: se você acessar essa página e encontrar uma tela em branco, será necessário solicitar acesso de "Proprietário (Superadministrador)" à conta VTEX ou acesso às telas do "Gerenciador de Licenças" na VTEX para confirmar se o host está configurado.
- Verifique se você tem acesso aos "Dados mestre" no administrador da VTEX.
- Contatos sincronizados entre a ActiveCampaign e a VTEX recebem a tag "VTEX-customer".
- Para sincronizar informações de adesão ao marketing com a ActiveCampaign, é necessário criar um campo personalizado de contato na ActiveCampaign chamado "Aceita marketing". Use esse campo para sincronizar os dados da caixa de seleção "Quero receber a newsletter" do checkout da VTEX. Leia a seção "Crie um campo de contato personalizado a partir da página 'Gerenciar campos'" do artigo de ajuda Visão geral do campo de contato personalizado para aprender a criar esse campo.
- Contas da ActiveCampaign criadas em 8 de janeiro de 2024 ou depois: os contatos sincronizados da integração com a VTEX que marcaram a caixa de seleção "Quero receber a newsletter" serão adicionados à lista de contatos mestre por padrão. Se você excluir ou alterar o nome da lista de contatos mestre criada pela ActiveCampaign, os contatos não serão adicionados a nenhuma lista. Para adicionar contatos a uma lista, você precisará criar uma automação.
- Parte dessa configuração requer a implementação de código. Nossa equipe de Experiência do Cliente não pode ajudar você a criar ou solucionar problemas de código.
Sobre a integração entre ActiveCampaign e VTEX
As etapas de configuração da integração entre ActiveCampaign e VTEX ocorrem na conta VTEX. Depois de concluir todas as etapas em cada seção abaixo, estes serão os itens sincronizados com sua conta da ActiveCampaign:
- Visitas ao site (usa o rastreamento de site da ActiveCampaign)
- Dados de compra
- Dados de carrinho abandonado
- Dados de clientes
- Dados de pedidos
- Dados de formulário (usando uma barra flutuante, caixa flutuante OU formulário modal criado na ActiveCampaign)
- Dados da caixa de seleção "Quero receber a newsletter" do checkout da VTEX para facilitar a conformidade com o RGPD (requer a configuração de um campo de contato personalizado na ActiveCampaign)
Todos os dados de compras e carrinho abandonado aparecerão na caixa "Ecommerce" no registro de contato.
Quando esses dados estiverem em sua conta, será possível usar a ActiveCampaign para:
- Criar automações de carrinho abandonado usando o gatilho de automação "Carrinho abandonado" e o bloco de conteúdo de email "Carrinho abandonado". Para mais informações, leia o artigo de ajuda "Visão geral de deep data de carrinhos abandonados".
- Personalize as modalidades direta e automatizada com informações de contato e pedidos.
- Segmente contatos por visitas ao site, dados de compra, dados de carrinho abandonado e muito mais.
Conectar o VTEX à ActiveCampaign
Essa configuração precisa ser feita na conta VTEX.
- Instale o app activecampaignpartnerus.activecampaign no ambiente da VTEX em questão. Para fazer isso, acesse Apps > App Store no administrador da VTEX. Selecione o app da ActiveCampaign e clique em "Instalar".
- Na conta de administrador da VTEX, acesse Apps > Meus apps e marque a caixa da ActiveCampaign.
-
Defina as configurações do app quando estiver na página relacionada:
- Nome da conta da ActiveCampaign. O nome da conta está na página Configurações > Conta na ActiveCampaign. Por exemplo, se a conta é xyz123.activehosted.com, insira apenas "xyz123" como nome da conta na VTEX.
- Chave da ActiveCampaign. Consulte URL e chave da API para saber mais.
- ID de rastreamento setAccount: deixe este campo em branco por enquanto.
- ConnectionID. Deixe este campo em branco.
- Clique em "Salvar".
- Em seguida, localize o menu da ActiveCampaign.
- No "antigo" administrador da VTEX, o menu fica na barra lateral abaixo de "Produtos".
- No "novo" administrador da VTEX, está no menu suspenso "Apps", em "Apps instalados".
-
Clique em ActiveCampaign > Configuração do ID de conexão.
- Clique em "Configurar".
- Aguarde até que os campos sejam preenchidos.
- Clique no menu suspenso do ID externo e selecione o ID da loja.
- Clique no menu suspenso da URL do link e selecione a URL da loja.
- Clique em "Continuar configuração". A mensagem "A conta foi atualizada" será exibida. A página será atualizada e exibirá as "Configurações do app". ConnectionID agora está preenchido.
- Clique em "Salvar".
-
Clique em ActiveCampaign > Configuração de dados de compra.
- Moeda: insira o código ISO de moeda com três letras da loja (como "USD" para o dólar norte-americano).
-
Enviar dados de compra (opcional): marque a caixa de seleção ao lado de "Enviar dados de compra?" se quiser sincronizar pedidos com a ActiveCampaign.
- Essa opção envia dados do cliente, incluindo o campo "accepts_marketing" e dados do pedido, para a ActiveCampaign quando a pessoa chega à página de confirmação do pedido e se o pagamento foi capturado. Se a ActiveCampaign não receber os dados do pedido, o pedido será enviado à ActiveCampaign quando for faturado na VTEX.
- Solicitações de processamento de pedidos não são sincronizadas com a ActiveCampaign.
- Clique em "Salvar". Uma mensagem de confirmação será exibida.
-
Clique em ActiveCampaign > Conexões.
- Essas informações precisam ser iguais as das integrações conectadas à conta da ActiveCampaign.
- Para confirmar, faça login na conta da ActiveCampaign e acesse Configurações > Integrações. O logotipo da VTEX e o status "Conectado" devem aparecer nessa página.
Ativar o rastreamento de site e colocar seus domínios na lista de permissões (opcional)
Essa integração usa a funcionalidade de rastreamento de site da ActiveCampaign. Não é necessário adicionar o código de rastreamento ao seu site.
No entanto, você precisa adicionar seu ID de rastreamento às configurações do app da VTEX em "ID de rastreamento setAccount". A integração adiciona automaticamente o código de rastreamento de site. Você ainda precisa ativar a funcionalidade de rastreamento de site e adicionar seus domínios à lista de permissões na página Site > Rastreamento de site em sua conta da ActiveCampaign. Para fazer isso:
- Clique em "Site" na conta da ActiveCampaign.
- Clique em "Rastreamento de site".
- Clique no botão de opção "Rastreamento de site" para ativar a funcionalidade.
- Digite ou cole seu domínio da web no campo "URL do site" e clique no botão "Adicionar".
- Copie o número do ID setTrackAccount do snippet do código de rastreamento e cole nas configurações do app da VTEX.
Configurar a sincronização do carrinho abandonado (opcional)
Alguns dos termos indicados nesta seção estão em português porque esse idioma é usado no app da VTEX. Este artigo reflete a terminologia do app. Em áreas onde a VTEX às vezes traduz para o inglês, adicionamos os termos equivalentes abaixo entre colchetes [ ] para referência.
Esta integração sincroniza informações do cliente com dados de carrinho abandonado para a ActiveCampaign. É possível usar essas informações para enviar emails e lembrar seus clientes sobre carrinhos abandonados. Para isso, configure um gatilho de carrinho abandonado na VTEX.
- No administrador da VTEX, acesse os Dados mestre. Depois de fazer login nos Dados mestre:
- Clique em "Configurações avançadas".
- Clique em "Estrutura de dados".
- Clique em "Gatilho".
- Clique em "Adicionar novo".
- Preencha as informações da seguinte maneira:
- Nome: gatilho da ActiveCampaign
- Entidade de dados: cliente
- Na aba "Regras":
- Regra do gatilho: quando o valor de um atributo for alterado
- Campo: Última sessão
-
Clique em "Adicionar filtro" e selecione ou insira:
- Checkout
- Diferente
- Finalizado
-
Clique em "Adicionar filtro" e selecione ou insira:
- Checkout
- Não está nulo
-
Clique em "Adicionar filtro" e selecione ou insira:
- Carrinho
- Não está nulo
-
Clique em "Adicionar filtro" e selecione ou insira:
- Último carrinho
- Não está nulo
-
Clique na aba "Agendar" e escolha quando a VTEX enviará os dados de carrinho abandonado para a ActiveCampaign. As opções são:
- O mais rápido possível. Os dados serão enviados para a ActiveCampaign em cerca de 45 minutos (consulte a observação abaixo) após o cliente abandonar o carrinho. Se você usar essa configuração, dependendo das definições na ActiveCampaign, o cliente poderá receber um email de carrinho abandonado mesmo se tiver feito um pedido.
- Agendar em data específica. Essa configuração permite inserir uma data específica para enviar os dados à ActiveCampaign. Isso não é recomendado para emails de carrinho abandonado.
-
Agendar em data dinâmica. Essa configuração permite definir um período antes da VTEX enviar os dados à ActiveCampaign com base na última sessão do cliente (Data da última sessão). OBSERVAÇÃO: a maioria dos clientes escolhe essa opção e a define para duas horas após a última sessão.
Exemplo:
Conforme a documentação da VTEX: "A sessão da página expira em 30 minutos. Somente após esse período o sistema agenda o gatilho do carrinho abandonado. Em outras palavras, o tempo a ser considerado é o tempo da sessão + o agendamento do gatilho."
- Depois de fazer sua seleção de agendamento, clique na aba Se positivo. Em seguida, selecione ou insira o seguinte apenas nestes campos:
- Ação: enviar uma solicitação HTTP.
- Em "Solicitar dados":
- URL: (insira a URL abaixo substituindo www.yourwebsiteurl.com pela URL do seu site. NÃO inclua espaços nesse campo). https://www.yourwebsiteurl.com/api/io/activeCampaign/abandonedCart
- Método: POST.
- Cabeçalhos: nome – Conteúdo, tipo.
- Cabeçalhos: valor – App/JSON.
-
Conteúdo como JSON: substitua o conteúdo que está lá por:
{
"rclastcart": "{!rclastcart}",
"rclastcartvalue": "{!rclastcartvalue}",
"rclastsession": "{!rclastsession}",
"rclastsessiondate": "{!rclastsessiondate}",
"email": "{!email}",
"userId": "{!userId}",
"firstName": "{!firstName}",
"lastName": "{!lastName}",
"localeDefault": "{!localeDefault}",
"id": "{!id}",
"accountId": "{!accountId}",
"accountName": "{!accountName}",
"dataEntityId": "{!dataEntityId}",
"createdBy": "{!createdBy}",
"createdIn": "{!createdIn}",
"updatedBy": "{!updatedBy}",
"updatedIn": "{!updatedIn}",
"lastInteractionBy": "{!lastInteractionBy}",
"lastInteractionIn": "{!lastInteractionIn}"
}
- Em "Ação de resposta":
- Entidade de dados: cliente.
- Parâmetros: nome – Anexo.
-
Clique na aba "Se negativo".
- Nenhuma mudança é necessária.
- Clique em "Salvar".
Sincronizar clientes
Essa integração sincroniza todos os dados de clientes da VTEX com a ActiveCampaign, incluindo o campo "accepts_marketing".
Antes de prosseguir com essa sincronização, verifique se suas automações, como "Emails da série de boas-vindas", estão desativadas na ActiveCampaign. Para saber como desativar suas automações, acesse o artigo de ajuda Como definir as automações como "Ativa" ou "Inativa" na ActiveCampaign.
Essa configuração precisa ser feita na conta VTEX.
- Clique em ActiveCampaign > Sincronização de clientes.
- Depois que a página for carregada, clique em "Sincronizar clientes".
- Após confirmar que as automações estão desativadas na ActiveCampaign, clique em "Continuar sincronização".
A mensagem "A sincronização de cliente foi iniciada" aparecerá na página.
Sincronizar pedidos (opcional)
Essa funcionalidade sincroniza todos os dados históricos de pedidos da VTEX com a ActiveCampaign. Antes de prosseguir, verifique se suas automações estão desativadas na ActiveCampaign.
Essa configuração precisa ser feita na conta VTEX.
- Clique em ActiveCampaign > Sincronização de pedidos.
- Após confirmar que as automações estão desativadas na ActiveCampaign, clique em "Sincronizar todos os pedidos".
- Será exibida uma caixa de diálogo onde você pode selecionar a data no calendário que quer usar como início da sincronização. Por exemplo, talvez você queira sincronizar apenas os últimos seis meses de dados em vez de todos os pedidos históricos feitos.
- Clique em "Continuar sincronização".
- A mensagem "A sincronização de pedidos foi iniciada" será exibida na página.
- Pedidos realizados a partir da sua data de início até a data atual serão sincronizados.
- Cerca de 1.000 a 1.500 dados de pedidos serão sincronizados com a ActiveCampaign por hora.
Além de sincronizar todos os pedidos, você pode optar por sincronizar cada pedidos manualmente. Para fazer isso:
- Digite o ID do pedido que você quer sincronizar na caixa de pesquisa na parte superior da página e clique em Enter.
- Clique na caixa de seleção ao lado do pedido que você quer sincronizar.
- Após confirmar que as automações estão desativadas na ActiveCampaign, clique em "Sincronizar os pedidos selecionados".
A mensagem "A sincronização de pedidos foi iniciada" será exibida.