Conecte a VTEX à ActiveCampaign

Marketing_Plus_Professional_Enterprise

Use a integração ActiveCampaign VTEX para sincronizar contatos, visitas ao site e dados de compra da sua loja VTEX com a ActiveCampaign.

Tome nota

  • Você precisa de uma conta ActiveCampaign e uma conta VTEX para usar essa integração
  • Verifique se o ambiente VTEX no qual você pretende instalar o app está configurado com um host de site em "Loja" no https://{AccountName}.myvtex.com/admin/license-manager/#/account-details NOTA: caso veja uma tela em branco ao visitar essa página, você precisará solicitar o acesso de proprietário à conta VTEX (Super administrador) ou acesso ao "Gerenciador de licenças" na VTEX para verificar se o host está configurado
  • Verifique se você tem acesso aos "Dados mestres" no administrador da VTEX
  • Os contatos da VTEX sincronizados com a ActiveCampaign recebem a tag: VTEX-customer
  • Para sincronizar as informações de marketing opt-in, você deve criar na ActiveCampaign um campo de contato personalizado chamado "Aceita marketing". Você pode usar esse campo para sincronizar os dados da caixa de seleção "Quero receber a newsletter" do checkout da VTEX. Leia a seção "Criar um campo de contato personalizado na página Gerenciar campos" do artigo de ajuda Visão geral do campo de contato personalizado para saber como criar esse campo
  • As contas da ActiveCampaign criadas em ou após 8 de janeiro de 2024: os contatos sincronizados a partir da integração VETEX que verificaram 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 pelo ActiveCampaign, os contatos não serão adicionados a nenhuma lista. Para adicionar contatos a uma lista, você precisará criar uma automação
  • Algumas dessas configurações exigem a implementação de código. Nossa equipe de experiência do cliente não pode ajudar a criar ou solucionar problemas de código

Sobre a integração ActiveCampaign VTEX

As etapas de configuração da integração ActiveCampaign VTEX são feitas na sua conta VTEX. Quando todas as etapas abaixo estiverem concluídas em cada seção, os seguintes itens serão sincronizados com sua conta ActiveCampaign:

  • Visitas ao site (usa o Rastreamento de site da ActiveCampaign)
  • Dados de compra
  • Dados de carrinho abandonado
  • Dados do cliente
  • Dados do pedido
  • 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 do campo de contato personalizado na ActiveCampaign)

Todos os dados de compra e de carrinho abandonado aparecerão em uma caixa de ecommerce no registro do contato.

Com esses dados na sua conta, você pode usar a ActiveCampaign para:

  • Criar automações de carrinho abandonado usando o Gatilho de automação de carrinho abandonado e o Bloco de conteúdo de email de carrinho abandonado. Para obter mais informações, leia o artigo de ajuda "Visão geral de Deep Data de carrinho abandonado"
  • Personalizar de forma direta e automatizada com as informações de contato e de pedidos
  • Segmentar contatos por visitas ao site, dados de compra, dados de carrinho abandonado e muito mais

Conecte a VTEX à ActiveCampaign

Essa configuração é feita na sua conta VTEX.

  1. Instale o app activecampaignpartnerus.activecampaign no ambiente VTEX desejado. Para fazer isso, acesse Apps > App store no administrador VTEX. Selecione o app ActiveCampaign e clique em Instalar.
  2. Na conta do administrador da VTEX, acesse Apps > Meus apps e selecione a caixa ActiveCampaign.
  3. Quando estiver na página de configurações do app, defina as configurações do app:
    • Nome da conta da ActiveCampaign. O nome da sua conta está na página Configurações > Conta na ActiveCampaign. Por exemplo, se sua conta é xyz123.activehosted.com, você só precisa inserir na VTEX xyz123 como Nome da conta
    • URL e chave da API da ActiveCampaign
    • ConnectionID. Deixe este campo em branco
  4. Clique em "Salvar".
  5. Em seguida, localize o menu ActiveCampaign.
    • No administrador VTEX "mais antigo", ele está na barra lateral do administrador VTEX em Produtos
    • No administrador VTEX "mais recente", ele está no menu Apps em Apps instalados
  6. Clique em ActiveCampaign > Configuração do Connection ID
    • Clique em Configurar
    • Aguarde até que os campos sejam preenchidos
    • Clique na lista suspensa ID externo e selecione o ID da sua loja
    • Clique na lista suspensa URL do link e selecione o URL da loja 
    • Clique em Continuar configuração. Você verá a mensagem "A conta foi atualizada". A página será atualizada e exibirá a página Configurações do app. Seu ConnectionID agora está preenchido
  7. Clique em "Salvar".
  8. Clique em ActiveCampaign > Configuração de dados de compra
    • Tracking setAccountID - Insira o código de três letras da ISO para a moeda da sua loja (por exemplo, USD para dólares norte-americanos)
    • Enviar dados de compra (opcional)- Clique na caixa de seleção ao lado de Enviar dados de compra caso queira sincronizar os pedidos com a ActiveCampaign
      • Essa opção envia dados do cliente, incluindo o campo "accepts_marketing" (aceita marketing) e os dados do pedido, para a ActiveCampaign quando o cliente acessa a página Confirmação do pedido e caso o pagamento tiver sido recolhido. Se a ActiveCampaign não receber os dados do pedido, o pedido será enviado para a ActiveCampaign quando for faturado na VTEX
    • O preenchimento de pedidos não é sincronizado com a ActiveCampaign
  9. Clique em "Salvar". Você verá uma mensagem de confirmação.
  10. Clique em ActiveCampaign > Conexões.
    • Essas informações devem corresponder às Integrações conectadas na sua conta ActiveCampaign
    • Para confirmar isso, entre na sua conta ActiveCampaign e navegue até Configurações > Integrações. Você deve ver a mensagem "Sua integração foi conectada com sucesso" nesta página

Ative o Rastreamento de sites e coloque seu(s) domínio(s) na lista de permissões (opcional)

Essa integração usa a funcionalidade de Rastreamento de sites da ActiveCampaign. Você não precisa adicionar o código de rastreamento de site ao seu domínio.

No entanto, você precisa adicionar sua ID de rastreamento às configurações do app da VTEX em "Tracking setAccountID". A integração adiciona automaticamente o código de rastreamento de site para você. Você ainda precisa ativar a funcionalidade Rastreamento de site e colocar seu(s) domínio(s) na lista de permissões em Site > Página de rastreamento de site na sua conta ActiveCampaign. Para fazê-lo:

  1. Clique em Site na sua conta ActiveCampaign.
  2. Clique em Rastreamento de site.
  3. Clique na opção Rastreamento de site para colocar ela na posição "Ativada".
  4. Digite ou coloque seu domínio Web no campo URL do site e clique no botão Adicionar.
  5. Copie o número da ID setTrackAccount do snippet do código de rastreamento e cole ele nas configurações do app VTEX.

Configuração Sincronizar carrinho abandonado (opcional)

  Alguns dos termos listados nesta seção estão em português. Isso acontece porque o idioma português é utilizado no app VTEX. Este artigo usa a terminologia do app.

Essa integração sincroniza as informações do cliente, incluindo os dados de carrinho abandonado, com a ActiveCampaign. Você pode usar essas informações em emails para lembrar clientes sobre os carrinhos abandonados. Para permitir isso, você deve configurar um gatilho de carrinho abandonado na VTEX.

  1. No administrador da VTEX, acesse Dados mestres. Depois de fazer login nos Dados mestres:
    • Clique em Configurações avançadas
    • Clique em Estrutura de dados
    • Clique em Gatilho
    • Clique em Adicionar novo
  2. Preencha as informações da seguinte forma:
    • Nome - Gatilho ActiveCampaign
    • Entidade de dados - Cliente
    • Na aba Regras:
      • Regra do gatilho - O valor de um atributo foi 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 Agenda e defina quando a VTEX enviará os dados de carrinho abandonado para a ActiveCampaign. As opções são:
      • Executar o mais rápido possível - isso envia os dados para a ActiveCampaign em aproximadamente 45 minutos (veja a nota abaixo) após o cliente abandonar o carrinho. Se você usar essa configuração, dependendo de suas configurações na ActiveCampaign, o cliente poderá receber um email de carrinho abandonado mesmo que tenha feito o pedido
      • Agendar em data específica - essa configuração permite que você insira uma data específica para enviar os dados para a ActiveCampaign. Isso não é recomendado para emails de carrinho abandonado
      • Agendar em data dinâmica - esta configuração permite que você defina um período de tempo que antecederá o envio dos dados da VTEX para a ActiveCampaign (baseado na data da última sessão do cliente). NOTA: a maioria dos clientes escolhe essa opção e define o período de tempo para 2 horas após a última sessão

        Exemplo:
        VTEX_Example.png
        Conforme a documentação VTEX: "A sessão da página expira em 30 minutos. Somente após esse tempo, o sistema agenda o gatilho do carrinho abandonado. Em outras palavras, o tempo a ser considerado é o tempo da sessão + o horário do gatilho".

      • Depois de fazer a seleção da agenda, clique na aba Caso positivo. Em seguida, selecione ou insira o seguinte somente nestes campos: 
        • Ação - Envia uma solicitação HTTP
        • Em Solicitar dados:
          • URL - (insira o URL abaixo, substituindo www.yourwebsiteurl.com pelo URL do seu site) https://www.yourwebsiteurl.com/api/io/ActiveCampaign/abandonedCart
          • Método - Publicação
          • Cabeçalhos: Nome - Tipo de conteúdo
          • Cabeçalhos: Valor - app/json
          • Conteúdo como JSON - (substitua o conteúdo que está lá pelo conteúdo abaixo):
            {

            "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 Caso negativo
        • Nenhuma alteração é necessária aqui
        • Clique em Salvar

Sincronizar clientes (opcional)

Essa integração sincroniza todos os dados de clientes existentes na VTEX com a ActiveCampaign, incluindo o campo "accepts_marketing" (aceita marketing).

Antes de prosseguir com essa sincronização, verifique se suas automações, como emails de Boas-vindas, estão desativadas na ActiveCampaign. Para saber como desativar suas automações, visite o artigo de ajuda "Como definir automações como 'inativas' na ActiveCampaign".

Essa configuração é feita na sua conta VTEX.

  1. Clique em ActiveCampaign > Sincronizar clientes.
  2. Depois que a página carregar, clique em Sincronizar clientes.
  3. Depois de confirmar que suas automações estão desativadas na ActiveCampaign, clique em Continuar sincronização.

A mensagem "A sincronização de clientes foi iniciada" aparecerá na página.

Sincronizar pedidos (opcional)

Isso sincroniza todo o histórico de dados de pedidos da VTEX para a ActiveCampaign. Antes de prosseguir com essa sincronização, verifique se as automações estão desativadas na ActiveCampaign.

Essa configuração é feita na sua conta VTEX.

  1. Clique em ActiveCampaign > Sincronizar pedidos.
  2. Depois de confirmar que suas automações estão desativadas na ActiveCampaign, clique em Sincronizar todos os pedidos.
  3. Uma caixa de diálogo será exibida. Nela, você pode selecionar a data de início da sincronização no calendário. Por exemplo, você pode querer sincronizar apenas os últimos seis meses de dados ao invés de todo o histórico de pedidos.
    VTEX_dialogue_box.jpeg
  4. Clique em Continuar sincronização.
  5. A mensagem "A sincronização de pedidos foi iniciada" aparecerá na página.
    • Os pedidos feitos a partir da sua data de início até a data atual serão sincronizados
    • Os dados serão sincronizados com a ActiveCampaign na velocidade de 1.000 a 1.500 pedidos por hora

Além de sincronizar todos os pedidos, você pode escolher por sincronizar pedidos individuais manualmente. Para fazê-lo:

  1. Insira a ID do pedido que quer sincronizar na caixa de pesquisa na parte superior da página e clique em Inserir.
  2. Clique na caixa de seleção ao lado do pedido que quer sincronizar.
  3. Depois de confirmar que suas automações estão desativadas na ActiveCampaign, clique em Sincronizar pedidos selecionados.

A mensagem "A sincronização de pedidos foi iniciada" será exibida.

Esse artigo foi útil?
Usuários que acharam isso útil: 2 de 2