Integrations
      Volver al inicio
      1. Centro de Ayuda Rock Content
      2. Ion
      3. Integrations

      Eloqua: publicar datos en el formulario web de Elq

      En esta ocasión, aprenderás cómo configurar una integración “post to web form” y, opcionalmente, implementar el seguimiento de visitantes y los scripts GUID. 

      Ion puede publicar datos de manera confiable en formularios web existentes en la plataforma de automatización de marketing de Eloqua. Luego de integrarlas, tus experiencias en ion pueden publicar perfectamente los datos que has definido en tu formulario de Eloqua. 

      Antes de comenzar

      Existen algunos elementos que necesitas recopilar de Eloqua antes de comenzar. A continuación, conócelos detenidamente:

      • Script de Eloqua-supplied Basic Page View Tracking.
      • URL de endpoint de Eloqua y los nombres de campo.
      • Eloqua Site ID y nombre de los formularios.

      El formulario HTML de Eloqua contiene tu Site ID, URL de endpoints y los nombres de los campos.

      Aquí tienes algunos pasos que debes cumplir en ion antes de empezar. 

      • Crea un campo de recopilación de datos.
      • Crea un campo de recopilación de datos para los campos ocultos de Eloqua, utilizando los siguientes nombres de datos:
          • elqSiteId
          • elqFormName
          • elqCustomerGUID
          • elqCookieWrite
      • Crea un formulario ion.
      • Configura la publicación de prueba.

      ¡Empecemos!

      1. Crea em mapeo de campo

      Al seguir los pasos señalados en las próximas líneas, crearás un mapa de campo entre tus campos de recolección de datos en ion y sus respectivos nombres de campo en Eloqua.

      1. Haz clic en la pestaña "Integrations" en la parte lateral de tu consola.
      2. Haz clic en el botón “New field mapping”.
      3. Etiqueta el mapeo de campo y, si quieres, agrega una descripción.
      4. En el menú Integration type, selecciona “Post to Web Form”.
      5. Guarda.

      2. Añade campos Outbound

      Los campos Outbound, o de salida, definen el dato que extiendes desde ion hacia tu formulario web externo. Para conocer los nombres de los campos externos, consulta a tu formulario HTML de Eloqua. Asegúrate de agregar tus campos ocultos de Eloqua utilizando los valores del formulario de Eloqua como valor predeterminado para tu campo Outbound. 

      Es importante considerar que el elqCostumerGUID no tendrá un valor predeterminado. Si estás publicando en múltiples formularios de Eloqua, puedes guardar el valor de elqFormName mediante una regla del formulario ion. Aprenderás a hacer esto en los próximos párrafos de este artículo.

      1. Haz clic en el botón “New outbound field” para agregar un nuevo campo en tu Field Mapping.

      2. Al añadir un nuevo campo, deberás seleccionar de los menús desplegables de “Data Collection”, el menú desplegable "Core Field", implementar una plantilla mashup o agregar un campo por medio de Javascript.

      Para agregar un campo de formulario, usa los menús desplegables Data Collection para seleccionar la categoría de campo de datos, luego, el campo de recopilación de datos.

      • O, para agregar un “ion Core Field”, selecciona en el menú desplegable “Core Field”.
      • O, para exportar múltiples campos ion para un campo externo, utiliza “Mashup Field” conectando {{DataName}} {{DataName2}} , etc, en el editor.
      • O, para reformatear un determinado valor antes de exportarlo, utiliza el campo Javascript para añadir lógica alrededor del valor recolectado en ion. Para acceder a los campos de recolección de datos vía JavaScript, utiliza respondent.dataname.

      3. Si prefieres, puedes establecer tu campo como obligatorio para ejecutar la integración.

      4. Si deseas, puedes agregar un valor predeterminado.

      5. Ingresa el nombre del campo externo.

      6. Guarda.

      7. Repite estos pasos para cada campo que deba incluirse en el “Field Mapping”.

      3. Crea una integración

      1. Ve a la pantalla “Integrations”.

      2. Haz clic en la pestaña “Integrations”.

      3. Haz clic en el botón “New Integration”.

      4. Ingresa una etiqueta.

      5. Opcionalmente, añade una descripción.

      6. Selecciona el “Field Mapping” que creaste.

      7. Pega el “Eloqua Form URL” en el editor.

      • Esta es la URL “post to” o de endpoint de tu formulario web.

      8. Define la cantidad máxima de intentos.

      • Si ocurre una interrupción del servicio con la plataforma externa, ion tratará de publicar nuevamente una vez por hora hasta que se cumplan todos los intentos.

      9. Selecciona POST como método.

      10. Si quieres, puedes agregar una dirección de correo electrónico de depuración.

      • Las direcciones de correo electrónico especificadas recibirán un mensaje cada vez que se ejecute la integración para mostrar los datos publicados y la respuesta recibida. Por lo general, esta característica se usa apenas para probar y solucionar problemas. 

      11. Guarda.

      4. Añade una integración a tus páginas de ion

      La plataforma ion se ejecuta teniendo como base las reglas que has creado. Se pueden añadir reglas a cualquier elemento procesable en tu publicación de ion. Por lo general, las reglas de integración se ejecutan a nivel de formulario tanto al enviarlo como en una etapa de la evaluación. Sigue los pasos a continuación para agregar la integración a tus páginas ion.

      1. Navega en tu publicación.

      2. Haz clic en el botón de envío de formulario o en el enlace para activar el disparador que ejecute la integración.

      3. En “Creative Studio”, haz clic en “+RULES”

      4. Selecciona la condición que debe cumplirse para ejecutar la integración. 

      • Normalmente, se usa “No conditions required”.

      5. Selecciona la acción “ Run Integration”.

      6. Guarda.

      7. Repite el procedimiento para cada publicación aplicable.

      5. Al publicar varios formularios de Eloqua…

      Si necesitas publicar datos en múltiples formularios de Eloqua, puedes guardar el valor de elqFormName por medio de una regla de nivel de formulario. El valor que has salvado aqui sobrescribirá el valor predeterminado en el formato de exportación. Esta regla de acción necesita implementarse por encima de la regla para ejecutar la integración.

      Condición: “No condition required”.

      Acción: Guardar en la base de datos - elqFormName = Valor.

      6. Opcionalmente, implementa un script de seguimiento de visitantes de Eloqua

      Eloqua proporciona un script de seguimiento de visitantes que se puede implementar en sus experiencias ion. El script de seguimiento “Basic Page View” se puede encontrar en el documento de Eloqua “Asynchronous Visitor Tracking Scripts” y se incluye una muestra a continuación. Sustituya “Siteld” en la línea 3 con tu “Eloqua Siteld”.

      a. Almacenar los scripts de Eloqua en ion Libraries

      1. En ion, navega al menú “Libraries” y selecciona “Scripts”. 
      2. Agrega una nueva categoría etiquetada como “Eloqua” o navega a una categoría existente.
      3. Haz clic en el botón “New Script”.
      4. Utiliza “Campaign - Head” como etiqueta.
      5. Pega el script en el editor.

      b. Agrega el script de Eloqua en las ion Campaigns

      1. Ve a tu pantalla "Campaign Management".
      2. Haz clic en el menú desplegable “Actions” y selecciona “Edit Campaign”.
      3. Selecciona "Eloqua" > "Campaign - Head script" del menú desplegable de la etiqueta principal.
      4. Guarda.
      5. Repite el proceso para cada Campaign aplicable.

      c. Ejemplo de Eloqua Vistor Tracking Script:

      <script type="text/javascript">

      var _elqQ = _elqQ || [];

      _elqQ.push(['elqSetSiteId', 'siteId']);

      _elqQ.push(['elqTrackPageView']);

      (function () {

      function async_load() {

      var s = document.createElement('script');

      s.type = 'text/javascript';

      s.async = true;

      s.src = '//img.en25.com/i/elqCfg.min.js';;

      var x = document.getElementsByTagName('script')[0];

      x.parentNode.insertBefore(s, x);

      }

      if (window.addEventListener)

      window.addEventListener('DOMContentLoaded', async_load, false);

      else if (window.attachEvent) 

      window.attachEvent('onload', async_load);

      })();

      </script>

      7. Opcionalmente, añade un script para guardar elqGUID en la recopilación de datos. 

      Agregarás un bloque de códigos más a tus páginas de formulario ion para guardar el Eloqua GUID value y almacenarlo en un campo de recolección de datos ion. Esto permitirá que incluyas el GUID en tu publicación del formulario de Eloqua.

      a. Crea un campo de recolección de datos ion para guardar el valor GUID

      1. Ve a “Data Management” > “Data Collection”.
      2. Navega a una categoría existente o crea una nueva categoría de campo de datos.
      3. Agrega un nuevo campo de datos con el nombre de datos de elqCustomerGUID.
      4. Guardar.

      b. Almacena GUID script en ion Libraries

      1. En ion, ve al menú “Libraries” y selecciona “Scripts”.
      2. Añade una nueva categoría denominada “Eloqua” o navega en una categoría existente.
      3. Haz clic en el botón “New Script” y utiliza “Form page - Body” como etiqueta.
      4. Pega el script en el editor.

      c. Agrega GUID script a tus páginas de formulario

      1. Ve a la páginas del formulario de tu publicación ion.
      2. Haz clic en "+script" de la pestaña “Page” en tu Creative Studio.
      3. Selecciona "Eloqua" > "Form page - Body" en los menús desplegables de la etiqueta del cuerpo de cierre.
      4. Guarda.
      5. Repite el proceso para cada página del formulario aplicable.

      d. Ejemplo de script para guardar GUID

      <script type="text/javascript">

      var timerId = null, timeout = 5;

      function WaitUntilCustomerGUIDIsRetrieved() {

      if (!!(timerId)) {

      if (timeout == 0) {

      return;

      } 

      if (typeof this.GetElqCustomerGUID === 'function') {

      var elq_GUID = GetElqCustomerGUID();

      liveballData("elqGUID", elq_GUID);

      return;

      }

      timeout -= 1;

      }

      timerId = setTimeout("WaitUntilCustomerGUIDIsRetrieved()", 500);

      return;

      }

      window.onload = WaitUntilCustomerGUIDIsRetrieved;

      _elqQ.push(['elqGetCustomerGUID']);

      </script>

      8. Prueba de integración

      Para probar tu integración, usa la publicación de prueba que configuraste antes de empezar el proceso de integración. Fíjate que las integraciones no se ejecutan en el Preview Mode, así que necesitarás abrir una URL para llevar a cabo la prueba. La integración se ejecutará, luego de enviar el formulario ion o de completar la acción que ejecuta la regla de integración.

      Si estás en la lista de distribución de correo electrónico de depuración, recibirás un mensaje de email que muestra los datos publicados y la respuesta del servidor externo. Asimismo, puedes verificar si los datos que enviaste fueron recibidos y procesados por Eloqua de manera adecuada.

      Si tiene alguna pregunta, póngase en contacto con nosotros en help@rockcontent.com. 😀