Simulator
The Simulator allows you to load all the standard Mambo widgets for any end-user in the system on a single page. This provides visibility into how your users will experience the engagement strategy you've configured. For example, you can verify how your personalisation tags affect what each user can see. The simulator also allows you to manually track activities for users so you can observe how they impact the results in the widgets.
Managing simulations
It's possible to create different simulations for different users. This is useful when testing users with different personalisation tags. For example, you might want to load a user from the sales department, one from the support department, and one from IT to see how their profiles differ.
The controls for creating new simulations, loading existing simulations, or saving simulations can be found in the top right-hand corner of the simulator page.
The buttons, from left to right, are:
- Create new simulation: This clears out the current simulation and allows you to start with a clean slate. You will be prompted before clearing the current simulation in case you forgot to save any changes.
- Load simulation: This brings up a window where you can load, clone or delete existing simulations.
- Save simulation: This allows you to provide your simulation with a name and save it for later. After the first time you save a simulation, you will also be given the option to "Save as new". This allows you to save a brand new simulation with the same settings as the one currently loaded.
When you first load the simulator, you will see "Simulator - Unsaved Simulation" in the top left-hand corner. Once you save the simulation, the name you choose will be displayed instead of "Unsaved Simulation". Any time you make a change to the simulation, a red asterisk will appear next to its name. This is a reminder that the simulation needs to be saved. Note that your changes will be temporarily saved locally, but if you don't save them using the "Save simulation" button, the changes will not be stored indefinitely.
Just below the name of your simulation, you will have a toolbar with the buttons displayed in the image above. The options are:
- User search: This allows you to search through your users. Type at least 3 letters to start the search.
- Create activities: Use this to manually create activities for the selected user. Creating an activity here will also generate notifications when relevant. For example, if you assign the user points or create a behaviour, notifications will appear in the bottom right-hand corner of the screen.
- Open portal: Use this to open the selected user's portal page.
- Main settings: This provides you with configuration options that apply to all the widgets. This includes colour themes, language, level settings, notification options, social sharing options and more.
- Get code: This will open a window containing the JavaScript code needed to embed the Mambo widgets on your own page. The code displayed will include all the changes made in the Main Settings window. This means you can change the settings and then get the updated code using this button.
Managing widgets
Each widget on the page will have two options available: Settings and Get code.
The Settings option opens a window where you can configure the widget. Each widget has its own settings which we won't explain here as each setting comes with a detailed tooltip explaining how it works.
The Get code option opens a window containing the JavaScript code needed to embed the specific widget on your own page. The code displayed will include all the configuration changes made using the Settings window.
For technical information on how the widgets work, please refer to the JavaScript SDK documentation.