Note: This documentation is based on legacy systems and we recommend users to look at the SmartProbe Studio documentation here

Using an open-ended question, participants can freely type answers in their own words (as opposed to a pre-determined list in Choice questions), which can be in lengthy essays or short texts.

How to set up the platform:

1.  In the Questionnaire Builder page, add a new question OR insert a new question by hovering over an existing question and clicking the green (+) button (either above or below the existing question) 

2. Select Open Ended from the popup menu that appears.

Participants now have the option to answer open-ended questions using voice or video, leading to longer, more detailed answers. Then, in real-time, inca returns a probe that participants can also answer by voice or video. To learn more about this feature, please go to the Voice+ article here. 

SmartProbe Settings

When adding an open-ended question, you may select any combination of the following SmartProbe settings: 

Research Context

Toggle on/enable when you want to add contextual factors to be naturally incorporated into the generated probes. In this probing setting, you need to provide the Question Objectives summary:

• Question Objectives:
• Specify in 1-2 sentences what the question objectives are, as though you were briefing a colleague who will be interviewing people for you.
• We recommend you start the sentence with “We want to understand,” as per the example below
  

Another useful case for applying Research Context is when you want to set the tonality (i.e. formal audience) of your probing. For example, you can enable the Research Context and inform the bot that this is a survey intended for a business sample and ask it to use more formal language when probing.

One more useful example of applying Research Context is when you want to set the regional language differences or use the "consumer terms" when probing for a category or a topic. For example, you can enable to Research Context and inform the bot to use the British word for probing (Trainers - British vs Sneakers - American; Nappy - British; Diaper - American; Football - British vs Soccer - American).

**Best practices when using Question Objectives:

• Length:Keep it within 100 words. Longer objectives may result in important instructions being overlooked.
• Structure:Use the "context" + "instruction" format. Provide 1-2 sentences of context, then add specific instructions like "focus more on..." or "try not to...".
• Conditionally asking for different information depending on the type of response provided— for example, use an "if" statement in your question objective such as "If reasons have been stated, we want to know examples of where users have seen those reasons in practice."
• Testing and adjustment: This feature has inherent non-determinism, and it will generally follow the user's instructions. Users can experiment to optimize its effectiveness.

**Examples of what NOT to do with Question Objectives:

• Vague or ambiguous instructions, and/or instructions that only apply to a subset of the responses. For example, question objectives such as "We want to check whether the participant noticed the brand that each of the people in the ad were using" could result in SmartProbe asking if the brand was noticed even if the user specifically mentions a brand in their response.
• Exclusively focusing on, or avoiding specific targets. For such use cases, make use of the "Conversational Targets" feature (please see further below). 
• Controlling tone or phrases that SmartProbe uses — although question objectives can be useful here, they may not be reliable nor precise. Instead, use the "Trained Model" feature (please see below).

Trained Models

Toggle on/enable when you want to teach the inca chatbot with ideal probing by providing "probing exemplars" consisting of a ‘prime question’, a ‘prime response’, and the ideal ‘probe question’ that would be asked following the prime response. 

Users can steer the probing to investigate particular issues or needs they are especially interested in following the example below:

• For example: A packaging manufacturer has created a new compostable milk carton. They want to understand barriers to purchase among people who will not buy it. After capturing participants' spontaneous reasons for not purchasing, they want to present further information to participants to see if it impacts their decision.
• First Question or Prime Question: "You said you would not buy this packaging, why is that?"
  • The following participant Prime Responses, paired with the ideal Probe Question you specified, can serve as exemplars for the Trained Model to imitate:
    • "It's too expensive" → "What would the price difference need to be versus your current milk price to make you consider buying this packaging?"
    • "I don't have a garden!" →"You could add the compostable pack to your food waste bin or even take it to a local park. Does knowing this change your interest in purchasing this pack? Please tell me why."
    • "I don’t see too much wrong with the current milk packaging" →"Did you know that 10% of marine life dies each year due to plastic pollution in the oceans? Does this fact make you reconsider your interest in this compostable milk pack? Please tell me why."

To do this, click the English Trained Model tab and select Custom Trained Models. To add another prime response and probe question, click on ADD A NEW EXAMPLE.

You may also customize the Prime Question for each Prime Response by toggling Use Different Prime Questions

How to implement Trained Models in other languages?

By the default, the Project Language you are using on the Overview Page will also be the available language in the Custom Trained Model.

Step 1 -Select the language you want to use for the Trained Models and select Custom Trained Models in the drop-down.

Step 2 - When adding Trained Models in multiple languages, the process should be the same in applying the Custom Trained Model as discussed above -- in which case, adding the prime response and probe question. The Custom Trained Model for other languages will show up as another field right down below the English Trained Model, and users can add the translated version of the prime response and probe questions.

If you are using only one language in the Project Language (Overview Page), then the same language will be set as default in the Trained Models Example. Users can then add the prime response and probe questions in the specific language in the field provided. 

**Best practices when using Trained Models for other languages:

• When a language's support score is low, we recommend setting a trained model specific to each question where you are using SmartProbe. We recommend providing at least three positive exemplars from native speakers.
• For all languages, trained models can be used to adjust or steer SmartProbe towards using certain types of words, phrases, or tones.

Conversational Targets

Toggle on/enable when you want to set conversational targets such as a topic, phrase or name (including people/brands/products/etc.) that are of interest to your study, which a participant might mention in their open-ended response. 

To add a conversational target, click the +Add Targets and specify the Target label (topic/phrase/name), Action and Detection Type

• AVOID: ensures that SmartProbe will NOT generate any probe related to this target. If a participant mentions the target, then the probe will divert the conversation away from that target to something else that is still relevant to the research objectives.
• TRIGGER IF DETECTED: triggers SmartProbe to probe on this target if the target is detected. In other words, SmartProbe will probe for more details when a participant has mentioned this target.
• TRIGGER IF NOT DETECTED: triggers SmartProbe to probe on this target if the target is NOT detected. In other words, SmartProbe will acknowledge the participant’s answer but then divert the question so that it focuses on this target.
  
• TRIGGER ALWAYS: triggers SmartProbe to probe on this target always even if other targets are mentioned. 
  
• END CONVERSATION IF DETECTED: triggers SmartProbe to stop probing and move on to the next question in the survey
  
  

Detection Type

There are two Detection Types - Default and Custom. "Default" means the system would detect the target based on the Target label. If users want to provide their own training phrases for each target, then they can choose "Custom", and after that they can provide a few training examples and counter examples.

1. Examples are are variations of the label, related phrases, or other names that you DO want matched.
2. Counter examples are other key words or phrases that you do NOT want matched. 
   

Enable Target Priority

You may provide up to 10 targets per request. Since each request only produces one probe question, if multiple targets are triggered to probe, then SmartProbe will randomly choose one of them to focus on. This randomization behaviour is the default, but you can override by adding a priority field to the target (a number, 1-10, with 1 indicating “highest priority” and 10 indicating “lowest priority”). Each target must have a unique priority number. The order of the targets in the API request is not important: only the priority field indicates a preference between targets.

For the example above, it will probe randomly if "energy" is not mentioned (Trigger if not detected) OR immunity is mentioned (Trigger if detected). However, "immunity" is first in priority thus, the bot will give this priority in probing when mentioned. 


Using Canned Questions

For example, if you want to ask “How did you first hear about product X?” if a participant mentions “product X”, then you can set a target with label “product X” and use any "Trigger if detected” / “Trigger if NOT detected” / “Trigger always" as Action. And then select Custom as Detection Type. Toggle "Click here if you want to define a specific (canned) probing question for the target" and on the new text field, user can type in their canned text or the specific probing question.

In terms of quantifying targets, the mentions will be only counted once on the codeframe upon coding. For the example above, if you set immunity as a target, then the probe will follow up on this, but if the participant mentions immunity again in their response to the probe it will only count once for the quantification on the codeframe.

**Best practices wen using Conversational Targets for other languages:

• Provide the target label in English unless the phrase is specific to the native language. To increase the likelihood of SmartProbe accurately detecting targets, a variant in the native language can also be provided in the training examples.

Other Useful Question Settings

Allow Copy Paste

Allow participants to copy and paste text from different windows or sources. We recommend disabling it when you don't want them to repeat their stock answers without thinking.

Allow User Corrections

By default (Yes), participants are allowed to change their answer in this question type