Saltar al contenido principal

Configuración de Engage en Qualifio

Una vez que se haya configurado el formulario para almacenar las participaciones en Actito, la integración se puede configurar en la plataforma de Qualifio.

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.

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). Aplicación de Qualifio

nota

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.

Consejo

¿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'.

Pestaña de integraciones

Seleccione 'Integraciones' en la sección de Integraciones.

Integrations

Busque Actito y marque la casilla para activar la integración. Actito

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)

Configurar la integración

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.

Paso 3.a Crear variables de optin

Vuelve a la sección 'Integraciones' y selecciona 'Variables de mapeo'.

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'.
Consejo

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.

Configuración de la variable

info

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'.

Opt-ins

Selecciona "Opt-ins" y luego haz clic en "Crear un opt-in". Crear un opt-in

Ahora puedes personalizar el opt-in en sí mismo, tal como aparecerá en tus campañas de Qualifio.

Consejo

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.

Configuración 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".

Reglas de push

Tiene 2 opciones:

  1. 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.
Consejo

Todas las campañas se enviarán a Actito (esta es la opción recomendada).

Configurar push

  1. 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.
Consejo

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.

Push específico

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. Tipo de preguntas de identificación

  • Puede agregar una o varias opciones al formulario para alimentar las suscripciones de las bases de datos de Actito. Me suscribo al boletín

Consejo

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.