Configuración de Engage en Actito

El primer paso para integrar Engage es preparar un formulario estándar en Actito, que se utilizará para almacenar las entradas.

Para ayudarte con esta tarea, Actito puede implementar un formulario listo para usar que estará preconfigurado con todas las preguntas estándar. Solo requerirá algunas adaptaciones mínimas para que se ajuste a su base de datos, lo que le ayudará a tener un formulario funcional para recopilar datos de Qualifio en poco tiempo.

Para implementar este formulario en su licencia, comuníquese con su administrador de cuentas o con el soporte de Actito y especifique en qué tabla de perfil se debe crear.

Una vez implementado el formulario, estará disponible en los borradores de la aplicación 'Formularios y páginas', donde podrá finalizarlo y activarlo.

info

Puede completar este paso solo siguiendo la guía a continuación. Si deseas ayuda de los equipos de Actito para configurar tu integración, no dudes en contactar con tu gestor de cuentas.

Guía para finalizar un formulario de Engage estándar

Vaya a la pestaña "Borradores" de la aplicación "Formularios y páginas" y seleccione el formulario llamado "engageCampaigns-{nombre de su base de datos}.

Consejo

Si se implementan varios formularios en la misma base de datos, el nombre del formulario tendrá como sufijo un incremento numérico. Se requiere una configuración específica en Qualifio para integrar campañas de Engage con múltiples formularios en su licencia. Por favor, hable de esto con su administrador de cuentas.

Pasos 1, 2 y 3

Este formulario sólo se utilizará por su capacidad para almacenar datos y no por su estructura. Los perfiles nunca verán su diseño porque participarán en el formulario Qualifio.

Vaya directamente al paso 4, porque no necesita modificar nada en los primeros 3 pasos: el formulario está predefinido con la información básica de su BD.

nota

Los pasos 1, 2, 5, 7, 8 y 9 se pueden omitir por completo durante la creación del formulario, ya que no tienen ningún impacto.

Paso 4 - Definir las preguntas

Todas las siguientes preguntas están predefinidas: corresponden a campos estándar que están sincronizados de forma predeterminada. Esto incluye tanto los datos técnicos de la inscripción como los datos identificativos del participante.

Advertencia

Todas estas preguntas se sincronizan automáticamente mediante la integración. Asegúrate de mantener todas las preguntas en tu formulario de Actito, incluso si tu base de datos no contiene estos atributos. De hecho, una pregunta obligatoria faltante podría impedir que toda la integración funcione.

Puedes elegir las preguntas de identidad que se harán en tu campaña de Qualifio, solo que el formulario de Actito debe incluir todos los campos estándar.

Aquí, a título informativo, están todas las preguntas predefinidas, su nombre y su tipografía:

Datos	Pregunta	Tipo de presentación y respuesta
Nombre	firstName	Campo abierto - Texto
Apellido	lastName	Campo abierto - Texto
Correo electrónico	emailAddress	Campo abierto - Dirección de correo electrónico
Dirección	addressStreet	Campo abierto - Texto
Número	addressNumber	Campo abierto - Texto
Apartamento	addressBox	Campo abierto - Texto
Código postal	addressPostalCode	Campo abierto - Texto
Localidad	addressLocality	Campo abierto - Texto
País	addressCountry	Botones de opción - País
Fecha de nacimiento	birthDate	Campo abierto - Fecha
Género	sex	Botones de opción - Género Valor: "M" o "F"
Profesión	profession	Campo abierto - Texto
Teléfono	telephoneNumber	Campo abierto - Número de teléfono
Compañía	company	Campo abierto - Texto
Nombre de la campaña	surveyName	Campo abierto - Texto
ID del tipo de campaña	surveyType	Campo abierto - Texto
Fecha de participación	surveyDate	Campo abierto - Fecha (AAAA-MM-DD)
Nombre del dispositivo del participante	deviceName	Campo abierto - Texto
User Agent	userAgent	Campo abierto - Texto
Actualizar fuente	updateSource	Campo abierto - Texto
Idioma de la campaña	motherLanguage	Lista desplegable - Idioma

Agregar pregunta Suscripciones

importante

Además de estas 21 preguntas predefinidas, también debes agregar una pregunta adicional basada en las Suscripciones presentes en tu BD. Esto debe hacerse manualmente ya que las respuestas deben coincidir con sus suscripciones.

Para hacer esto, haga clic en "+ Añadir elemento a la página" al final del paso 4.

Luego elija "Definir una pregunta a partir de un atributo de base de datos".

En la lista de atributos, elija la opción "Suscripción", identificada por el icono de múltiples valores.

Mantenga el texto predeterminado y no marque las casillas (el enriquecimiento de la base de datos se definirá en un paso posterior). haga clic en Siguiente".

¡La pregunta se crea con todas las suscripciones a bases de datos existentes como posibles respuestas!

info

Es necesario crear estas 22 preguntas para sincronizar todos los campos estándar en la integración de Engage. También puede crear preguntas adicionales para sincronizar campos personalizados.

Paso 5 - Definir las páginas del anexo

No se requiere configuración para este paso. Entonces puedes omitirlo.

Paso 6: enriquecer la base de datos

El enriquecimiento de la base de datos es lo que le permite crear o actualizar perfiles en su base de datos en función de los envíos de formularios. Como parte de la integración de Engage, el enriquecimiento es opcional: incluso sin enriquecimiento de la base de datos, las participaciones se sincronizarán entre Qualifio y Actito y todos los datos se almacenarán en el propio formulario de participación.

Sin embargo, el enriquecimiento es una gran ventaja de las formas. Le aconsejamos definir siempre al menos una regla basada en un atributo clave para vincular la participación y un perfil: debe estar asociada a un perfil para lanzar un escenario, por ejemplo.

Consejo

Si la clave de votación de la BD es el correo electrónico, puedes pedir fácilmente a los participantes de tu campaña Qualifio que se identifiquen a través de esta dirección.

Si la clave es más bien un ID de cliente, deberá agregar una pregunta (oculta) que podrá rellenar previamente con los datos desde tu tabla de perfil cuando compartes tu campaña de Qualifio a través de un canal de Actito.

• Crear una nueva regla
• En la definición de regla, seleccione las siguientes opciones: *Cuando se completa la participación en el formulario
  • Modo de enriquecimiento: mixto
• Desde la lista de atributos de la base de datos a la izquierda, arrastre el atributo clave para vincular perfiles y suéltelo en la regla de enriquecimiento.
• Luego haga clic en el botón 'Editar' a la izquierda del atributo clave seleccionado. *Seleccione “Mantener valor actual”

Consejo

Este es el principio básico necesario para vincular una entrada a un perfil. Se pueden configurar reglas de enriquecimiento para todas las preguntas que coincidan con un atributo de base de datos. Encontrará instrucciones adicionales y mejores prácticas para el enriquecimiento de la base de datos en otra sección.

Pasos 7, 8 y 9

No se requiere configuración para este paso. Por lo tanto, puedes omitirlos y volver a los borradores para el resto.

Definir nombres técnicos

Es a través del nombre técnico que la API impulsará la participación en Qualifio en Actito. Por eso es muy importante definirlos correctamente.

info

El nombre técnico de las 21 preguntas predefinidas ya estará configurado, pero deberás asignar el nombre técnico correcto a la pregunta "Suscripciones" creada en el paso 4.

Regrese a la lista de formularios en definición, seleccione el formulario y haga clic en 'Más' y luego en 'Definir nombre técnico'.

Encuesta

Este es el nombre técnico del formulario, que vincularás a tu integración en Qualifio.

Está predefinido como "engageCampaigns*{DBName}*, sin el guión en el nombre para mostrar.

Preguntas

El nombre técnico de las 21 preguntas predefinidas ya está configurado. Para su información, se enumeran a continuación.

Advertencia

A diferencia del nombre del formulario, que permite algunas personalizaciones, es requerido que el nombre técnico de las preguntas coincida exactamente con la especificación a continuación. Todas las preguntas deben configurarse.

Texto corto	Nombre técnico
Nombre	firstName
Apellido	lastName
Email	emailAddress
Dirección	addressStreet
Número	addressNumber
Apartamento	addressBox
Código postal	addressPostalCode
Localidad	addressLocality
País	addressCountry
Fecha de nacimiento	birthDate
Género	sex
Profesión	profession
Teléfono	telephoneNumber
Compañía	company
Nombre de la campaña	surveyName
ID del tipo de campaña	surveyType
Fecha de participación	surveyDate
Idioma de la campaña	motherLanguage
Nombre del dispositivo del participante	deviceName
User Agent	userAgent
Suscripciones	subscriptions
Actualizar fuente	updateSource

:::Peligro importante Además, debe definir el nombre técnico de la pregunta "Suscripciones" creada en el paso 4. Debe ser "suscripciones". Indique este valor y haga clic en "Validar". :::

Paso 10 - Publicar el formulario

Vuelve al editor de formularios para publicar tu formulario.

• Selecciona el acceso: Dirección pública, todo el mundo puede acceder a él.
• No es necesario copiar y pegar la URL del formulario de Actito, ya que las participaciones se envían directamente desde Qualifio a través de la API.

Ahora que ya ha creado su formulario, puede configurar la integración en su interfaz Qualifio.

Sincronización de campos personalizados

Por defecto, Engage ya sincroniza muchos datos, incluyendo la información relacionada con la campaña y la información personal del participante.

Pero dependiendo de su actividad, es posible que necesite recopilar más información, como los hobbies del participante, si tiene un coche o cualquier otra cosa relacionada con su actividad.

peligro

Antes de crear y configurar campos personalizados, es necesario que haya finalizado su integración en Qualifio.

Por eso, tiene la opción de crear campos adicionales que se sincronizarán entre la campaña de Qualifio y el formulario de Actito, para ayudarle a activar el perfil con los datos relevantes para su actividad.

Consejo

Si la clave de su tabla de perfil no es la dirección de correo electrónico sino un ID de cliente, debe crearse una pregunta personalizada para ese ID de cliente para permitirle enriquecer su tabla de perfil.

Esto te permitirá ocultar y rellenar previamente esta pregunta cuando compartas tus campañas de Qualifio en los canales de Actito.

info

Puede realizar este paso por su cuenta siguiendo la guía a continuación. Si desea ayuda del equipo de Actito para configurar su integración, no dude en ponerse en contacto con su gerente de cuenta.

Paso 1 - Crear el campo para almacenar los datos en el formulario de Actito

En la plataforma de Actito, vaya al módulo de Formularios y Páginas y seleccione el formulario activo "Campagnes Engage"

• Haga clic en "Más" y luego en "Corregir"
• Vaya al paso #5 'Definir las preguntas'
• Cree una nueva pregunta:
  • Defina una pregunta simple o una pregunta a partir de un atributo de la base de datos, si el atributo ya existe en la tabla de perfiles
  • El texto de la pregunta debe ser el 'nombre de su campo'
  • Tipo de presentación: campo abierto o botones de radio según las respuestas
  • Tipos de respuestas que se pueden utilizar:
    • Tipos de campos abiertos aceptados:
      • Texto
      • Número entero
      • Fecha
    • Botones de radio aceptados:
      • Booleano (sí/no)
    • Casillas de verificación múltiples (para datos con múltiples valores)
      • Texto
  • Configuración adicional:
    • Mantener Opcional
    • Número máximo de caracteres: mantener el valor actual
    • Rellenar la respuesta previamente: sin valor
    • Longitud del campo de texto abierto: mantener el valor actual (vacío)
    • Mostrar condiciones: mantener el valor actual (siempre visible)
    • Búsqueda e informes: "nombre de su campo" - sin espacios
• Vaya al último paso para corregir y publicar el formulario nuevamente

Ahora tienes una nueva pregunta que corresponde a tu campo personalizado.

Paso 2 - Asignar un nombre técnico a tu campo

Después de publicar tu formulario, selecciónalo y haz clic en 'Más' y luego en 'Definir un nombre técnico'.

Asigna el nombre técnico a tu campo (sin espacios) y toma nota de él.

Eliminar una pregunta de un formulario de Actito

Si eliminas una pregunta en el formulario de la campaña Engage en Actito, la pregunta seguirá apareciendo en la estructura de tu formulario (módulo de segmentación, módulo de personalización o API). No hay una eliminación real de la pregunta. Por lo tanto, te recomendamos no eliminar preguntas.

Esto significa que, aunque no hay un límite estricto en cuanto al número de campos sincronizados por Engage, es mejor no crear preguntas que se utilizarán en una sola campaña. Puedes crear campos 'genéricos' que puedan aceptar diferentes respuestas según la campaña.

Paso 3 - Definir la nueva variable de mapeo en el Portal Qualifio

Regresa al portal Qualifio.

Consejo

Para hacer esto, puedes utilizar el SSO.

Ve a la sección 'Integraciones' y selecciona 'Variables de Mapeo'.

• Define un nombre de visualización con el nombre técnico definido en el paso #2.
• Define un nombre técnico con el nombre técnico definido en el paso #2 y el prefijo "actito_". Por ejemplo, el campo "myCustomField" se convierte en "actito_myCustomField".
• Mantén el tipo de variable como "Respuesta".
• Asigna esta variable de mapeo a los cuestionarios y/o formularios (ver paso 4 para aplicaciones prácticas).

Paso 4 - Utilizar la variable de personalización en tu campaña

Según la configuración seleccionada en el paso 3, puedes utilizar tu variable personalizada de las siguientes formas:

• En la etapa de 'preguntas' de tu campaña Qualifio. Aquí es donde defines el cuestionario en sí, es decir, la parte interactiva de la campaña. Simplemente elige la variable de mapeo adecuada en las opciones.

Consejo

Usar una variable personalizada en un cuestionario te permite recopilar información adicional de tu perfil mientras la incluyes en el 'juego'.

• En la etapa de 'Formularios' de tu campaña, donde recopilas la información personal de tu participante, como preguntas de identificación. Pero también puedes escribir tus propias preguntas y luego mapearlas con una variable personalizada para enviar la respuesta a Actito.

Utilizar formatos de preguntas adecuados

Atención

Asegúrate de que el tipo de formato de las preguntas sea compatible tanto con Actito como con Qualifio. Ten en cuenta la tabla de comparación al configurar campos personalizados.

Tipo de dato	Tipo de respuesta en Actito	Tipo de pregunta en Qualifio	Valor de las preguntas en Qualifio	Tipo de dato para enriquecer en la tabla de perfiles de Actito
Texto	campo abierto - texto	Respuesta única - Botones de respuesta - Botones de radio - Imágenes clicables - Lista desplegable - Listas desplegables vinculadas Respuestas múltiples - Campo alfanumérico con verificación instantánea Preguntas abiertas - Área de texto	Texto: ten en cuenta el límite de caracteres si utilizas reglas de enriquecimiento	Atributo de texto
Número entero	campo abierto - número entero	Respuesta única - Botones de respuesta - Botones de radio - Imágenes clicables - Lista desplegable - Listas desplegables vinculadas Preguntas abiertas - Campo numérico	Con un número entero como valor	Atributo de número entero
Fecha	campo abierto - fecha	Preguntas abiertas - Campo de fecha		Atributo de fecha
Booleano	Botones de radio - sí/no	Respuesta única - Botones de respuesta - Botones de radio - Imágenes clicables - Lista desplegable - Listas desplegables vinculadas	Con un valor: verdadero/falso	Atributo booleano
Texto de múltiples valores	Casillas de verificación - texto	Respuestas múltiples - Casilla de verificación única Clasificación	Atención: todas las respuestas definidas en Qualifio también deben estar definidas en las respuestas de Actito	Atributo de texto con múltiples valores

Paso 5 - Enriquecer los atributos de los perfiles

El enriquecimiento se puede aplicar a todas las preguntas correspondientes a un atributo de la tabla de perfiles, cuya respuesta se puede utilizar para actualizar la tabla de perfiles. Por ejemplo, actualizar información personal (nombre, apellidos, etc.), valores de suscripción o campos personalizados.

tip

Recuerde que es obligatorio asignar a cada participante un perfil en la base de datos.

Para enriquecer una tabla de perfiles, deberás definir una regla de enriquecimiento de datos personalizada en tu formulario de Actito.

• Desde el portal de Actito, ve al módulo "Formularios y Páginas".
• Selecciona tu formulario activo de "Campaña de Participación".
• Haz clic en "Más" y luego en "Editar enriquecimiento de perfil".

Dependiendo de tus necesidades, deberás definir tu propia regla de negocio además de la regla de enriquecimiento predefinida basada en la clave de tu base de datos.

La regla de enriquecimiento se ejecutará cada vez que se agregue una participación por parte de Qualifio.

info

Para obtener explicaciones detalladas sobre las reglas de enriquecimiento, por favor lee Enriqueciendo una base de datos a través de un formulario.

Caso de uso de suscripción

Deseas registrar nuevos perfiles en tu suscripción a boletines después de que hayan dado su consentimiento. Para perfiles existentes, si el perfil no vuelve a dar su consentimiento, no deseas dar de baja al perfil.

Desde la base de datos, en el panel izquierdo:

• Arrastre el atributo "Subscriptions" y suéltelo en la regla de enriquecimiento. Luego, seleccione la pregunta utilizada para enriquecer su atributo ('subscriptions').
• Si aún no lo ha hecho, arrastre el atributo clave (por ejemplo, emailAddress) y suéltelo en la regla de enriquecimiento, luego seleccione la pregunta correspondiente a este atributo.

A continuación, haga clic en el botón 'editar' junto a cada atributo:

• Para 'Subscriptions'
  • Seleccione 'Sobrescribir solo los valores que coinciden con las respuestas'
  • y 'Nunca sobrescribir los valores existentes'

• Para el atributo clave ('emailAdress', en nuestro ejemplo)
  • Seleccione 'Mantener el valor actual' si no se agrega ningún valor durante la participación en las campañas de Engage

Continúe este proceso para cada atributo que deba actualizarse a partir de una pregunta.

Definir el comportamiento de los valores vacíos

Para cada atributo a enriquecer, debe definir:

• El comportamiento de Actito si se recopila un valor vacío para un atributo:

  • Eliminar el valor actual y actualizarlo con un valor vacío
  • No hacer nada y mantener el valor actual
  • Actualizar el valor actual solo si el atributo está vacío (de lo contrario, se conserva el valor existente)

• Solo para atributos multivaluados, si se define una lista de valores posibles en el lado de Actito, seleccione "Sobrescribir solo los valores que coinciden con las respuestas" para evitar la eliminación de opciones que no están en la campaña de Engage. Esto es muy útil cuando tiene varias suscripciones en Actito, pero desea mostrar una selección reducida de opciones en Qualifio.

Ejemplo: Estás recopilando el nombre de tus perfiles a través de una campaña Engage. El participante no desea responder a la pregunta. Se registra un valor vacío.

Gestión 'Sin valor'	El atributo nombre está vacío en la tabla de perfiles	El nombre es "John" en la tabla de perfiles
Sobrescribir el valor actual del atributo	Actito reemplaza los valores vacíos por un valor vacío	Actito reemplaza el valor "John" por un valor vacío
Conservar el valor actual del atributo	Sin enriquecimiento, Actito mantiene un valor vacío	Sin enriquecimiento, Actito mantiene "John"
Nunca sobrescribir valores existentes. Solo se pueden actualizar los valores vacíos	Sin enriquecimiento, Actito mantiene un valor vacío	Sin enriquecimiento, Actito mantiene "John"

Ejemplo: Estás recopilando los nombres de tus perfiles a través de una campaña de Engage. El participante responde «Johnny» a la pregunta.

Gestión de «sin valor»	El atributo «nombre» está vacío en la tabla de perfiles	El atributo «nombre» es «John» en la tabla de perfiles
Sobrescribir el valor actual del atributo	Actito sustituye el valor vacío por «Johnny»	Actito sustituye «John» por «Johnny»
Mantener el valor actual del atributo	Sin enriquecimiento, Actito mantiene un valor vacío	Sin enriquecimiento, Actito mantiene «John»
Nunca sobrescribir los valores existentes. Solo se pueden actualizar los valores vacíos	Actito sustituye el valor vacío por «John»	Sin enriquecimiento, Actito mantiene «John»

Caso especial: enriquecer los atributos de una tabla personalizada

Las reglas de enriquecimiento estándar se pueden utilizar para actualizar una tabla de perfiles. No se pueden utilizar para enviar datos directamente a tablas personalizadas.

No obstante, existen alternativas para enviar los datos recopilados por las campañas a tablas personalizadas, utilizando el sistema de Actito:

• Definir una exportación de «Participación» del formulario de las campañas Engage
• Definir un ETL programado hacia las tablas personalizadas correspondientes.

Los datos se pueden conservar íntegramente en Actito utilizando la Transfer Box para exportar las participaciones y volver a importarlas directamente. También se pueden utilizar para actualizar su CRM. En este caso, los datos se transferirán a las tablas personalizadas mediante sus sincronizaciones diarias.

info

¿Necesita enviar datos de Engage a tablas personalizadas? Le recomendamos que se ponga en contacto con su administrador de cuenta.