Skip to content

Latest commit

 

History

History
204 lines (150 loc) · 8.77 KB

rdstation_js_integration.md

File metadata and controls

204 lines (150 loc) · 8.77 KB

Integrações RD Station

Como instalar o script para integração com formulário

Essa é a integração mais simples de ser feita. Basta adicionar o script diretamente na página do seu formulário, assim como o Google Analytics.

Os seus formulários irão para o RD Station com um identificador. Identificador é o nome do evento, por exemplo, cadastro, newsletter, formulário de orçamento, contato, entre outros, que irá aparecer na conversão do Lead no seu RD Station.

Funcionamento

O componente integrador irá identificar automaticamente seu formulário se ele possuir um campo (input) com o nome email:

<input type="text" name="email" />

Se o seu formulário possui o input mencionado, com atributo name="email", siga os passos abaixo para integrar seu formulário.

Passo a passo para a integração

Para realizar a integração você deve inserir o script abaixo na página que contém o formulário, seguindo esses passos:

1 - Acessar a página do RD Station de geração de script para formulários: Formulários;

2 - Preencher o campo Nome do Formulário que corresponderá ao identificador das conversões;

3 - Clicar no botão Gerar Script; O script será logo em seguida gerado em uma seção abaixo;

4 - Clicar no botão Copiar ou copiar o script gerado;

5 - O script deve ser colado no html da página do formulário, logo antes do fechamento da tag:

</body>

6 - Pronto! Seu formulário está integrado! Todas as submissões serão enviadas como conversões ao RD Station. Recomendamos o teste do formulário para conferimento da integração.

Passo a passo para criação do script manualmente

Caso deseje gerar o script manualmente, os seguintes passos podem ser executados:

1 - Inserir seu token RD Station onde diz 'SEU_TOKEN_RDSTATION_AQUI'. Ele pode ser obtido na página de Integrações;

2 - Definir um identificador para o evento de conversão e inserí-lo no script abaixo onde diz 'IDENTIFICADOR DESEJADO';

3 - Adicionar o código na página que contém o formulário.

<script type ='text/javascript' src="https://d335luupugsy2.cloudfront.net/js/integration/stable/rd-js-integration.min.js"></script>
<script type ='text/javascript'>
    RdIntegration.integrate('SEU_TOKEN_RDSTATION_AQUI', 'IDENTIFICADOR DESEJADO');
</script>

Após realizar esses passos, a sua integração está pronta. Recomendamos realizar alguns testes de integração para verificar se todos os dados aparecem no RD Station.

Meu formulário não atende ao padrão mencionado

Caso seu formulário possua um campo para o Lead informar o e-mail, porém o input desse campo tenha um nome diferente de email, você deverá configurar uma correspondência de campos.

Essa correspondência entre campos do seu formulário e os campos do RD Station pode ser feita também para outros campos. Por exemplo, se o campo onde o Lead informa o nome seja name="nome_completo" ou se o campo com informações a respeito do cargo do Lead seja name="cargo_do_usuario", você pode utilizar a mesma estrutura para que esses dados sejam enviados corretamente para o RD Station.

Suponha que seu formulário possua os seguintes campos:

<input type="text" name="email_do_usuario" />
<input type="text" name="Nome Completo" />

Você deve colocar somente o código abaixo do script de integração para que a correspondência de campos seja feita e os dados sejam adicionados corretamente no RD Station.

Assim, para integrar seu formulário, siga os passos 1 e 2 normalmente, e no passo 3 faça as seguintes alterações:

  • Adicione a combinação de campos;
  • Adicione o parâmetro options na linha que chama a integração.

O seu código deverá ser algo como:

<script type ='text/javascript' src="https://d335luupugsy2.cloudfront.net/js/integration/stable/rd-js-integration.min.js"></script>
<script type ='text/javascript'>
    var meus_campos = {
      "email_do_usuario": "email",
      "Nome Completo": "nome",
    }
    options = { fieldMapping: meus_campos }
    RdIntegration.integrate('SEU_TOKEN_RDSTATION_AQUI', 'IDENTIFICADOR DESEJADO', options);
</script>

Para cada campo adicionado, a linha deve terminar com uma virgula. Exemplo:

var meus_campos = {
      "email_do_usuario": "email",
      "Nome Completo": "nome",
      "IdadeDoCliente": "idade",
      "Empresa do Usuario": "empresa",
    }

Campos do Lead no RD Station

Os campos abaixo irão aparecer diretamente na tela de informação de Lead se mantiverem os nomes listados abaixo. Você pode utilizar a estrutura acima para enviar esses dados com seus respectivos nomes.

  • nome
  • telefone
  • empresa
  • cargo
  • twitter

Todas as informações que você deseja enviar ao RD Station devem estar em um HTML input e obrigatoriamente devem possuir uma tag name para identificá-los. Essas informações também ficarão disponíveis nos detalhes da conversão do Lead.

<input type="text" name="telefone" />

Recomendamos que o campo de nome possua a tag name="name", pois dessa forma, esse será o nome do Lead criado no RD Station. Caso não seja enviada essa informação, o nome do Lead será preenchida com o seu e-mail.

<input type="text" name="name" />

Avisos de conversão por email

O RD Station pode lhe enviar um email quando uma nova conversão for realizada em seu site. Para isso, basta colocar o seu email na configuração da página de configurações.

Exemplo completo

No código HTML abaixo, é possível ver uma página com um formulário que envia as informações para a API e depois redireciona o visitante para outra página.

<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>HTML Puro | Integrações RD Station</title>
<style type="text/css">
html,body{text-align:center;}
#wrapper{width:600px; margin:0 auto; text-align:center;}
#conversion-form{width:300px; margin:0 auto; border:1px solid silver;text-align:left;}
#conversion-form .field{padding:4px;}
#conversion-form .actions{text-align:center;}
#conversion-form label{display:block;}
#conversion-form input[type=text]{width:90%;}
</style>
</head>
<body>
<div id="wrapper">
 
  <h1>Integrações RD Station</h1>
  <h2>Integração Genérica via JavaScript</h2>
 
  <form id="sample"> 
    <div class="field">
      <label>E-mail:*</label>
      <input type="text" name="email" />
    </div>
    <div class="field">
      <label>Nome:*</label>
      <input type="text" name="nome" />
    </div>
    <div class="field">
      <label>Empresa:</label>
      <input type="text" name="empresa" />
    </div>
    <div class="actions">
      <input type="submit" value="Enviar" />
    </div>
  </form> 
</div>
<!-- Início do código de integração -->
<script type ='text/javascript' src="https://d335luupugsy2.cloudfront.net/js/integration/stable/rd-js-integration.min.js"></script>
<script type ='text/javascript'>
    RdIntegration.integrate('f1c940384a971f2982c61a5e5f11e6b9', 'Formulário de contato');
</script>
<!-- Fim do código de integração -->
</body>
</html>

Possíveis Erros

Incompatibilidade entre scripts

Caso seu site já utilize algum javascript no formulário a ser integrado, é possível que haja incompatibilidade com nosso script de integração.

Nesse caso, você pode buscar uma saída mais técnica: A Resultados Digitais disponibiliza uma função JavaScript que executa diretamente uma requisição POST para a API do RD Station. Essa requisição contém os dados do formulário, que serão utilizados para a criação do Lead. Mais informações neste artigo.

A API pode retornar erro caso:

  • (401) seu token RD Station esteja errado ou inválido;
  • (400) não esteja recebendo um identificador;
  • (400) não esteja recebendo o email (email ou email_lead) vindo do formulário;

Possíveis Alertas

  • (302) A API recebeu algum alerta e, ainda assim, registrou a conversão normalmente.
  • Seu servidor pode emitir para o navegador um alerta de No Access-Control-Allow-Origin. Este é um alerta de segurança pelo fato de estar trocando dados com outro servidor. Apesar do alerta, a integração funciona normalmente sem afetar nada no seu site.

É importante testar a integração após as modificações para evitar que erros como esses acima apareçam para o seu visitante.

Recomendados a utilização de alguma mecanismo para validação dos campos do formulário garantindo que o campo e-mail (obrigatório) seja sempre informado pelo visitante.