Qualifio & Actito native integration

Tabata Vossen -

Hi, Actito customer! Qualifio has built an integration with Actito.

In order to better serve the growing number of marketers who want to take greater advantage of their Actito automation marketing platform, Qualifio has developed a generic integration that allows all the data collected with our platform to be easily sent to Actito for targeted and profitable marketing campaigns.

Is my Actito configuration eligible for a native integration?

A native integration between Qualifio and Actito is possible if certain conditions are met within your Actito account:

  • You have one Actito Form per database.
  • The unique primary key for a profile is "email address" (unique and mandatory).
  • No other field is mandatory.
  • 15 standard profiles data, identical for all integrations (see dedicated section).
  • Max. 15 custom profiles data (to be defined).
  • Max. 20 opt-ins.
  • Presence of six technical attributes (identical for all integrations).
  • Presence of three GDPR attributes.

Centralise your data in Actito

The information collected on your participants is pushed in real time to Actito. This keeps your database up to date and allows you to send relevant campaigns.

How to configure the integration?

Prerequisites: Ask your Actito expert to do the following:

  1. Activate the "Qualifio form" template for your Actito account. Without this, you will not be able to recover your data collected with Qualifio within Actito.
  2. Specify the mandatory fields (primary keys) in the "Actito form" in order to make them mandatory in the "Qualifio form" too.

To add the Actito integration to your Qualifio account, please follow the steps below:

  1. Go to Settings, then Integrations & partners.
  2. Set the Actito integration to ON, then click on Configure:
    Screenshot_2021-06-07_at_16.41.48.png
  3. Define the name of the integration you want to be displayed in Qualifio (e.g. "Actito Integration"). Remember to define a name that means something to your team because it is this name that will appear when they enable the integration.
    Screenshot_2019-05-27_at_11.12.00.png
  4. Under Global, define the Actito variables that are global to your Qualifio account (and therefore applicable to all websites and campaigns):
    • API key is a character string that we can use to connect to Actito's API.
    • Endpoint get token is your Actito API domain, minus the version number, plus "auth/token". For instance, if your API domain is https://api.actito.com/v4, your endpoint is https://api.actito.com/auth/token.
    • Endpoint upsert interaction is the place where Qualifio will post the participant data. This one is also made of your API domain, plus "entity/{entity}/form/{form}". So, if your API domain is https://api.actito.com/v4, your endpoint is https://api.actito.com/v4/entity/{entity}/form/{form}.
    • Entity name is the name of the entity to which the forms belong, which you can find under "Manage forms and pages".
    • Form name is the name of your form in Actito, which you can also find under "Manage forms and pages".

      Note:
      All this information must be provided to you by your Actito expert. Qualifio cannot help you to retrieve these elements.

  5. By default, all your Qualifio websites will use the form filled in under the Global tab. If you have several forms for your Actito account, they can be associated with a particular site in Qualifio. For example, you could have a "Sports" form in Actito, which will be associated with your "Sports" site in Qualifio. In this case, you must associate the desired Actito form with the site in question. You can do this under the "Per website" section. Please ask your Actito expert for more information.

Screenshot_2019-05-27_at_11.31.24.png

About data mapping

Standard profile (form) data

Description Mapping variable Actito variable Comment
First name {firstname} firstName String (64) – no special characters
Last name {lastname} lastName  String (64) – no special characters
Email address {email}  emailAddress  Email address – mandatory field
Street {address}  addressStreet String (225)
Street number {number}  addressNumber String (10)
Box {box} addressBox String (10)
Postal code {zip} addressPostalCode String (10)
Locality {locality} addressLocality String (50)
Country {country} addressCountry  ISO 3166-2
Birthdate {birthday} birthDate yyyy-mm-dd
Gender {gender} sex "M" or "F"*
Job {function} profession String
Phone number {phone} telephoneNumber International prefix + phone number**
Company {company} company String

 

* Important: For the "Gender" or "Sex" field, only the values "M" and "F" (in upper case) will be passed to Actito. To ensure that the push works properly, you must absolutely configure these values in your form field, as follows:

Screenshot_2019-05-27_at_11.38.10.png

** Attention: For the "Phone" field, Actito expected format is "international prefix + phone number". To make sure the push works correctly, the "Phone" field must be configured as follows:

Capture_d_e_cran_2019-07-05_a__14.31.08.png

In the validation tab, you must enter the following input mask: "+32 99 99 99 99" (for Belgium) or "+34 999 99 99 99" (for Spain), etc.

Capture_d_e_cran_2019-07-05_a__14.32.21.png

Custom profile (form) data

You can add as many custom fields as you wish to your form (e.g. favourite football team, number of dogs, loyalty card number, etc.)

By following a specific naming convention for the variables associated with these custom fields in Qualifio (e. g. "actito_footballteam"), this information can be sent directly with this name in Actito (e. g. "footballteam").

How to do it in Qualifio? To associate a variable of the type {actito_ABCD} with a form field, you must create a mapping variable in Qualifio and then associate it with your form field. This is a vital element for pushing information to Actito.

Below an example:

Form field Mapping variable in Qualifio Actito Question Comment
What's your favourite football team? {actito_footballTeam} footballTeam Alphanumeric field - character string
How many dogs do you own? {actito_dogs} dogs Drop-down list with the following answer options: 0, 1, 2, 3+
Cellphone number {actito_gsmNumber}  gsmNumber Alphanumeric field with input mask: "international prefix + exact number of digits". In Belgium: “+32 999 99 99 99”

Opt-ins and subscriptions

Opt-ins are managed from Qualifio's Opt-ins section.

Important: You must associate a mapping variable to each opt-in.

Opt-in name Opt-in text Qualifio mapping variable Actito subscription
Newsletter opt-in Yes, I would like to receive the newsletter optin_newsletter Newsletter
Partners opt-in Yes, I would like to receive information and tips from partners optin_partners Partners

Campaign data

Description Actito technical question Value
Source source "Qualifio"
Update Source updateSource "Qualifio"
Campaign ID way Qualifio campaign ID
Participation date and time date YYYY-MM-DD hh:mm:ss
Campaign title surveyName String (the title you gave to your campaign in Qualifio)
Campaign type ID surveyType Numerical value, e. g. "13", corresponding to a campaign type on the Qualifio side
Time of participation surveyDate YYYY-MM-DD
Campaign language motherLanguage ISO 639-1
Device deviceName desktop / mobile
User Agent userAgent e.g. "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/74.0.3729.169 Safari/537.36"

How to activate the push in your campaigns?

Once configured, the integration will be available in Settings > Push rules.

Important:
Further details on how to manage push rules can be found here.

If the integration was enabled for a campaign, you will be able to view it in the Settings step of the campaign, under the Data pushes tab:

Screenshot_2021-04-27_at_15.41.26.png

For more information about the Actito integration, contact your Qualifio expert or your Actito expert!