Page History

Anchor
gamify_choose_user_attribute_to_group_by gamify_choose_user_attribute_to_group_by

Step 2: Choose User Attribute to Group Users By

In order to divide all users into groups that will compete with each other based on their organizational information (department, office, etc.), select which user profile attribute you would like to group users by.

This information will be taken from SharePoint user profiles. If you have created custom profile properties you can also use them.

Gamify Configuration Screen: Step 2

Anchor
gamify_add_tracking_code gamify_add_tracking_code

Step 3: Add The Gamify Tracking Code To Your Sites

This step allows you to add the JavaScript tracking code to each of your sites. 

You can add the tracking code to specific sites or deploy it on all selected site collections automatically.

Gamify Configuration Screen: Step 3

Deploying the Tracking Code to all Selected Site Collections Automatically

1. Download the automatic deployment Package from the "Add the Gamify Tracking Code to your Sites" step in the Configuration page.
   The package includes a PowerShell script that deploys the tracking agent wsp solution, modern sites integration app and the Java Script tracking code on all selected site collections.
2. Right click the downloaded package zip file, select Properties > General and click on "Unblock" before unzipping it.
3. Execute the Run_Script.ps1 script in Windows PowerShell (do not use Windows PowerShell ISE version). Make sure to close all browser windows on your machine before executing the script.
   Note: You must have the MS Online module installed and the credentials of the SharePoint Online global administrator.

Add the Tracking Code to a Site Collection Manually

1. Browse to your SharePoint Online site Solution Gallery. The gallery should be found at this address by replacing the website root URL with yours: https://company.sharepoint.com/_catalogs/solutions/forms/allitems.aspx
2. From your Solution Gallery, click Upload Solution > Choose File. Then select CardioLog Analytics Integration.wsp and click Activate.
3. If you are presented with a request for access, go to the Admin Center, found under the Office 365 Admin menu.
   1. From the SharePoint Admin Center select Settings.
   2. Choose Custom Script.
   3. Select Allow for both options. (Allow users to run custom script on personal sites & Allow users to run custom script on self-service created sites)
   4. Allow custom scripts on all site collections you wish to monitor:
      1. The preference change may take up to 24 hours. In order to force the change to take place immediately, you may download and run the SharePoint Online Management Shell.
      2. Follow Microsoft's instructions for connecting it to your SharePoint Online tenant, 

      3. For classic sites, execute the following shell command:

         Code Block
         Set-SPOsite <SiteURL> -DenyAddAndCustomizePages 0

         
         

      4. For modern sites, execute the following shell command (edit the #parameters section):
         
         

         Code Block
         #Parameters

         
         

         $TenantAdminURL= "https://company-admin.sharepoint.com"

         
         

         $SiteURL= "https://company.sharepoint.com/sites/site"

         
         

         #Connect to Tenant Admin

         
         

         Connect-PnPOnline $TenantAdminURL -UseWebLogin

         
         

         #Get the Tenant Site Object

         
         

         $Site = Get-PnPTenantSite -Url $SiteURL

         
         

         #Enable Custom Scripting by turning OFF Deny Flag

         
         

         $Site.DenyAddAndCustomizePages = "Disabled"

         
         

         $Site.Update()

         
         

         $Site.Context.ExecuteQuery()

          

      5. Once the solution is installed, return to the Gamify configuration screen and copy the JavaScript tracking code.

      6. Browse to CardioLog Analytics Integration solution configuration page. The page should be found at this address by replacing the website root URL with yours: https://company.sharepoint.com/CardioLogAnalytics/Configuration.2.0.8.0.aspx

      7. Paste the tracking code copied from the "Add the Gamify Tracking Code to your Sites" step and click OK.

      8. To enable support for tracking SharePoint Online modern sites and pages, install the Tracking Agent App:

         1. Download the automatic deployment package from the "Add the Gamify Tracking Code to your Sites" step in the configuration page.

         2. Upload CardioLogTrackingAgentAddin.sppkg app to the SharePoint Admin apps > App Catalog > Apps for SharePoint > New:

         3. Click Deploy (do NOT select "Make this Solution available to all sites in the organization")

         4. Go to the tracked Site Collection > Site Contents > New App

         5. Click on Apps from your organization and click CardioLog Tracking Agent (it will be installed automatically)

      Note: The tracking code contains links to the Events Listener web application in Azure.

      Anchor
      gamify_user_roles_management gamify_user_roles_management

      Step 4: User Roles Management 

      In order to access the Gamify admin dashboard, select the users you would like to grant the admin role to. 

      1. Connect with an account that is a global administrator in your Office 365 tenant. This account will be used in order to approve the required permissions for the Gamify Azure AD App to manage user roles in Azure AD.
         
         Image Modified
         Gamify Configuration Screen: Step 4
         
         
      2. Click Accept to approve the required permissions.
      3. In order to grant the admin role to a user, enter the user principal name (UPN) and click Save.
         
         Image Modified
         Gamify Configuration Screen: Step 4