Localization
Inclusive research initially referred to studies that employed approaches designed to work with participants who have learning or intellectual disabilities. Scholars are increasingly expanding the scope of this definition to cover any research project that attempts to work with groups of people who are usually neglected in studies. These people could belong to minority nationalities, races, sexual orientations, or gender identities. They could come from lower economic classes and underrepresented age or language groups.
One of the most common and effective methods applied by researchers to achieve such inclusivity is localization. Researchers can appeal to a more diverse language group, include a larger collection of participants, reach less biased conclusions, and increase the applicability of their research results.
Localization in Avicenna can be divided into two general categories: localization of the app interface and localization of the study content (i.e., multilingual studies). Each of them is explained below.
App Interface Localization
The Avicenna participant app is currently available, for Android, iOS, and web, in the following languages:
- Catalan
- Chinese
- Dutch
- English
- French
- German
- Italian
- Persian (Farsi)
- Portuguese
- Slovenian
- Spanish
- Spanish Colombian
- Urdu
- Welsh
- Zulu
If you are interested in helping us translate Avicenna into your local language, we would love to hear from you.
The Avicenna app, available for both Android and iOS, automatically sets its user interface language to match the system language by checking and updating it each time the app is opened. If Avicenna is not available in the system language, it switches to English by default.
Participants can also choose the language by opening the Avicenna app, going to
the Settings → Languages
, and then selecting their desired language. This will
override the language of their phone, and instructs Avicenna to always appear in
the language they chose, regardless of the language of their phone:
Study Content Localization
Avicenna supports creating studies where the content, for example, the consent materials, survey questions, or notifications, are translated and available in multiple languages. This way every participant interacts with the study using their app language, wherever applicable.
Adding Localization
By default, Avicenna assumes your study is only available in one language. We refer to this as the Base Language. It can be any language. For example, if your participants are predominantly familiar with Dutch, you can consider the Base Language to be Dutch. Note that you do not have to set Base Language to anything. Base Language just refers to the language of the content you enter in your study when no language is chosen.
Now, you may choose to have your study only in one language, for example, Dutch. In this case, all you need to do is enter all fields of study in Dutch. Hence, the participants will also see the study in Dutch. Note that Avicenna doesn't actually know which language you're using as the Base Language.
If you choose to add other languages to your study, you can do that through the
researcher dashboard by selecting your study and navigating to the Basics
page. Towards the bottom of the page, you will find the Localization
table.
As you have not added any localization, you will notice that the table is empty.
Click on Add
to add a new language. Avicenna supports study content
localization for the same languages
mentioned above.
For example, you may decide to add an English translation for your study as
well, for those participants who cannot understand Dutch. In this case, you can
add English
to your study localization. As a result, your study will have two
languages: the Base Language which is Dutch, and English.
If your study contains at least one localization, like the last example, the Researcher Dashboard will show a Language Selector option next to all text, and in some cases image fields across the entire study, as shown below:
Sometimes, you might find the Language Selector at the top of a dialog, in a
section next to the title, or in a tab (like the Settings
tab of activity
editors). In such cases, all available fields in that dialog, section, or the
whole page (in the case of activity editors) are considered translatable. So,
you can provide translations for all of them by simply changing the localization
in that selector, as shown below:
In this case, when you are adding content to a given field, by default the Language Selector (hence the content you want to modify) will be in the Base language. You can open the Language Selector next to the field, choose one of the localizations, and then enter/select the translation of that content into the new language.
The Base Language can be any language, not necessarily one of the languages listed here. Localization can also be done in any language of your choice. In theory, you can add the content of the Base Language in a language like Dutch, and add the same Dutch translation as well. While this is possible, it does not make sense semantically and will have no impact on how Avicenna shows the localized content.
Displaying Localized Content
If your study is available in multiple languages, Avicenna chooses the right language before showing any content, such as the app homepage, a survey, or a notification. The language is detected based on the following algorithm:
- Avicenna checks whether the participant has chosen a language in the app's Settings. If yes, Avicenna uses it as the participant's preferred language.
- If no, Avicenna checks whether the participant's phone has been set to a specific language. If yes, Avicenna uses it as the participant's preferred language.
- If no custom language is chosen from steps 1 and 2, Avicenna sets the participant's language to Base.
- For showing every study content, Avicenna checks whether the content is provided by the researcher in the participant's preferred language.
- If the content is available in the participant's preferred language, then Avicenna shows the content in that language.
- If the content is not available in the participant's preferred language, the Base version of the content is loaded and shown.
Note that you should always provide the Base version of each content. So Avicenna can always fall back to displaying the Base content.
Removing Localization
To remove a given localization from your study, open the Researcher Dashboard,
select your study, and navigate to the Basics page. In the Localization
table, select the languages you want to remove, and press Remove
. You'll be
prompted with a confirmation dialog. If you confirm, the selected localizations
and all translated content related to them will be removed.
This action cannot be undone. If you have entered a substantial amount of localized content, removing the localization will delete all of it.