Skip to main content

Synchronizing Custom Fields

By default, Engage already synchronizes a lot of data, including information related to the campaign as well as personal info related to the participant.

But depending on your business, there are many more pieces of information that you may want to collect, such as what are the hobbies of the participant, do they own a car or anything related to the scope of your brand.

This is why you have the possibility the create additional fields that will be synchronized between the Qualifio campaign and the Actito form, to help you activate the profile thanks to the data relevant to your business.

tip

If the key of your profile table is not the e-mail address but rather a client ID, a custom question must be created for this client ID to enable you to enrich your profile table.

You will be able to hide and prefill this question when your share your Qualifio campaigns through Actito channels.

info

You can complete this step in autonomy by following the walkthrough below. If you want the help of Actito teams to set-up the integration, do not hesitate to contact your account manager.

Step 1 - Create the field to store the data in the Actito form

In the Actito platform, go to the Form and Pages module and select the active form "Engage campaigns"

  • Click on "More" then "Correct"
  • Go to step #5 "Define question"
  • Create a new question:
    • Define simple question or define a question from a participant database attribute if the attribute already exists in the profile table
    • Question text should be the "name of your field"
    • Presentation type: open field, radio buttons or according to the answers
    • Answer types that can be used:
      • Open field types accepted:
        • Text
        • Integer
        • Date
      • Radio buttons accepted:
        • Boolean (yes/no)
      • Multiple checkboxes (for multi values data)
        • Text
    • Additional parameters:
      • Keep Optional
      • Maximum of characters: keep the current value
      • Pre-fill the answer: no value
      • Open text field length: keep the current value (empty)
      • Display condition: keep the current value (always visible)
      • Research and reporting: "name of your field" – without space
  • Go to the last step to correct and publish the form again

You now have a new question matching you custom field.

Alt text

Step 2 - Assign a technical name to your field

After publishing the form, select it and click on 'More', then 'Define technical name'.

Assign the technical name of your field (without spaces), and take note of it.

Alt text

Deleting question of an Actito form

If you delete a question on the engage campaign form on Actito, the question will still appear in the structure of the form (target module, the personalization module or API). There is no true deleting. We recommend no to delete questions.

This means that, while there are no hard limits to the number of fields synchronized by Engage, you should avoid creating questions that will be used for one campaign and never again. You can create 'placeholder' fields, that will accept different answers depending on the campaign

Step 3 - Set the new mapping variable on Qualifio Portal

Go back to the Qualifio portal.

tip

Remember you can use the SSO.

Go to the ‘Integrations’ section and select ‘Mapping variables’.

Mapping variables

  • Set a display name with the technical name set on the step #2
  • Set a technical name with the technical name set on the step #2 with the prefix "actito_". For instance, the "myCustomField" field becomes "actito_myCustomField".
  • Keep the variable type as "Answer".
  • Enable this mapping variable for questionnaire and/or forms (see step 4 for practical applications).

Alt text

Step 4 - Use the custom variable in your campaign

Depending on the settings chosen at step 3, you can use your custom variable:

  • At the ‘Questions’ step of your Qualifio campaign. This is where you define the quiz proper, namely the interactive part of the campaign. Simply choose the relevant mapping variable in the options.
tip

Using a custom variable in the Questionnaire allows you to collect additional data from your profile while making it part of the ‘game’.

Alt text

  • At the ‘Forms’ step of the campaign, where you collect the personal information of the participant such as the Identification questions. But you can also write your own questions, then map them with a custom variable to push the answer in Actito.

Alt text

Using proper question formats

caution

Make sure that the format types of the questions are matching on both Actito and Qualifio. Please mind the following comparison table when setting up custom fields.

Type of dataType of answer on ActitoType of question on QualifioValue of questions on QualifioType of data to enrich on Actito profile table
Textopen field - textSingle answer
- Answer buttons
- Radio buttons
- Clickable images br/> - Drop down list
- Related drop-down list
Multiple answer
- Alphanumeric field with instant check
Open-ended questions
- Text box
Text – be careful about the characters limit if using enrichment rulesText attribute
Integeropen field - integerSingle answer
-Answer buttons
- Radio buttons
- Clickable images
- Drop down list
- Related drop-down lists
Open-ended questions
-Numeric field
With an integer as a valueInteger attribute
Dateopen field - dateOpen-ended questions
- Date field
Date attribute
BooleanRadio buttons – yes/noSingle answer
- Answer buttons
- Radio buttons
- Clickable images
- Drop down list
- Related drop-down lists
With a value: true/falseBoolean attribute
Text multi-valuesMultiple checkboxes – textMultiple answer
- Checkboxes
Ranking
Warning: all answers values set on Qualifio must be also set on Actito answersText attribute with multi-values

Step 5 - Enriching profile attributes

Do the custom fields match some attributes of your database? Then you probably want to use the answer to theses questions to update your database. See here to add enrichment rules to your form.