Configuración de Engage en Qualifio
Engage ofrece dos modos de integración entre Actito y Qualifio, con el fin de adaptarse a las diferentes necesidades y configuraciones.
La conexión a través del formulario Actito requiere crear una integración en su portal Qualifio.
Por su parte, la conexión a través de tablas Actito, al ser más automatizada, no requiere ninguna configuración de integración en su portal Qualifio. La implementación es gestionada íntegramente por nuestros equipos y no requiere ninguna acción por su parte.
Por lo tanto, los pasos descritos en este artículo se refieren únicamente a la conexión a través del formulario Actito. Si utiliza la conexión a través de tablas, no debe seguir los pasos que se indican a continuación para finalizar la integración.
Crear un usuario de API
La sincronización entre las campañas en Qualifio y el formulario de Actito se realizará mediante llamadas a la API.
Estas llamadas están preprogramadas y no requieren la intervención de un desarrollador. Sin embargo, deberás crear una clave de API que implementarás en Qualifio.
Sigue el proceso de creación de usuario de API.
El usuario de API debe configurarse de la siguiente manera:
- Entidad: Selecciona la entidad de la tabla de perfiles vinculada al formulario.
- Derechos de acceso: Otorga al menos los derechos de ESCRITURA en la categoría 'Data exchange - Forms'.
Toma nota de la clave de API y del entorno de tu licencia para el próximo paso: Configurar Engage en Qualifio.
Iniciar sesión en Qualifio
Inicie sesión en su cuenta de Qualifio a través de la página de inicio de sesión, o siga el inicio de sesión único (SSO) para ir directamente de Actito a Qualifio (Formularios y páginas > Administrar campañas de Engage).
Si tiene una cuenta de usuario correspondiente en Actito y Qualifio, y el SSO está activado en su licencia, la aplicación 'Administrar campañas de Engage' le permitirá acceder de manera segura a su cuenta de Qualifio sin necesidad de iniciar sesión nuevamente.
Si desea activar el SSO en su licencia, por favor, póngase en contacto con su gerente de cuenta.
Guía de integración de Engage
Ahora le guiaremos a través de los diferentes pasos que debe configurar en su plataforma de Qualifio.
¿Ya está familiarizado con Qualifio? ¡Genial! Probablemente pueda seguir la super guía de la documentación de Qualifio. De lo contrario, la siguiente guía está dirigida principalmente a los usuarios que están descubriendo la plataforma de Qualifio.
Paso 1 - Activar la integración
En su cuenta de Qualifio, vaya a 'Integraciones' en el menú izquierdo, en la pestaña 'Engage'.
Seleccione 'Integraciones' en la sección de Integraciones.
Busque Actito y marque la casilla para activar la integración.
Paso 2 - Configurar la integración
Después de activar Actito como socio, haga clic en 'Configurar' para realizar la configuración.
- Asigne un nombre a su integración (Ej.: Actito - el nombre de su licencia)
- Elija si desea enviar las participaciones incompletas (los perfiles que no han completado completamente la campaña)
Luego, complete la información de identificación y los parámetros técnicos necesarios para establecer la conexión.
- Clave de API: ingrese la clave de API que ha creado anteriormente
- Endpoint upsert de interacción: cuando obtenga su clave de API, podrá ver su dominio API y el entorno en el que se aloja su licencia. Esto le permitirá finalizar el 'Endpoint upsert de interacción' (y el 'Endpoint get token')
- ENV-0: https://api.actito.com/v4/entity/{entity}/form/{form}/interaction
- ENV-1: https://api1.actito.com/v4/entity/{entity}/form/{form}/interaction
- ENV-3: https://api3.actito.com/v4/entity/{entity}/form/{form}/interaction
- Endpoint get token:
- ENV-0: https://api.actito.com/auth/token
- ENV-1: https://api1.actito.com/auth/token
- ENV-3: https://api3.actito.com/auth/token
- Nombre de la entidad: el nombre de la entidad en la que se almacena el formulario creado en Actito.
- Nombre del formulario: el nombre técnico del formulario que ha creado en Actito. Por defecto, debería ser "engageCampaigns".
Haga clic en 'Guardar' para finalizar la conexión.
Paso 3 - Crear variables de mapeo
Una vez que Qualifio esté conectado a su formulario de Actito, deberá configurar los campos que se enviarán.
- Los atributos de participación estándar ya están configurados automáticamente
- Los atributos de participante estándar ya están configurados automáticamente
- Las variables de Optin deben ser configuradas
Paso 3.a Crear variables de optin
Vuelve a la sección 'Integraciones' y selecciona 'Variables de mapeo'.
Para cada suscripción que deba sincronizarse con la base de datos de Actito, crea una variable de mapeo.
- Etiqueta de visualización: por claridad, debe coincidir con el nombre de la suscripción de Actito.
- Nombre técnico: debe ser "optin_nombre_suscripcion. Por ejemplo, para una suscripción llamada 'newsletter', debe ser 'optin_newsletter'.
Los espacios no se tienen en cuenta en los nombres técnicos de Qualifio. Si la suscripción en Actito contiene espacios, reemplázalos por un guion bajo (Ej.: "Product news" => "optin_Product_news"). Luego, contacta a tu administrador de cuenta o al soporte para que puedan personalizar la salida enviada a Actito y reemplazar el guion bajo por un espacio. Este es un paso importante para permitir la enriquecimiento de datos.
- Tipo de variable: selecciona "Opt-in"
- Activo para: marca Formularios y Opt-ins para que la integración esté disponible en todas las etapas de tu campaña.
Más información sobre las variables de mapeo.
Paso 3.b Crear un optin
Después de crear tu variable, también deberás crear el opt-in en sí mismo (uno por suscripción enviada a Actito).
Desde la pestaña Engage, ve a 'Opt-ins', en la sección 'Contenido'.
Selecciona "Opt-ins" y luego haz clic en "Crear un opt-in".
Ahora puedes personalizar el opt-in en sí mismo, tal como aparecerá en tus campañas de Qualifio.
Puedes agregar una descripción, un logotipo, etc. Todo esto formará parte del estilo de la campaña. Más información sobre los opt-ins.
La parte relevante de la integración es el parámetro "Variables de mapeo": en el menú desplegable, seleccione la variable creada anteriormente y asígnela a la opción adecuada de opt-in.
Paso 4 - Crear una regla de push
Después de completar la integración, es la regla de push la que activa la integración y envía los datos a Actito.
Vuelva a "Configuración" desde la barra superior y seleccione "Reglas de push de datos".
Tiene 2 opciones:
- Configurar una regla de push para todas las campañas (anónimas o no): desde el menú desplegable, seleccione el nombre de su integración, que configuró en el paso 1.
Todas las campañas se enviarán a Actito (esta es la opción recomendada).
- O puede configurar la regla de push a nivel de sitio web, formulario o campaña. En este caso, solo un subconjunto de sus recursos de Qualifio activará la transferencia de datos a Actito.
Esto requiere más mantenimiento, ya que, por ejemplo, configurar una regla a nivel de campaña requerirá agregar un nuevo parámetro de regla para cada campaña creada en Qualifio.
Paso 5 - Usar la integración en una campaña
Con la configuración completa, los datos de sus campañas de Qualifio ahora se pueden sincronizar con Actito.
En el paso Formularios de la creación de una campaña de Qualifio:
-
Todas las preguntas de "identificación" se pueden seleccionar y se sincronizan automáticamente con los "Parámetros estándar del participante" de su formulario de Actito.
-
Puede agregar una o varias opciones al formulario para alimentar las suscripciones de las bases de datos de Actito.
La variable de mapeo que vincula la opción de Qualifio con la suscripción de Actito se configura en el paso 4 y no se puede configurar directamente en el formulario.