Install and configure the Gamification solution in Dynamics 365 (online)
The Dynamics 365 - Gamification capabilities are a solution for Dynamics 365 (online), hosted on Microsoft AppSource, that you need to install before you can start using the capabilities to manage your Gamification games, KPIs, and players.
Gamification requires at least Dynamics CRM Online 2016 Update 1.
Users must have a Dynamics 365 (online) license assigned to access the Gamification service.
Users must have an up-to-date browser. More information: Browser requirements to enable a seamless experience in Gamification
Install Dynamics 365 - Gamification
Gamification capabilities in Dynamics 365 are a solution for Dynamics 365 (online) that you install from Microsoft AppSource.
We recommend to adhere to the following limits when working with Gamification to avoid synchronization and performance issues:
- Up to 15 concurrent games.
- Up to 500 users per game.
- Up to 10 fixed teams per game.
- Up to 4000 users across all connected organizations.
To avoid timeout issues when syncing the data of more than 2000 users, you need to change the number of users sent per page in the Gamification settings.
In Dynamics 365, select Advanced Find. Look for Gamification Settings and select Results. Open the Gamification Settings and lower the value for Users sent per page.
Install the solution from AppSource
In AppSource, select Dynamics 365 - Gamification.
Sign in to your Dynamics 365 (online) system admin account, if you aren't already signed in.
Click Get to start installing the solution.
If you have more than one Dynamics 365 (online) organization, select the organization you want to install this solution to.
Review and accept the disclaimer and the terms to add Gamification to Dynamics 365 (online).
It might take a few minutes for the solution to be installed in Dynamics 365 (online).
Game Manager security role in Dynamics 365 (online)
When you install Gamification, a security role called Game Manager is created in Dynamics 365 (online). System admins can assign this security role to Dynamics 365 (online) users who the admins want to enable to create KPIs for Gamification in Dynamics 365 (online).
More information: Available security roles in Gamification
More information about security roles and privileges: TechNet: Security roles and privileges
More information about KPIs in Dynamics 365 (online): Configure KPIs for Gamification in Dynamics 365 (online)
Activate Gamification in Dynamics 365 (online)
Before you can sync Dynamics 365 - Gamification with Dynamics 365 (online), a user who has a global admin role in Office 365 and a system administrator security role in Dynamics 365 (online) needs to complete the setup process to obtain the security key.
Starting with Gamification solution update 17.10, you can connect multiple organizations (business units) of the same Office 365 tenant to a shared Gamification web portal. Repeat the installation and activation for every organization you want to connect to your shared Gamification portal. Users with the Game Manager security role in Organization A can create games for Organization A in Gamification. If they are regular users in Organization B, they can participate as players or fans in games in Organization B. Learn how to set up and run games.
Activate the Gamification portal for your organization
In Microsoft Dynamics 365, go to Settings > Solutions, and then double-click the Gamification solution.
Click Start Activation, and then sign in with your admin credentials.
Accept the disclaimer, and then provide a Name and a Location for your instance of the Gamification portal.
Click Register to start the activation and obtain the security key.
Copy the Security Key, and then paste it in the input box.
Click Authorize to complete the connection between Dynamics 365 (online) and Dynamics 365 - Gamification.
You'll receive an email with additional details, and then you can access your organization's Gamification instance.
Additionally, the system creates a set of default KPIs in Dynamics 365 (online) so you can quickly get started with the first game in Gamification. More information: Configure KPIs for Gamification in Dynamics 365 (online)
To sign in as the first Commissioner, go to Gamification sign-in.
Update the Gamification solution
A system administrator can update the solution.
If an update is available, a notification is displayed on the Gamification Settings page.
Sign in to https://portal.office.com with your global administrator or Microsoft Dynamics 365 system administrator credentials.
Click Admin centers > Dynamics 365.
Click the Instances tab, and then select the instance the solution is connected to.
Select the solution you want to update, and then click Upgrade.
In Microsoft Dynamics 365, go to Gamification > Gamification Settings, and then click Configure App to update all dependencies to the latest version.
This step is required to keep all synchronization processes running.
The system will apply all necessary changes and validate the update to ensure that data keeps flowing smoothly.
You need to repeat the preceding steps whenever you update the solution.
View active games in Dynamics 365
You can view information about the active games in Dynamics 365.
View active games
In Dynamics 365 (online), go to Gamification > Games.
In the list of games, click the name of the game you want to see details about.
In the Game Details section, you'll find basic information about the game, like the name and the start and end date.
In the Setup KPIs section, you can see the KPIs and their setup status in the selected game. More information about KPIs in Dynamics 365 (online): Configure KPIs for Gamification in Dynamics 365 (online)
Uninstall the Gamification solution
You need to remove GamificationUpdate before you remove Gamification. More information about removing a preferred solution: [Delete a preferred solution](https://technet.microsoft.com/library/dn878909.aspx#Delete a preferred solution)
By installing and enabling the Dynamics 365 - Gamification solution, the enabling user’s account identifiers (such as first name, last name, and email address) will be stored in Azure to allow for authorization with the Gamification service, which is hosted in Azure. This applies to all users that are enabled in the Gamification service by their administrator. The Gamification solution sends Key Performance Indicators (KPI) data, configured by an administrator, to the Azure service, and that data is stored in Azure structured storage as well as blob storage. Each user’s Avatar, Custom Awards, and Company Logo are stored in Azure, but the information is not returned to Dynamics 365.
Note that administrators and authorized users can leverage Dynamics 365 data, such as phone calls, opportunities, and booked revenue to configure KPIs for use in games. The Gamification service does not initiate any calls to Dynamics 365 and only responds to data, such as games where the KPIs are being used, that flows back to Dynamics 365.
An administrator can also enable the Gamification TV stream to be made public. Game managers who set up Gamification TV streams and enable public streaming will allow for the TV stream to be viewed by anyone on the Internet who has the stream link.
An administrator can subsequently remove the Gamification functionality by uninstalling this solution from the Dynamics 365 organization.
Azure components and services that are involved with Gamification are detailed in the following sections.
Note: For more information about additional Azure service offerings, see the Microsoft Azure Trust Center.
Designer Service (Web Role)
This provides multiple Web Services for communication between a Dynamics 365 organization and the multi-tenanted Gamification Azure components. For example, gamification details stored to Azure SQL Storage. Game calculations use Azure Service Bus queue and returned to be scored and shown in the service. Customer and user uploaded images are stored in Azure Blob Storage. All requests are authenticated against Azure Active Directory.
All services store configuration data in Azure Key Vault.
Gamification uses SQL Azure to store:
Organization (tenant) data
Avatars, company logos, and other customer uploaded images are stored in Azure Blob Storage.
Gamification uses Azure Active Directory to authenticate users and determine eligibility to use the platform.
Overview for commissioners and game managers in Gamification
Configure KPIs for Gamification in Dynamics 365 (online)
Import players and fans from Dynamics 365 (online) and manage their security roles
Set up and run games in Gamification
Privacy information and license terms for Gamification