Integrations
      Voltar para o início
      1. Central de Ajuda
      2. Ion
      3. Integrations

      Eloqua: coletar dados via Eloqua REST API

      O Ion suporta dois tipos de integração com Eloqua. O Ion pode transferir dados e recuperar dados do Eloqua por meio de sua API REST, além de postar dados em um Eloqua web form. Este documento fornece instruções passo a passo para configurar uma transferência automática de dados da API REST para o Eloqua.

      Antes de começar

      Se necessário, entre em contato com o suporte do Eloqua para obter orientação sobre como obter estes itens:

      • nome de usuário Eloqua;
      • senha Eloqua;
      • REST API endpoint URL.

      Existem algumas etapas que você precisa realizar antes de configurar a integração. Elas estão listadas abaixo e neste post:

      • Criar Data collection fields.
      • Criar Ion form(s).
      • Configurar uma publicação de teste.

      Vamos começar!

      1. Adicione credenciais de conta do Eloqua ao Ion

      Você pode inserir suas credenciais Eloqua diretamente por meio do Ion Console, seguindo as instruções abaixo.

      1. Clique na guia Integrations no painel de navegação lateral do Ion Console.
      2. Clique em Set up account credentials na parte superior da tela.
      3. Em Eloqua, clique em New Eloqua credential.
      4. Adicione um bom Label para sua conta e clique em Authorize Eloqua.
      5. Adicione suas credenciais do Eloqua na interface incorporada e clique em Accept para permitir que o Ion acesse a API REST.

      2. Crie um Field mapping

      Seguir as etapas abaixo mapeará seus Ion data collection fields para seus Eloqua API field names correspondentes. Para começar, adicione um novo Field mapping.

      1. Navegue na tela Integrations.
      2. Clique no botão verde New field mapping.
      3. Rotule o Field mapping e, opcionalmente, adicione uma descrição.
      4. No menu Integration type, selecione Eloqua.
      5. Salve.

      3. Adicione Outbound fields ao Field mapping

      Os Outbound fields definem os dados que você estende do Ion ao Eloqua.

      1. Clique no botão verde New outbound field.
      2. Adicione um campo selecionando o tipo de campo na lista suspensa.
      • Para adicionar um Form field, um Hidden field ou uma Query string variable, selecione Data field e escolha a Data field category e o Data collection field.
      • OU, para adicionar um Ion Core field, selecione Core Field e escolha o campo que você deseja incluir.
      • OU, para exportar vários Ion fields para um External field, escolha Mashup e conecte , etc. no editor.
      • OU, para reformatar um valor antes de exportar, escolha o código Javascript e adicione lógica em torno do valor coletado no Ion. Para acessar os Data collection fields via Javascript, use respondent.dataname.

      3. Opcionalmente, torne seu campo obrigatório para executar a integração.

      4. Opcionalmente, adicione um valor padrão (para um campo não marcado como requerido)

      5. Selecione o Eloqua field no menu suspenso do Eloqua API field names.

      6. Repita essas etapas para cada campo que deve ser incluído no Field mapping.

      7. Pule a adição de Inbound fields.

      4. Crie integrações

      1. Navegue de volta para a tela de Integrations.
      2. Clique na aba Integrations.
      3. Clique no botão verde New integration.
      4. Insira o Label.
      5. Opcionalmente, adicione uma descrição.
      6. Selecione o Field mapping que você acabou de criar.
      7. Defina o máximo de Retries.
      • Se houver uma interrupção do serviço com a plataforma externa, o Ion tentará novamente a postagem por quantas tentativas você indicar aqui.

      8. Selecione Add Lead como o API method.

      9. Opcionalmente, adicione-se à Debug distribution list para teste.

      • Isso entregará um e-mail ao endereço designado quando a integração for executada, exibindo a solicitação e a resposta do Eloqua.

      5. Adicione a integração às Ion pages

      A plataforma Ion executa a integração com base nas regras que você cria. As regras podem ser adicionadas a qualquer item acionável em seu Ion creative. As regras de integração são normalmente executadas no nível do formulário, no envio do formulário ou em uma etapa de avaliação. Siga as etapas abaixo para adicionar a integração às suas Ion pages.

      1. Navegue até a publicação.
      2. Clique no formulário, botão ou link que você deseja fazer o gatilho para executar sua integração.
      3. No Creative Studio, clique em +rules.
      4. Selecione a condição que precisa ser atendida para executar a integração.
      • No conditions required é normalmente usado.

      5. Selecione Run integration e selecione a Eloqua integration como a ação.

      6. Salve.

      6. Teste a integração

      Para testar sua integração, use a publicação que você configurou antes de iniciar as etapas de integração. Observe que as integrações não são executadas no modo de visualização, então você deve abrir um URL para teste. A integração será executada assim que você enviar o Ion form ou concluir a ação que executa a regra de integração. Se você estiver na Debug email distribution list, receberá um e-mail que exibe os dados transferidos e a resposta do Eloqua. Você também deve verificar o sucesso, garantindo que o lead foi criado em sua instância do Eloqua.

      Bom trabalho!

      Depois de concluir essas etapas, sua integração está pronta para uso. Você pode adicionar a regra para executar a integração em todas as publicações aplicáveis. Se você encontrar qualquer problema, entre em contato com a equipe de Suporte.