Page
Page Activity allows you to display an HTML web page to the participants via the Avicenna app. You can create the page via any tool you prefer, for example, by using common weblog services or by programming it and hosting it on your local server. The page can contain any information you want to present to your participants via the app.
The only requirement is that the page must have a public URL (e.g., https://avicennaresearch.com) and be hosted on a secure website, i.e., the URL should start with https.
Like other Activities such as Surveys, Page Activity can also have Triggering Logics, though only User TLs are supported. You cannot add Triggering Logics other than User TL to your Page Activity. There is no Session defined for Page Activity, and you cannot define any Notification Templates for them either. You can, however, set a Criteria on a Page Activity or its Triggering Logics.
To add a new Page Activity to your study, go to the Researcher Dashboard,
navigate to the Activities page, click on Create New Activity
, and choose
Page
. After creating such activity, you will be then directed to the Page
Activity Editor, as shown in the following image:
There is only one option you can set for the Page Activity, and that's the URL you want to display when the participant launches this Activity. After setting the URL, add a User TL to your Activity, and then set any Criteria if necessary. Then you can publish your Activity and try it in the Avicenna app.
In the Avicenna app, participants will always have access to the button to launch this Activity and view the specified web page. Similar to other Activities, the icon and the caption of this Activity are the same as what you have specified in the Page Activity Editor. Clicking on this button will show the web page directly in the Avicenna app.
Homepage of the Avicenna app with a Page Activity | Avicenna app shows the specified URL to the participant |
The app is designed to open this URL inside the app and doesn't take the participant to an external browser. Furthermore, to ensure the participant has a seamless experience, the components of the Page Activity viewer are kept to the minimum, So you can design your web page to appear as an integral part of the main application. This allows you to extend the app's functionality by adding dynamic content to it.
Placeholders
You can use placeholders in the URL of a Page activity to show different web pages to different participants based on their context. The placeholders are replaced with the actual values when the participant opens the Page activity.
Currently, we support only one placeholder: {{participant_id}}
. As the name
suggests, this refers to the participant's ID.