Reporting

How can I report the activities done within the application?

In these days when the importance of data increases, we attach great importance to the reporting system at Motivacraft. To easily access the reports, you must first click on the “Reports” tab on the left side of the administration panel. Here you can report users’ logins to the application, earned xp, level and motives, badges, completed tasks, tests and activities. You can also customize these reports by selecting the date ranges you want to receive. Then, by clicking the “Export” button, you can download the reports you selected as Excel files and increase in-application efficiency with these reports.

How can I report the activities done within the application?

In these days when the importance of data increases, we attach great importance to the reporting system at Motivacraft. To easily access the reports, you must first click on the “Reports” tab on the left side of the administration panel. Here you can report users’ logins to the application, earned xp, level and motives, badges, completed tasks, tests and activities. You can also customize these reports by selecting the date ranges you want to receive. Then, by clicking the “Export” button, you can download the reports you selected as Excel files and increase in-application efficiency with these reports.

API & Development

This document explains how to transfer values related to activities from your own reporting and analysis software to the Motivacraft platform. The links shared in this document direct you to a test environment created for you to test your data flow. After ensuring that your connection is working properly and accurately transferring the required information, please inform us. Following that, the Motivacraft team will provide you with the real token specific to your company and additional connection links.

If you need support during the process, you can contact our technical team at [email protected]. Our team will try to get back to you within one business day. We would like to thank you in advance for your understanding in case of any delays during busy periods.

Game API

Game APIs (Application Programming Interfaces) are software interfaces used by developers to interact with games and access game-related data. Game APIs provide a set of functions and services to access the content of the game, game state, and other related features. Game developers can use these APIs to extend, customize, and integrate their games with different platforms and services.

User Activity Log

POST: api/v{version}/User/metric 

Version: 1

Request Body:

				
					{
  "metricId": 0,
  "articleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "questionId": 0,
  "parameters": [
    {
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    }
  ],
  "firmId": "string",
  "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "eventCreatedDate": "2023-07-26T19:36:43.092Z",
  "customerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "isRollback": true,
  "transactionId": "string"
}
				
			

Responses:

				
					200 SUCCESS
{
  "success": true,
  "hasQuestion": true,
  "questionId": 0
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			

An example activity log pattern is as follows:

				
					{
    "metricId: {AKTIVITE ID},
    "parameters": [
        {
            "{PROPERTY ID}": "{GERCEKLESEN}",
            "{2.PROPERTY ID}": "{2.GERCEKLESEN}"
        }
       ]
       "firmId": "{KULLANICI ID}"
}
				
			
  • The areas mentioned in curly brackets here are:
    – Activity ID: You can change this part by using the Activity ID corresponding to the activity.
    – Property ID: It is changed with the “property” of the data that may occur depending on that activity.
    – Actual: The data information that took place in the relevant “property” of the activity to be sent is given here.
    – There is no need to give string values such as TL and PCS next to them.
    – Numeric properties can be sent as rational numbers.
    – If a numeric Property has textual data, it will give an error. Only numbers should be sent.
    – User ID: The unique ID of the user whose data will be sent must be sent in the customer system.

Company Activities

GET: /api/v{version}/Metric/all

Version: 1

Responses:

				
					200 SUCCESS
{
  "metrics": [
    {
      "id": 0,
      "metricCategoryId": 0,
      "name": "string",
      "isActive": true,
      "defaultXp": 0,
      "type": 1,
      "defaultUnit": 0,
      "hasDescription": true,
      "code": "string",
      "defaultPoint": 0,
      "defaultXpCoefficient": 0,
      "isManual": true
    }
  ]
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			

The metrics defined for the company are returned.

Creating Activity Properties

POST: /api/v{version}/Metric/properties

Version: 1

Request Body:

				
					{
  "name": "string",
  "type": 1,
  "isActive": true
}
				
			

Responses:

				
					200 SUCCESS
{
  "success": true,
  "propertyId": 0,
  "fieldId": 0
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			
  • Property types:
    ○ Bool = 1
    ○ Numeric = 2
    ○ Text = 3

Learning the Characteristics of the Activity

GET: /api/v{version}/Metric/properties

Version: 1

Responses:

				
					200 SUCCESS
[
  {
    "id": 0,
    "name": "string",
    "type": 1,
    "isActive": true
  }
]
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			
  • Property types:
    ○ Bool = 1
    ○ Numeric = 2
    ○ Text = 3

Company Activity Categories

GET: /api/v{version}/Metric/category/all

Version: 1

Responses:

				
					200 SUCCESS
{
  "metricCategories": [
    {
      "id": 0,
      "name": "string",
      "isActive": true
    }
  ]
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			

User's Roles

GET: /api/v{version}/User/missions

Version: 1

Responses:

				
					200 SUCCESS
{
  "userMissions": [
    {
      "id": 0,
      "categoryId": 0,
      "orderNumber": 0,
      "isJoinable": true,
      "isVisible": true,
      "name": "string",
      "progress": 0,
      "endDate": "2023-07-26T20:07:02.937Z",
      "startDate": "2023-07-26T20:07:02.937Z",
      "progressItems": [
        "string"
      ],
      "progressItemList": [
        {
          "targetType": "string",
          "metricName": "string",
          "metricPropertyName": "string",
          "userValue": "string",
          "userTarget": "string"
        }
      ]
    }
  ],
  "generalMissions": [
    {
      "id": 0,
      "categoryId": 0,
      "orderNumber": 0,
      "isJoinable": true,
      "isVisible": true,
      "name": "string",
      "progress": 0,
      "endDate": "2023-07-26T20:07:02.937Z",
      "startDate": "2023-07-26T20:07:02.937Z",
      "progressItems": [
        "string"
      ],
      "progressItemList": [
        {
          "targetType": "string",
          "metricName": "string",
          "metricPropertyName": "string",
          "userValue": "string",
          "userTarget": "string"
        }
      ]
    }
  ],
  "userCompletedMissions": [
    {
      "id": 0,
      "categoryId": 0,
      "orderNumber": 0,
      "isJoinable": true,
      "isVisible": true,
      "name": "string",
      "progress": 0,
      "endDate": "2023-07-26T20:07:02.937Z",
      "startDate": "2023-07-26T20:07:02.937Z",
      "progressItems": [
        "string"
      ],
      "progressItemList": [
        {
          "targetType": "string",
          "metricName": "string",
          "metricPropertyName": "string",
          "userValue": "string",
          "userTarget": "string"
        }
      ]
    }
  ]
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			
  • “userMissions” means active tasks of the user,
  • “generalMissions” missions that the user cannot complete,
  • “userCompletedMissions” returns user completed tasks.

Auth API

The Auth API, short for “Authentication API,” serves a specific purpose in software development. Authentication is the process of verifying the identity of users, and an Auth API is a programming interface provided by an application to manage and authorize user authentication processes.

The Auth API offers developers a set of functions and methods to facilitate user authentication and authorization. This API can be used to handle operations such as user registration, password validation, user account creation and management, and more.

Receiving Guest Token

GET: /api/v{version}/Auth/{token}

Version: 1

Responses:

				
					200 SUCCESS
{
  "type": "string",
  "token": "string",
  "expireIn": 0,
  "role": 0
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			
  • An unauthenticated guest bearer token is returned.
  • In order to get a guest token, you can get the token information you need to specify in the root section from the institution settings section of your company’s admin panel.

User Login

POST: /api/v{version}/Auth/login

Version:

Request Body:

				
					
  "userName": "string",
  "password": "string",
  "companyId": "string"
}
				
			

Responses:

				
					200 SUCCESS
{
  "type": "string",
  "token": "string",
  "expireIn": 0,
  "role": 0
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			
  • If this request is successful, using the guest bearer token from the previous End-Point, an authenticated bearer token is returned.
  • In addition, role information is returned as 1 if the user is admin and as 2 if the user is an unauthorized user.

Register

POST: api/v{version}/Auth/register

Version: 1

Request Body:

				
					{
  "displayName": "string",
  "email": "string",
  "password": "string",
  "passwordConfirm": "string",
  "image": "string",
  "domain": "string",
  "invitationToken": "string",
  "companyName": "string",
  "defaultCulture": "string",
  "demoType": 1
}
				
			

Responses:

				
					200 SUCCESS
{
  "type": "string",
  "token": "string",
  "expireIn": 0,
  "role": 0
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			
  • If there is no authenticated bearer token during registration, the guest bearer token should be used.
  • If user registration is successful, authenticated bearer token is also returned.
  • If the user is requested to register with a certain company, it can be ensured that the company is registered by using the InvitationToken belonging to that company.
  • If the user does not have a company and the company will be created with this user, if the “companyName” part is filled, the company belonging to this user will be created.

Getting Started

How do I login to the application?

To log in to the application, you can log in to our website by typing motivacraft.com in the address line of your internet browser on your desktop or laptop computer or iOS/Android tablets. Then, by clicking on the “Login” option at the top right of the main page, you will reach the page where you will enter your information. Here, you will first enter the username given to you by your game administrator or created by yourself, and then your password. After entering your information, you can log in to the application by clicking the “Log In” button. You can also select the language you want on this screen and access the links created for you to download our mobile application.

What information can I access in the profile section?

By clicking on the “My Profile” tab in the upper right corner of the screen, you can follow a general statistics of the activities you have done in Motivacraft, see the activities you have done, see the badges you have earned, and also find a section where you can make adjustments to your game. When you click on the My Profile tab, you will see four different sections on the left. In the “My Profile” section at the top, you will see the statistics of the activities you have done in the game (such as the tasks you have completed, the XP you have earned and the articles you have read). In the “My Activities” section, which is in the second place, you can see all the activities you have done in the past and are currently active. In the “My Badges” section in the third row, you will see the badges you have earned or can earn. In the “Edit” section at the bottom, you can change the language option, change your avatar and renew your password. Come on, keep raising your on-screen stats!

Can I change the language settings of the application?

Motivacraft has a flexible structure that is used in many countries globally and can be adapted to more than one language. If you want to change the language option in the game, you must first click on the “My Profile” tab in the upper right corner of the screen. Then, when you click on the “Edit” option on the left side of the screen, you will be able to see the active language option. Here you can choose one of the language options presented to you. We keep working to add more language options!

Developer Guide

This document explains how to transfer values related to activities from your own reporting and analysis software to the Motivacraft platform. The links shared in this document direct you to a test environment created for you to test your data flow. After ensuring that your connection is working properly and accurately transferring the required information, please inform us. Following that, the Motivacraft team will provide you with the real token specific to your company and additional connection links. In addition to the links provided here, you can also use the following documents to test on your own:

Test environment links:

https://test-auth.motivacraft.app/swagger/index.html

https://test-user.motivacraft.app/swagger/index.html

https://test-game.motivacraft.app/swagger/index.html

https://test-form.motivacraft.app/swagger/index.html

https://test-content.motivacraft.app/swagger/index.html

If you need support during the process, you can contact our technical team at [email protected]. Our team will try to get back to you within one business day. We would like to thank you in advance for your understanding in case of any delays during busy periods.

API & Development

This document explains how to transfer values related to activities from your own reporting and analysis software to the Motivacraft platform. The links shared in this document direct you to a test environment created for you to test your data flow. After ensuring that your connection is working properly and accurately transferring the required information, please inform us. Following that, the Motivacraft team will provide you with the real token specific to your company and additional connection links.

If you need support during the process, you can contact our technical team at [email protected]. Our team will try to get back to you within one business day. We would like to thank you in advance for your understanding in case of any delays during busy periods.

Auth API

The Auth API, short for “Authentication API,” serves a specific purpose in software development. Authentication is the process of verifying the identity of users, and an Auth API is a programming interface provided by an application to manage and authorize user authentication processes.

The Auth API offers developers a set of functions and methods to facilitate user authentication and authorization. This API can be used to handle operations such as user registration, password validation, user account creation and management, and more.

Receiving Guest Token

GET: /api/v{version}/Auth/{token}

Version: 1

Responses:

				
					200 SUCCESS
{
  "type": "string",
  "token": "string",
  "expireIn": 0,
  "role": 0
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			
  • An unauthenticated guest bearer token is returned.
  • In order to get a guest token, you can get the token information you need to specify in the root section from the institution settings section of your company’s admin panel.

User Login

POST: /api/v{version}/Auth/login

Version:

Request Body:

				
					
  "userName": "string",
  "password": "string",
  "companyId": "string"
}
				
			

Responses:

				
					200 SUCCESS
{
  "type": "string",
  "token": "string",
  "expireIn": 0,
  "role": 0
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			
  • If this request is successful, using the guest bearer token from the previous End-Point, an authenticated bearer token is returned.
  • In addition, role information is returned as 1 if the user is admin and as 2 if the user is an unauthorized user.

Register

POST: api/v{version}/Auth/register

Version: 1

Request Body:

				
					{
  "displayName": "string",
  "email": "string",
  "password": "string",
  "passwordConfirm": "string",
  "image": "string",
  "domain": "string",
  "invitationToken": "string",
  "companyName": "string",
  "defaultCulture": "string",
  "demoType": 1
}
				
			

Responses:

				
					200 SUCCESS
{
  "type": "string",
  "token": "string",
  "expireIn": 0,
  "role": 0
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			
  • If there is no authenticated bearer token during registration, the guest bearer token should be used.
  • If user registration is successful, authenticated bearer token is also returned.
  • If the user is requested to register with a certain company, it can be ensured that the company is registered by using the InvitationToken belonging to that company.
  • If the user does not have a company and the company will be created with this user, if the “companyName” part is filled, the company belonging to this user will be created.

Game API

Game APIs (Application Programming Interfaces) are software interfaces used by developers to interact with games and access game-related data. Game APIs provide a set of functions and services to access the content of the game, game state, and other related features. Game developers can use these APIs to extend, customize, and integrate their games with different platforms and services.

User Activity Log

POST: api/v{version}/User/metric 

Version: 1

Request Body:

				
					{
  "metricId": 0,
  "articleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "questionId": 0,
  "parameters": [
    {
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    }
  ],
  "firmId": "string",
  "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "eventCreatedDate": "2023-07-26T19:36:43.092Z",
  "customerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "isRollback": true,
  "transactionId": "string"
}
				
			

Responses:

				
					200 SUCCESS
{
  "success": true,
  "hasQuestion": true,
  "questionId": 0
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			

An example activity log pattern is as follows:

				
					{
    "metricId: {AKTIVITE ID},
    "parameters": [
        {
            "{PROPERTY ID}": "{GERCEKLESEN}",
            "{2.PROPERTY ID}": "{2.GERCEKLESEN}"
        }
       ]
       "firmId": "{KULLANICI ID}"
}
				
			
  • The areas mentioned in curly brackets here are:
    – Activity ID: You can change this part by using the Activity ID corresponding to the activity.
    – Property ID: It is changed with the “property” of the data that may occur depending on that activity.
    – Actual: The data information that took place in the relevant “property” of the activity to be sent is given here.
    – There is no need to give string values such as TL and PCS next to them.
    – Numeric properties can be sent as rational numbers.
    – If a numeric Property has textual data, it will give an error. Only numbers should be sent.
    – User ID: The unique ID of the user whose data will be sent must be sent in the customer system.

Company Activities

GET: /api/v{version}/Metric/all

Version: 1

Responses:

				
					200 SUCCESS
{
  "metrics": [
    {
      "id": 0,
      "metricCategoryId": 0,
      "name": "string",
      "isActive": true,
      "defaultXp": 0,
      "type": 1,
      "defaultUnit": 0,
      "hasDescription": true,
      "code": "string",
      "defaultPoint": 0,
      "defaultXpCoefficient": 0,
      "isManual": true
    }
  ]
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			

The metrics defined for the company are returned.

Creating Activity Properties

POST: /api/v{version}/Metric/properties

Version: 1

Request Body:

				
					{
  "name": "string",
  "type": 1,
  "isActive": true
}
				
			

Responses:

				
					200 SUCCESS
{
  "success": true,
  "propertyId": 0,
  "fieldId": 0
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			
  • Property types:
    ○ Bool = 1
    ○ Numeric = 2
    ○ Text = 3

Learning the Characteristics of the Activity

GET: /api/v{version}/Metric/properties

Version: 1

Responses:

				
					200 SUCCESS
[
  {
    "id": 0,
    "name": "string",
    "type": 1,
    "isActive": true
  }
]
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			
  • Property types:
    ○ Bool = 1
    ○ Numeric = 2
    ○ Text = 3

Company Activity Categories

GET: /api/v{version}/Metric/category/all

Version: 1

Responses:

				
					200 SUCCESS
{
  "metricCategories": [
    {
      "id": 0,
      "name": "string",
      "isActive": true
    }
  ]
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			

User's Roles

GET: /api/v{version}/User/missions

Version: 1

Responses:

				
					200 SUCCESS
{
  "userMissions": [
    {
      "id": 0,
      "categoryId": 0,
      "orderNumber": 0,
      "isJoinable": true,
      "isVisible": true,
      "name": "string",
      "progress": 0,
      "endDate": "2023-07-26T20:07:02.937Z",
      "startDate": "2023-07-26T20:07:02.937Z",
      "progressItems": [
        "string"
      ],
      "progressItemList": [
        {
          "targetType": "string",
          "metricName": "string",
          "metricPropertyName": "string",
          "userValue": "string",
          "userTarget": "string"
        }
      ]
    }
  ],
  "generalMissions": [
    {
      "id": 0,
      "categoryId": 0,
      "orderNumber": 0,
      "isJoinable": true,
      "isVisible": true,
      "name": "string",
      "progress": 0,
      "endDate": "2023-07-26T20:07:02.937Z",
      "startDate": "2023-07-26T20:07:02.937Z",
      "progressItems": [
        "string"
      ],
      "progressItemList": [
        {
          "targetType": "string",
          "metricName": "string",
          "metricPropertyName": "string",
          "userValue": "string",
          "userTarget": "string"
        }
      ]
    }
  ],
  "userCompletedMissions": [
    {
      "id": 0,
      "categoryId": 0,
      "orderNumber": 0,
      "isJoinable": true,
      "isVisible": true,
      "name": "string",
      "progress": 0,
      "endDate": "2023-07-26T20:07:02.937Z",
      "startDate": "2023-07-26T20:07:02.937Z",
      "progressItems": [
        "string"
      ],
      "progressItemList": [
        {
          "targetType": "string",
          "metricName": "string",
          "metricPropertyName": "string",
          "userValue": "string",
          "userTarget": "string"
        }
      ]
    }
  ]
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			
  • “userMissions” means active tasks of the user,
  • “generalMissions” missions that the user cannot complete,
  • “userCompletedMissions” returns user completed tasks.

User API

User API is a powerful programming interface used to manage user accounts and interact with users within an application or platform. This API enables developers to easily integrate user-centric functionalities such as processing user data, managing login and registration processes, and updating user profile information. User APIs are employed in a wide range of digital platforms, from social media integrations to online store applications. In summary, the User API empowers developers with robust user management and interaction capabilities, facilitating the development of more effective and user-focused applications.

User Registration

POST: /api/v{version}/User

Version: 1

Request Body:

				
					{
  "companyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "userName": "string",
  "displayName": "string",
  "email": "string",
  "password": "string",
  "role": 1,
  "image": "string",
  "cultureInfo": "string",
  "tagIds": [
    0
  ],
  "firmId": "string",
  "userIds": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}
				
			

Responses:

				
					200 SUCCESS
{
  "success": true,
  "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			
  • If the user registration is successful, the user Id of the created user is returned.
  • Role types can be:
    ○ Manager = 1,
    ○ User = 2,
    ○ Group User = 3,
    ○ Integration User = 4,
    ○ Report User = 5
  • If a report is requested to be sent to the users’ e-mails, the e-mail information must be filled while creating the user.
  • Password field should be sent unencrypted.
  • The firmId field can be used to add the user’s unique Id in the client system. By using this firmId, data can be sent in data integrations.
  • The userIds field is only for role = 3 ie group users. The activities of the users whose IDs are given here are reflected to this user. This is the setup that should be used for group setups.
  • If the user registration is successful, the user Id of the created user is returned.
    ● Role types can be:
    ○ Manager = 1,
    ○ User = 2,
    ○ Group User = 3,
    ○ Integration User = 4,
    ○ Report User = 5
    ● If a report is requested to be sent to the users’ e-mails, the e-mail information must be filled while creating the user.
    ● Password field should be sent unencrypted.
    ● The firmId field can be used to add the user’s unique Id in the client system. By using this firmId, data can be sent in data integrations.
    ● The userIds field is only for role = 3 ie group users. The activities of the users whose IDs are given here are reflected to this user. This is the setup that should be used for group setups.
    ● tagIds contains the Ids that the user wants to have.
    ● CultureInfo:
       ○ en-TR
       ○ en-US
       It can take one of its values.

Disabling the User

PUT: /api/v{version}/User/{id}/make-passive

Version: 1

Responses:

				
					200 SUCCESS
{
  "success": true
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			

Activating the User

PUT: /api/v{version}/User/{id}/make-active

Version: 1

Responses:

				
					200 SUCCESS
{
  "success": true
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			

How can I create a new video?

To create a new video, you must first click on the “Videos” tab on the left side of the admin panel. Before creating a video, you need to add a video category here. To do this, you must press the “+” button you will see on the screen. Here you can write the name of the video category and the order in which you want it to appear in the player panel. You should then return to the “Videos” menu again. You can see all the videos he created here. To add a new video, you must first select a category and then press the “New Video” button at the top right. This is the video creation section. First, you must write the video name and description. In the “Advanced Settings” section, you need to upload the video file and choose how long to give it to users. If you want, you can add a test at the end of this video. In the “Users & Awards” section, you must choose which users you will assign the video to and then choose the reward you will distribute. After pressing the “Submit” button, you can successfully create a new video. Congratulations!

How can I download the iOS version of the app?

To access our mobile application that we have created so that you can easily access Motivacraft from anywhere, you can download it from the link you will reach by clicking the “Download from App Store” option on the home screen. You can also install the application that comes up by typing “Motivacraft” in the App Store and enjoy gamification anywhere!

How can I use MotivacraftTV?

We will show you how to use MotivacraftTV step by step.We will show you how to use MotivacraftTV step by step.

Step 1:

Open a browser page and visit motivacraft.tv address. When you first time come to this address you will see an explanatory screen with a registration code. Please write down this registration code and do not close this webpage or refresh the page. Leave it be for now.

Step 2:

On a different tab or on a different computer, log in to motivacraft.com and go to the admin page. Click the Motivacraft TV tab on the left menu and under it, please select the Monitors tab.

Step 3:

Click “New Monitor” ot the top right and fill the information required there. Enter the registration code you got from motivacraft.tv window here and click submit. 

Now you can go back to the motivacraft.tv tab and wait a couple of seconds. As you have no playlist yet, you’d be seeing the registration code screen disappears and an empty screen comes. That’s totally normal.

Step 4:

Now it is time to create our playlist. Please go to the Motivacraft TV > Playlists section on the left menu. Give a name and description to your playlist. At the bottom lies your timeline. You can add 

– General Leaderboard (based on XP)

– Custom Leaderboard(s) After selecting the custom leaderboard, you’ll see a dropdown at the bottom to choose which custom leaderboard you’d like to display. (Collected boxes or performance)

– Mission Leaderboard: You can choose to show leaderboard for any mission, using the dropdowsn at the bottom of the settings page.

– Mission Top 10: This is a wall of fame feature and will display the top 10 players in that mission.

– Competition Leaderboard:

– Competition Top 10

– Announcements: you can display any 1920X1080px JPEG as an announcement. Announcements are managed (uploaded, changed etc.) from a separate panel on the left menu. Any announcement you have uploaded to the system can be added to the playlist directly.

– Date and Time: Please do not forget to select the correct time zone for the display. By default the organization’s time zone will come preselected.

– Weather: Please write the city name at the bottom area. Majority of the world’s cities are already in the database but if the city is not found, please try to enter some other place close to you.

Please note that, using the up and down arrows at the bottom of the playlist partitions, you can set how long each partition will stay on screen. Leaderboards with more than 10 players listed will rotate the users every ten seconds. First 10 will be shown for 10 seconds, later 11-20 will be shown 10 seconds so forth. For instance if you have a list of 50 players, it is recommended to set the mission leaderboard partition time as 50 seconds. 

Step 5:

If you haven’t done it already, attach this playlist to the monitor you have previously created. And enjoy the screens reflecting the actions.

Announcements:

This is the place where you manage your announcements. When you create a new announcement, there are two options given at the bottom. If you choose to automatically add to all playlists, this announcement will be added to all of the playlists without any further steps. If you choose not to automatically add, then you can add this announcement to any playlist as a partition manually later. 

Receiving Guest Token

GET: /api/v{version}/Auth/{token}

Version: 1

Responses:

				
					200 SUCCESS
{
  "type": "string",
  "token": "string",
  "expireIn": 0,
  "role": 0
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			
  • An unauthenticated guest bearer token is returned.
  • In order to get a guest token, you can get the token information you need to specify in the root section from the institution settings section of your company’s admin panel.

Videos

How can I create a new video?

To create a new video, you must first click on the “Videos” tab on the left side of the admin panel. Before creating a video, you need to add a video category here. To do this, you must press the “+” button you will see on the screen. Here you can write the name of the video category and the order in which you want it to appear in the player panel. You should then return to the “Videos” menu again. You can see all the videos he created here. To add a new video, you must first select a category and then press the “New Video” button at the top right. This is the video creation section. First, you must write the video name and description. In the “Advanced Settings” section, you need to upload the video file and choose how long to give it to users. If you want, you can add a test at the end of this video. In the “Users & Awards” section, you must choose which users you will assign the video to and then choose the reward you will distribute. After pressing the “Submit” button, you can successfully create a new video. Congratulations!

How can I view users watching videos?

To view the list of users who read the videos you created, you must first click on the “Videos” tab on the right side of the admin panel. There is an “eye” icon to the right of the name of the relevant video in the list. When you click on this icon, you will be able to view the list of all users who read the video you assigned.

How do I disable or delete a created video?

To update the status of the video you created, you must click on the “Videos” tab on the right side of the admin panel. You can change the status of the video at any time by clicking the “Active”, “Passive” or “Archived” button in the “Status” section to the left of the name of the relevant video in the list. If you want to delete the video completely, all you have to do is click on the “trash” icon to the right of the video name and delete the video. Remember, deleted videos cannot be retrieved!

How can I edit a video I created?

To edit a video you have created, you must first click on the “Videos” tab on the left side of the admin panel. You will see the edit icon to the right of the name of the article you will edit in the video list. When you click on this icon, you will see the screen where you created the video. Here you can edit the video as you wish.

User Registration

POST: /api/v{version}/User

Version: 1

Request Body:

				
					{
  "companyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "userName": "string",
  "displayName": "string",
  "email": "string",
  "password": "string",
  "role": 1,
  "image": "string",
  "cultureInfo": "string",
  "tagIds": [
    0
  ],
  "firmId": "string",
  "userIds": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}
				
			

Responses:

				
					200 SUCCESS
{
  "success": true,
  "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			
  • If the user registration is successful, the user Id of the created user is returned.
  • Role types can be:
    ○ Manager = 1,
    ○ User = 2,
    ○ Group User = 3,
    ○ Integration User = 4,
    ○ Report User = 5
  • If a report is requested to be sent to the users’ e-mails, the e-mail information must be filled while creating the user.
  • Password field should be sent unencrypted.
  • The firmId field can be used to add the user’s unique Id in the client system. By using this firmId, data can be sent in data integrations.
  • The userIds field is only for role = 3 ie group users. The activities of the users whose IDs are given here are reflected to this user. This is the setup that should be used for group setups.
  • If the user registration is successful, the user Id of the created user is returned.
    ● Role types can be:
    ○ Manager = 1,
    ○ User = 2,
    ○ Group User = 3,
    ○ Integration User = 4,
    ○ Report User = 5
    ● If a report is requested to be sent to the users’ e-mails, the e-mail information must be filled while creating the user.
    ● Password field should be sent unencrypted.
    ● The firmId field can be used to add the user’s unique Id in the client system. By using this firmId, data can be sent in data integrations.
    ● The userIds field is only for role = 3 ie group users. The activities of the users whose IDs are given here are reflected to this user. This is the setup that should be used for group setups.
    ● tagIds contains the Ids that the user wants to have.
    ● CultureInfo:
       ○ en-TR
       ○ en-US
       It can take one of its values.

User Guide

Our User Guide is a comprehensive manual designed to provide you with step-by-step instructions and valuable tips to effectively utilize our product, guiding you every step of the way.

Getting Started

How do I login to the application?

To log in to the application, you can log in to our website by typing motivacraft.com in the address line of your internet browser on your desktop or laptop computer or iOS/Android tablets. Then, by clicking on the “Login” option at the top right of the main page, you will reach the page where you will enter your information. Here, you will first enter the username given to you by your game administrator or created by yourself, and then your password. After entering your information, you can log in to the application by clicking the “Log In” button. You can also select the language you want on this screen and access the links created for you to download our mobile application.

What information can I access in the profile section?

By clicking on the “My Profile” tab in the upper right corner of the screen, you can follow a general statistics of the activities you have done in Motivacraft, see the activities you have done, see the badges you have earned, and also find a section where you can make adjustments to your game. When you click on the My Profile tab, you will see four different sections on the left. In the “My Profile” section at the top, you will see the statistics of the activities you have done in the game (such as the tasks you have completed, the XP you have earned and the articles you have read). In the “My Activities” section, which is in the second place, you can see all the activities you have done in the past and are currently active. In the “My Badges” section in the third row, you will see the badges you have earned or can earn. In the “Edit” section at the bottom, you can change the language option, change your avatar and renew your password. Come on, keep raising your on-screen stats!

Can I change the language settings of the application?

Motivacraft has a flexible structure that is used in many countries globally and can be adapted to more than one language. If you want to change the language option in the game, you must first click on the “My Profile” tab in the upper right corner of the screen. Then, when you click on the “Edit” option on the left side of the screen, you will be able to see the active language option. Here you can choose one of the language options presented to you. We keep working to add more language options!

Account Management

I forgot my password. What should I do?

You may have lost your login information to the app. Don’t worry about it. First of all, you need to log in to the application at motivacraft.com. You will see the “forgot password” option on the login screen. When you click on this option, you must enter the e-mail address you created your account with. We will send a renewal link to this email address. When you click on this link, you can enter your new password on the page that appears. After creating your new password, you can go back to the login section and log in to the application.

How can I change my password?

You may want to change the password for reasons such as being more memorable and more secure. For this, you must first click on the “My Profile” option in the upper right corner of the game screen. In the window that opens, you must click on the “Edit” option from the options on the left. Here is a section where you can reset your password. To change your password, you must first enter your current password. You must then enter it twice to confirm the new password you want to use. That’s it! You have successfully changed your password. Now you can continue your game with pleasure!

How can I create a new avatar?

There are many different avatars you can use to create your player ID in Motivacraft. By creating these avatars, you and your teammates can shape your player identity as you wish. To create a new avatar, you must first click on the “My Profile” tab in the upper right corner of the screen. Then, when you click the “Edit” option on the left side of the screen, you will see the “Password reset” section. When you click on the avatar here, you will see all the avatars you can choose. Come on, choose one of these avatars and add a different look to your profile!

Features

How does the quest system work?

You can see your missions by pressing the “missions and competitions” icon in the upper left corner of the game screen. With the tasks created by your game manager, you will be able to view your goals easily and follow them instantly. You will also see the rankings of your teammates here and you will be in a pleasant competition with them. If you successfully complete the tasks assigned to you, you will be able to reach the rewards (eg moti, badge, etc.) determined by your game administrator. This way, you’ll improve your performance and get one step closer to being at the top of the leaderboard. Good games!

How does the competition system work?

Welcome to the competition system we’ve created to help you improve your performance! You can see completed or ongoing enjoyable competitions by pressing the “missions and competitions” icon in the upper left corner of the game screen. As in our example company, these competitions can be on more than one subject. Here is your aim; It will be to finish the competition you participated in with the best scores. As a result of the competitions, you will be able to reach the prizes determined by your game manager. So what are you waiting for? Come on, be a part of this race now and enjoy a pleasant competition with your friends!

How does the testing system work?

Motivacraft offers a pleasant environment where you can talk not only your business performance but also your wisdom. By pressing the “test” icon in the upper left corner of the game screen, you can see the currently active new or previously completed tests. You can expand your knowledge by completing the tests assigned to you by the game administrator. These tests can be on different topics such as general culture questions, product knowledge or company knowledge, as in our example company. In addition, you need to get a certain number of correct answers to successfully complete these tests. Don’t be sad if you can’t. You can continue solving until you successfully complete the tests. Come on, take your first quiz now and raise your knowledge level!

How does the quiz system work?

In Motivacraft, we have created a system where you can always keep your information fresh. If there is a quiz you can participate in by pressing the “quiz” icon in the upper left corner of the game screen, you can start answering the questions immediately. Remember, you can only solve quizzes only once, so your score matters! There can also be more than one quiz active at the same time. In this case, after you’ve finished answering the first one, you’ll need to come back to the Quiz page to view the next quiz. You will reinforce and repeat the knowledge you have learned by answering the questions created by your game manager. In this way, you will take your performance one step further with your ever-fresh range of knowledge! Let’s solve the first problem and test your knowledge!

What is Moti?

You win Moti after the enjoyable competitions you participate in and the missions you successfully complete in Motivacraft. You will use your Moti in the reward market to access rewards created by your game manager. To reach these rewards, you must accumulate Moti. You can see the Moti points you have in the upper right corner of the game screen. Come on, complete your missions and competitions at the top, collect Moti and get the prizes you want!

How to use the reward market?

We have created a reward market system where you can spend the Moti points you earn after completing your tasks in Motivacraft and having enjoyable competitions with your team. To reach the prize market, simply click on the gift icon in the upper right corner of the game screen. You can see how many Moti are required for each reward in the reward market created by your game manager. You can convert your accumulated Moti into rewards here and enjoy the reward. You will also find that there are some special rewards available in the reward market that you cannot purchase using Moti. To earn these rewards, you must complete a special mission or rank up in the competition. In the description section of the rewards, it will be written in detail what you need to do to win. Come on, big prizes are waiting for you!

How does the activity system work?

At Motivacraft, we attach great importance to data analysis to improve its performance. You can monitor the process of reaching your goals with the activities created by your game manager, or you can add data yourself by clicking the “+” icon at the bottom of the game screen. To add an activity, you must click on the “Add Activity” tab on the left. Then you have to choose the category of the activity to add and choose which activity to add here. Activities can be added numerically or textually. After adding an activity, you can browse your current and past activities from the “My Activities” tab on the left. Come on, add your completed activities to Motivacraft and get one step closer to your goals!

How does the badge system work?

You can access the badges you can earn after completing missions, competitions and tests from the “My Profile” tab. The colored badges represent the badges you have earned. The numbers written in the red area at the top left of the badges show how many of those badges they have won so far. Badges you haven’t earned yet are shown in gray/dim. If you want to get more detailed information about any badge, you can access the details page by clicking the badge. Here you can see detailed information about how you can earn the badge, as well as the dates you have already earned. Come on, now is the time to grow your badge collection!

How does the ranking system work?

One of the main purposes in Motivacraft is to continue the story on the main screen by gaining XP, that is, experience points, after activities such as tasks, competitions and tests you have completed. When you enter the “Ranking” tab in the upper right corner of the screen, you can see the experience points you have and the points of your teammates. You can also examine the competition in different subgroups by using the tabs (if any) in the ranking area. Come on now, increase your ranking by completing the events given to you and enjoy the sweet competition with your teammates!

How does the social networking system work?

Motivacraft is not only a working platform for you and your teammates, it also creates an environment where you can socialize. When you click on the “Social” tab in the upper right corner of the game screen, you will see the “Wall” and “Praise” sections. In the “Wall” section, you can see the posts shared by your teammates; You can interact with them by liking or commenting. You can also share a post using the area prepared for you to share. A little tip; You can click the “add photo” icon to add photos to your posts. (The photos you add should not be larger than 10 MB and should be in .jpg or .png format.) In the “Praise” section, you can praise your teammates for their work or achievements. To do this, you must first choose a compliment. Then you have to choose the person you want to send it to, and you can also send him a message if you want. In the “Praise Transaction History”, you can view the compliments you have sent and received. Come on, now enjoy chatting with your teammates by sharing a post on your wall!

How does the level system work?

To pass each level on the Motivacraft gamification platform, you need to reach a predetermined experience point (XP). You can earn XP points by completing tasks assigned to you, ranking in competitions, and participating in other activities (reading articles, watching videos, giving a certain number of correct answers in tests, etc.). You can follow your level progress from the level bar at the top of the game screen. Each time you level up, you’ll unlock a new spot on your game map, and you’ll be one step closer to completing the story. You can also see the levels you have completed by clicking the “i” button on the right side of the level bar. Come on now, get one step ahead of your friends by successfully completing the activities assigned to you and discover the next level!

How does the video system work?

We have created a video system to make it easier for you to learn in Motivacraft. By clicking the icon in the upper left corner of the game screen, you will reach the screen where you will see tests, quizzes, videos and articles. Here, when you click on the “video” tab on the left, you will be able to see the video content assigned by your game manager. You can access the video by selecting the content you want to watch. After completing your video, you can successfully complete the task by pressing the “Wached” button at the bottom. Come on, reinforce what you’ve learned by watching the videos assigned to you right now!

How does the article system work?

We have created an article system to make it easier for you to learn in Motivacraft. By clicking the icon in the upper left corner of the game screen, you will reach the screen where you will see tests, quizzes, videos and articles. Here, when you click on the “article” tab on the left, you will be able to see the articles assigned by your game administrator. You can reach the article by selecting the content you want to read. After you have finished reading the article, you can successfully complete the task by clicking the “I have read” button at the bottom. Come on, reinforce what you’ve learned by reading the articles assigned to you right now!

Mobile App

How can I download the iOS version of the app?

To access our mobile application that we have created so that you can easily access Motivacraft from anywhere, you can download it from the link you will reach by clicking the “Download from App Store” option on the home screen. You can also install the application that comes up by typing “Motivacraft” in the App Store and enjoy gamification anywhere!

How can I download the Android version of the application?

To access our mobile application that we have created so that you can easily access Motivacraft from anywhere, you can download it from the link you will reach by clicking the “Get from Google Play” option on the home screen. You can also install the application that comes up by typing “Motivacraft” on Google Play and enjoy gamification anywhere!

Motivacraft Mobile App Home Screen

What awaits you in the Motivacraft Mobile App home screen when you first login.

How can i see missions and competitions in mobile app?

How to get details for the missions and competitions you are attending to in the mobile app.

Motivacraft Mobile App Trainings

Learn more about Motivacraft Mobile App.

Motivacraft Mobile App Manual Data Entry

How to enter data manually using mobile app.

Motivacraft Mobile App Your Story

Learn more about your story in Motivacraft mobile app.

Motivacraft Mobile App My Profile

Learn more about your profile in Motivacraft Mobile App.

Motivacraft Mobile App Reward Market

Learn more about reward market in Motivacraft Mobile App.

Motivacraft Mobile App Settings

Learn more about settings in Motivacraft Mobile App.

I forgot my password. What should I do?

You may have lost your login information to the app. Don’t worry about it. First of all, you need to log in to the application at motivacraft.com. You will see the “forgot password” option on the login screen. When you click on this option, you must enter the e-mail address you created your account with. We will send a renewal link to this email address. When you click on this link, you can enter your new password on the page that appears. After creating your new password, you can go back to the login section and log in to the application.

How do I login to the application?

To log in to the application, you can log in to our website by typing motivacraft.com in the address line of your internet browser on your desktop or laptop computer or iOS/Android tablets. Then, by clicking on the “Login” option at the top right of the main page, you will reach the page where you will enter your information. Here, you will first enter the username given to you by your game administrator or created by yourself, and then your password. After entering your information, you can log in to the application by clicking the “Log In” button. You can also select the language you want on this screen and access the links created for you to download our mobile application.

How does the quest system work?

You can see your missions by pressing the “missions and competitions” icon in the upper left corner of the game screen. With the tasks created by your game manager, you will be able to view your goals easily and follow them instantly. You will also see the rankings of your teammates here and you will be in a pleasant competition with them. If you successfully complete the tasks assigned to you, you will be able to reach the rewards (eg moti, badge, etc.) determined by your game administrator. This way, you’ll improve your performance and get one step closer to being at the top of the leaderboard. Good games!

User Activity Log

POST: api/v{version}/User/metric 

Version: 1

Request Body:

				
					{
  "metricId": 0,
  "articleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "questionId": 0,
  "parameters": [
    {
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    }
  ],
  "firmId": "string",
  "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "eventCreatedDate": "2023-07-26T19:36:43.092Z",
  "customerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "isRollback": true,
  "transactionId": "string"
}
				
			

Responses:

				
					200 SUCCESS
{
  "success": true,
  "hasQuestion": true,
  "questionId": 0
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			

An example activity log pattern is as follows:

				
					{
    "metricId: {AKTIVITE ID},
    "parameters": [
        {
            "{PROPERTY ID}": "{GERCEKLESEN}",
            "{2.PROPERTY ID}": "{2.GERCEKLESEN}"
        }
       ]
       "firmId": "{KULLANICI ID}"
}
				
			
  • The areas mentioned in curly brackets here are:
    – Activity ID: You can change this part by using the Activity ID corresponding to the activity.
    – Property ID: It is changed with the “property” of the data that may occur depending on that activity.
    – Actual: The data information that took place in the relevant “property” of the activity to be sent is given here.
    – There is no need to give string values such as TL and PCS next to them.
    – Numeric properties can be sent as rational numbers.
    – If a numeric Property has textual data, it will give an error. Only numbers should be sent.
    – User ID: The unique ID of the user whose data will be sent must be sent in the customer system.

Disabling the User

PUT: /api/v{version}/User/{id}/make-passive

Version: 1

Responses:

				
					200 SUCCESS
{
  "success": true
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			

How can I download the Android version of the application?

To access our mobile application that we have created so that you can easily access Motivacraft from anywhere, you can download it from the link you will reach by clicking the “Get from Google Play” option on the home screen. You can also install the application that comes up by typing “Motivacraft” on Google Play and enjoy gamification anywhere!

How can I change my password?

You may want to change the password for reasons such as being more memorable and more secure. For this, you must first click on the “My Profile” option in the upper right corner of the game screen. In the window that opens, you must click on the “Edit” option from the options on the left. Here is a section where you can reset your password. To change your password, you must first enter your current password. You must then enter it twice to confirm the new password you want to use. That’s it! You have successfully changed your password. Now you can continue your game with pleasure!

How can I view users watching videos?

To view the list of users who read the videos you created, you must first click on the “Videos” tab on the right side of the admin panel. There is an “eye” icon to the right of the name of the relevant video in the list. When you click on this icon, you will be able to view the list of all users who read the video you assigned.

Tests and Quizzes

How can I create a new test or quiz?

To create a new test, you must first click on the “Tests” tab on the left side of the admin panel. Here you can see all the tests you have created. To add a new test, you must press the “New Test” button at the top right. This is the test creation section. First, you need to choose the test name and type, then determine the start and end dates. You can also determine at what time it will start and end in the box where you see the dates. If you do not set a custom time, the system time will be used by default. Finally, on this page, you should write the description of the test. In the “Advanced Settings” section, you need to select the group you want to define this test for, how many questions will be per test and how long you will give it. Here you can choose to automatically check for true and false. If you want, you can add a test at the end of this video. In the “Schedule & Difficulties” section, you can customize which days and between which times the test will be published. You can also assign tests randomly by determining the difficulty level of the questions. Finally, you can successfully create a new test by clicking the “Create” button. Congratulations!

How can I add a new question?

After you successfully create a new test, you should prepare the questions that will fill that test. To do this, you must first click on the “Tests” tab on the left side of the administration panel. Here you will see the list of tests you have created. You should click on the “question mark” icon on the right side of the test to which you want to add a question. By pressing this button, you can see all the questions you have prepared for the relevant test. For a new question, you should press the “Edit questions” button at the top right. Here you will see all the questions you created for that test. You can add a new question by pressing the “Add question” button. First you need to choose whether the question is text or option. Then you need to determine the priority order and difficulty level. After writing the question in the Question section, you need to add the answers to the “Options” section. Don’t forget to tick the option with the correct answer here. Finally, you can create the question by pressing the “create” button. Congratulations!

How can I edit a test I created?

To edit a test you have created, you must first click on the “Tests” tab on the left side of the admin panel. You will see the edit icon to the right of the name of the test you will edit in the test list. When you click on this icon, you will see the test creation screen. Here you can edit the test as you wish.

How competitions based on test results work?

This provides clarity on how our platform conducts competitions based on test and quiz results. Understanding the mechanisms of these competitions will enhance your strategy and performance.
Core Principles
Competitions are centered on the correct answers provided within the competition’s timeframe. However, the calculation of scores differs between tests and quizzes to accurately capture the essence of each type, as well as their contribution to overall competition results.
Tests: Continuous Improvement
Multiple Attempts Allowed: Participants can take the same test multiple times during the competition.
Score Calculation: The highest number of correct answers from all attempts by each user is recorded. This reflects the best individual effort and learning progression.
Purpose: Designed to support iterative learning and mastery, encouraging users to build upon previous knowledge and skills.
Quizzes: Comprehensive Understanding
Cumulative Performance: Quizzes can only be repeated on different days, therefore the competition considers the total number of correct answers from all attempts.
Score Calculation: Every correct answer from each attempt is added to create a cumulative score that contributes to the competition outcome.
Purpose: Aims to measure overall knowledge breadth and consistent performance across attempts.
Combined Competitions
In competitions that incorporate both tests and quizzes:
Tests’ Contribution: Only the maximum correct answers from one test attempt are considered.
Quizzes’ Contribution: The total correct answers from all quiz attempts are summed up.
Objective: This blended approach ensures fairness by capturing the strengths of both formats—rewarding deep learning and consistent performance.
Why This Approach?
Tests’ Specialty: Reflects growth and peak achievement through multiple trials.
Quizzes’ Specialty: Captures comprehensive and reliable knowledge representation.
With these scoring methodologies, our platform offers a balanced and fair competition structure, highlighting different skills and learning styles.

How do I edit a question I created?

To edit a question you have created, you must first click on the “Tests” tab on the left side of the admin panel. Here you will see the list of tests you have created. You should click on the “question mark” icon on the right side of the test to which you want to add a question. By pressing this button, you can see all the questions you have prepared for the relevant test. To edit the question, you must press the “Edit questions” button at the top right. Here you can see and edit all the questions you created for that quiz.

How can I view users test results?

To view the list of users who completed the test you created, you must first click on the “Tests” tab on the right side of the admin panel. There is a “show results” icon to the right of the name of the relevant test in the list. When you click on this icon, you will be able to view the list of all users who have completed the test you assigned.

How do I disable or delete a created test?

In order to update the status of the test you created, you must click on the “Tests” tab on the right side of the admin panel. You can change the status of the test at any time by clicking the “Active”, “Passive” or “Archived” button in the “Status” section to the left of the name of the relevant test in the list.

Company Activities

GET: /api/v{version}/Metric/all

Version: 1

Responses:

				
					200 SUCCESS
{
  "metrics": [
    {
      "id": 0,
      "metricCategoryId": 0,
      "name": "string",
      "isActive": true,
      "defaultXp": 0,
      "type": 1,
      "defaultUnit": 0,
      "hasDescription": true,
      "code": "string",
      "defaultPoint": 0,
      "defaultXpCoefficient": 0,
      "isManual": true
    }
  ]
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			

The metrics defined for the company are returned.

User Login

POST: /api/v{version}/Auth/login

Version:

Request Body:

				
					
  "userName": "string",
  "password": "string",
  "companyId": "string"
}
				
			

Responses:

				
					200 SUCCESS
{
  "type": "string",
  "token": "string",
  "expireIn": 0,
  "role": 0
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			
  • If this request is successful, using the guest bearer token from the previous End-Point, an authenticated bearer token is returned.
  • In addition, role information is returned as 1 if the user is admin and as 2 if the user is an unauthorized user.

Game Master Guide

The Game Master Guide is an essential companion for all aspiring game masters, packed with invaluable tools, tips, and resources to help you create immersive and unforgettable tabletop adventures.

Reporting

How can I report the activities done within the application?

In these days when the importance of data increases, we attach great importance to the reporting system at Motivacraft. To easily access the reports, you must first click on the “Reports” tab on the left side of the administration panel. Here you can report users’ logins to the application, earned xp, level and motives, badges, completed tasks, tests and activities. You can also customize these reports by selecting the date ranges you want to receive. Then, by clicking the “Export” button, you can download the reports you selected as Excel files and increase in-application efficiency with these reports.

Videos

How can I create a new video?

To create a new video, you must first click on the “Videos” tab on the left side of the admin panel. Before creating a video, you need to add a video category here. To do this, you must press the “+” button you will see on the screen. Here you can write the name of the video category and the order in which you want it to appear in the player panel. You should then return to the “Videos” menu again. You can see all the videos he created here. To add a new video, you must first select a category and then press the “New Video” button at the top right. This is the video creation section. First, you must write the video name and description. In the “Advanced Settings” section, you need to upload the video file and choose how long to give it to users. If you want, you can add a test at the end of this video. In the “Users & Awards” section, you must choose which users you will assign the video to and then choose the reward you will distribute. After pressing the “Submit” button, you can successfully create a new video. Congratulations!

How can I view users watching videos?

To view the list of users who read the videos you created, you must first click on the “Videos” tab on the right side of the admin panel. There is an “eye” icon to the right of the name of the relevant video in the list. When you click on this icon, you will be able to view the list of all users who read the video you assigned.

How do I disable or delete a created video?

To update the status of the video you created, you must click on the “Videos” tab on the right side of the admin panel. You can change the status of the video at any time by clicking the “Active”, “Passive” or “Archived” button in the “Status” section to the left of the name of the relevant video in the list. If you want to delete the video completely, all you have to do is click on the “trash” icon to the right of the video name and delete the video. Remember, deleted videos cannot be retrieved!

How can I edit a video I created?

To edit a video you have created, you must first click on the “Videos” tab on the left side of the admin panel. You will see the edit icon to the right of the name of the article you will edit in the video list. When you click on this icon, you will see the screen where you created the video. Here you can edit the video as you wish.

Tests and Quizzes

How can I create a new test or quiz?

To create a new test, you must first click on the “Tests” tab on the left side of the admin panel. Here you can see all the tests you have created. To add a new test, you must press the “New Test” button at the top right. This is the test creation section. First, you need to choose the test name and type, then determine the start and end dates. You can also determine at what time it will start and end in the box where you see the dates. If you do not set a custom time, the system time will be used by default. Finally, on this page, you should write the description of the test. In the “Advanced Settings” section, you need to select the group you want to define this test for, how many questions will be per test and how long you will give it. Here you can choose to automatically check for true and false. If you want, you can add a test at the end of this video. In the “Schedule & Difficulties” section, you can customize which days and between which times the test will be published. You can also assign tests randomly by determining the difficulty level of the questions. Finally, you can successfully create a new test by clicking the “Create” button. Congratulations!

How can I add a new question?

After you successfully create a new test, you should prepare the questions that will fill that test. To do this, you must first click on the “Tests” tab on the left side of the administration panel. Here you will see the list of tests you have created. You should click on the “question mark” icon on the right side of the test to which you want to add a question. By pressing this button, you can see all the questions you have prepared for the relevant test. For a new question, you should press the “Edit questions” button at the top right. Here you will see all the questions you created for that test. You can add a new question by pressing the “Add question” button. First you need to choose whether the question is text or option. Then you need to determine the priority order and difficulty level. After writing the question in the Question section, you need to add the answers to the “Options” section. Don’t forget to tick the option with the correct answer here. Finally, you can create the question by pressing the “create” button. Congratulations!

How can I edit a test I created?

To edit a test you have created, you must first click on the “Tests” tab on the left side of the admin panel. You will see the edit icon to the right of the name of the test you will edit in the test list. When you click on this icon, you will see the test creation screen. Here you can edit the test as you wish.

How competitions based on test results work?

This provides clarity on how our platform conducts competitions based on test and quiz results. Understanding the mechanisms of these competitions will enhance your strategy and performance.
Core Principles
Competitions are centered on the correct answers provided within the competition’s timeframe. However, the calculation of scores differs between tests and quizzes to accurately capture the essence of each type, as well as their contribution to overall competition results.
Tests: Continuous Improvement
Multiple Attempts Allowed: Participants can take the same test multiple times during the competition.
Score Calculation: The highest number of correct answers from all attempts by each user is recorded. This reflects the best individual effort and learning progression.
Purpose: Designed to support iterative learning and mastery, encouraging users to build upon previous knowledge and skills.
Quizzes: Comprehensive Understanding
Cumulative Performance: Quizzes can only be repeated on different days, therefore the competition considers the total number of correct answers from all attempts.
Score Calculation: Every correct answer from each attempt is added to create a cumulative score that contributes to the competition outcome.
Purpose: Aims to measure overall knowledge breadth and consistent performance across attempts.
Combined Competitions
In competitions that incorporate both tests and quizzes:
Tests’ Contribution: Only the maximum correct answers from one test attempt are considered.
Quizzes’ Contribution: The total correct answers from all quiz attempts are summed up.
Objective: This blended approach ensures fairness by capturing the strengths of both formats—rewarding deep learning and consistent performance.
Why This Approach?
Tests’ Specialty: Reflects growth and peak achievement through multiple trials.
Quizzes’ Specialty: Captures comprehensive and reliable knowledge representation.
With these scoring methodologies, our platform offers a balanced and fair competition structure, highlighting different skills and learning styles.

How do I edit a question I created?

To edit a question you have created, you must first click on the “Tests” tab on the left side of the admin panel. Here you will see the list of tests you have created. You should click on the “question mark” icon on the right side of the test to which you want to add a question. By pressing this button, you can see all the questions you have prepared for the relevant test. To edit the question, you must press the “Edit questions” button at the top right. Here you can see and edit all the questions you created for that quiz.

How can I view users test results?

To view the list of users who completed the test you created, you must first click on the “Tests” tab on the right side of the admin panel. There is a “show results” icon to the right of the name of the relevant test in the list. When you click on this icon, you will be able to view the list of all users who have completed the test you assigned.

How do I disable or delete a created test?

In order to update the status of the test you created, you must click on the “Tests” tab on the right side of the admin panel. You can change the status of the test at any time by clicking the “Active”, “Passive” or “Archived” button in the “Status” section to the left of the name of the relevant test in the list.

Labels

What is the tag system?

The tag system is a system created to allow you to easily group users in the game. Here you can group users using the application according to their specific characteristics, as in the example company. You can increase efficiency within the application by creating special activities for these groups. For example, in this company, users are grouped according to the cities they live in, their experiences and the regions they belong to, and labels are created accordingly. In this way, the company aims to increase the productivity of an inexperienced employee by creating a special activity for the city or inexperienced employee he sees as lacking.

How can I create a new tag for users?

To create a new tag, you must first click on the “Tags” tab on the left side of the admin panel. Before creating a new tag, you need to add a tag category here. To do this, you must press the “+” button you will see on the screen. Here, you can create the category by typing the name of the tag category and pressing the “save” button. Then, you should go back to the “Tags” menu and select the category in which you will create the tag. To add a new tag, you must press the “New tag” button at the top right. This is the tag creation page. First you need to enter the name of your tag. You will then determine the users you will include in this tag. After completing all these steps, you should press the save button. Congratulations, you’ve successfully created the tag!

Badges

How can I create a new badge?

To create a new badge, you must first click on the “Badges” tab on the left side of the admin panel. Before creating a new badge, you need to create a badge category here. To do this, you must press the “+” button you will see on the screen. Here you can set the order in which the tag category will appear after typing its name. Additionally, if you want to customize the badge for a specific group, you can select that group from the labels section. After completing these procedures

How can I edit the badges I've created?

To edit a badge you created, you must first click on the “Badges” tab on the left side of the admin panel. In the badge list, you will see the edit icon to the right of the name of the badge you will edit. When you click on this icon, you will see the screen where you created the badge. Here you can edit the badge as you wish.

How can I view badge winners?

To view the users who have earned the badges you created, you must first click on the “Badges” tab on the right side of the admin panel. Here, there is a “Badge Winners” icon to the right of the name of the badge. When you click on this option, you will be able to view the ranking of users who earned the badge you created. You can also download this data to your computer as an Excel file by clicking the “Export” button above.

Awards

What is the reward system?

At Motivacraft, we have created a reward system to help users improve their performance. Users earn Moti points as a reward after completing actions such as tasks, competitions or articles. Then, by accumulating these Moti points they earn, they receive a reward from the reward market you created. These rewards aim to increase users’ motivation. Now you can help users embellish their enjoyable competitions with rewards by creating a reward market.

How can I create my reward market?

To create a reward market, you must first click on the “Rewards” tab on the left side of the admin panel. Before creating a new reward, you need to add a reward category here. To do this, you must press the “+” button you will see on the screen. Here you need to specify the name of the award category. Then, you should go back to the “Awards” menu and select the category of the reward you will create. To create a new award, you must press the “New award” button at the top right. This is the reward creation page. Here, after determining the name, description and image of the award, you must determine how many Moti points it is worth and the number of stocks. Finally, there are two different types of challenges here. These can be “taken” and “earned”. The “purchasable” ones can be owned for a certain Moti point. “Earnable” ones are rewards earned as a result of activities such as any task, article or test. After entering the reward information, you must press the “save” button. Congratulations, you have successfully created the bounty!

Levels

How can I create a new level?

To create a new level, you must first click on the “Levels” tab on the left side of the administration panel. Here you can see and manage the list of levels you have created. To add a new level, you must press the “New level” button at the top right. This is the level creation screen. First you need to determine which level you are doing. Afterwards, you must determine in which XP ranges this level will be in the minimum and maximum XP sections. In the “Background Image” section, you should upload the game image that users will see throughout that level. In the starting text section, you can add the welcome text and image that the player will see when they reach the level you created. You can also indicate that you have completed the level by adding an end image and text. Finally, you can optionally set a reward or badge that the player can earn if they beat the level. After filling in the information on the page, you should press the “save” button. Congratulations, you have successfully created the level!

How do I edit or delete the levels I've created?

In order to view the levels you have created, you must first click on the “Levels” tab on the left side of the administration panel. Here you can see and manage the list of levels you have created. To delete a created level, just press the “trash can” icon on the right. Remember, deleted levels cannot be restored! If you want to edit the level, you will reach the level creation screen by pressing the blue edit icon on the right side of the relevant level in the “Levels” list. Here you can edit the levels you create as you wish.

Dynamic Goals

How can I add a new dynamic target?

To create a new dynamic target, you must first click on the “Dynamic Targets” tab on the left side of the admin panel. Here you can see the dynamic targets you have created. To add a new dynamic target, you must press the “New target” button at the top right. This is the dynamic goal creation page. You can edit your dynamic target using the visual or JSON editor. We will use the visual editor in the training. First you need to determine a name for the dynamic target and how much the target will be. After determining these, you can use a visual that defines this goal if you wish. If you want to personalize the goal you have given, you should select the user by pressing the “Add User” button and determine how much your new goal will be. You can personalize this for as many users as you want. If you do not want to personalize, you can easily remove the users you added and create the general target for everyone. After entering the information about the dynamic target, you should press the “save” button. Congratulations, you have successfully created the dynamic target!

What is a dynamic target system?

At Motivacraft, we added a dynamic goal system to encourage users to further improve their performance. With this system, you can create dynamic goals for users and personalize these goals for each user. To reinforce the point, let’s look at the dynamic goals of our example company. This company of ours has determined its monthly sales target as a dynamic target. When we examine the dynamic target they created in detail, all users were given a monthly target of 10000 dollars. We can also see in the “Goals” section that several users have personalized goals. In this way, the company may have given such a goal to users who already have a successful performance graph, to take their performance one step further. So what will you do? Come on, assign the most appropriate goals to your team and watch their development!

Activities

How can I create a new activity?

To create a new activity, you must first click on the “Activities” tab on the left side of the admin panel. Before creating a new activity, you need to add an activity category here. To do this, you must press the “+” button you will see on the screen. Here you should write the name of the activity category and the feature of the activity. Then, you should go back to the “Activities” menu, select the category of the activity you will create and press the “New activity” button at the top. This is the activity creation page. First, you must enter the activity name. You can check the box to allow the user to manually add activities. Optionally, you can assign the activity you created to specific users with the tag system. Finally, after determining the XP and Moti that the user will earn, you should press the “save” button! Congratulations, you have successfully created the activity!

How can I edit or delete activities that I have created?

To change the status of an activity you created, you must first click on the “Activities” tab on the left side of the admin panel. Here you can see all the activities you have created. To delete a created activity, simply press the “delete” icon on the right. You can also make the activity invisible by pressing the “disable” button. If you want to edit the activity, you will reach the activity creation screen by pressing the blue edit icon on the right side of the relevant level in the “Activities” list. You can edit the activities you create here as you wish.

Organization Settings

How do I update the logo that appears in-game?

To update the logo that appears in the game, you must first click on the “Organization Settings” tab on the left side of the admin panel. Here you will see active company information. When you press the blue edit icon to the right of the company name you want to edit, you will reach the organization editing page. You can update the in-game logo as you wish from the “gamification logo” section here.

How do I update my organization information?

To update organization information, you must first click on the “Organization Settings” tab on the left side of the admin panel. Here you will see active company information. When you press the blue edit icon on the right side of the company name you want to update, you will reach the organization editing page. On this page, you can change the name of the organization you created, add an announcement, edit the logo and make arrangements for the leaderboard.

How can I list the experience point ranking on a monthly basis?

If you wish, you can list the experience point ranking displayed in the game for all time or monthly. To select this, you must first click on the “Organization Settings” tab on the left side of the administration panel. Here you will see active company information. When you press the blue edit icon on the right side of the company name you want to update, you will reach the organization editing page. Under the “Leaderboard Privacy Settings” section on this page, click “Leaderboard reflects only current month” When you select the mark, the ranking will be listed monthly. When you uncheck it, you will be listing for all times. You can make changes to the listing on this page whenever you want.

Missions

How can I create a new missions?

To create a new task, you must first click on the “Tasks” tab on the left side of the admin panel. Before creating a task, you need to add a task category here. To do this, you must press the “+” button you will see on the screen. Here you can write the name of the mission category and the order in which you want it to appear in the player panel. Then you have to return to the “missions” menu again. After selecting a category here, you must press the “New Mission” button at the top right to add a new mission. This is the task creation section. First of all, you need to determine the task name, the order in which this task will appear, and the start and finish dates. You can also determine at what time it will start and end in the box where you see the dates. If you do not set a custom time, the system time will be used by default. After completing these, you should write your job description in the description section. After writing the task description, you can click the “Next” button and choose which users to assign the task to. Afterwards, you can determine the metrics of the task in the “Rule Sets” section. In the “Actions” section, you can determine the rewards you will assign to the players as a result of the mission. In the “Schedule” section, you can give a command to renew the task daily or weekly. In the “Miscellaneous” section, you can also select the final details about the mission. Here you can delete xp or moti for users who cannot complete the task in the “leaderboard” settings and “penalties” sections. Finally, you can create the task by pressing the “Submit” button. Congratulations!

How can I edit a mission I created?

Is there something missing in the task you created? Or do you want to update your rewards? You can make any arrangements regarding your duties. To do this, you must first click on the “Tasks” tab on the left side of the admin panel. You will see the edit icon to the right of the name of the task you will edit in the task list. When you click on this icon, you will see the screen where you created the task. Here you can organize your tasks as you wish.

How can I see who has completed missions?

To view the users who have completed the tasks you created, you must first click on the “Tasks” tab on the right side of the admin panel. There is an “completed by” icon to the right of the name of the relevant task in the list where you can list those who have completed the task. When you click on this icon, you will be able to view all users who have completed the task you gave.

How can I see the mission achievement ranking?

To view the success ranking of users who have completed the tasks you have created, you must first click on the “Tasks” tab on the right side of the admin panel. There is a “leaderboard” icon to the right of the name of the relevant task in the list. When you click on this icon, you will be able to view the success ranking of all users who have completed the task you have given.

How do I disable or delete a created mission?

You can change the status of the task at any time by clicking the “Active”, “Passive” or “Archived” button in the “Status” section to the left of the name of the relevant task in the list. If you want to delete the task completely, all you have to do is click on the “trash” icon to the right of the task name and delete the task. Remember, deleted tasks cannot be undone!

Competitions

How can I create a new competition?

To create a new competition, you must first click on the “Competitions” tab on the left side of the admin panel. Before creating a competition, you need to add a competitions category here. To do this, you must press the “+” button you will see on the screen. Here you can write the name of the competitions category and the order in which you want it to appear in the player panel. Then you should return to the “Competitions” menu again. You can see all the competitions he created here. To add a new competition, you must press the “New competition” button at the top right. This is the competitions creation section. First of all, you need to determine the name of the competition, the order in which this competition will appear and the start and end dates. You can also determine at what time it will start and end in the box where you see the dates. If you do not set a custom time, the system time will be used by default. Once you’ve completed these, you must upload an image for the contest. After uploading the contest image, you will click on the “Next” button and you will be taken to the “Advanced Settings” section where you will determine the details of the contest. Here you must first select the competition type. Next, you should determine the visibility of this contest and details such as which users will participate in the contest. In the “Awards” section, you can determine the awards you will assign to the players as a result of the competition. You can personalize the rewards as you wish. In addition, when players click on the option to automatically distribute the reward, the system will automatically distribute the rewards as soon as the competition is completed. Congratulations, you have successfully created a new contest!

How do I edit a competition I created?

To organize a competition you have created, you must first click on the “Competitions” tab on the left side of the admin panel. In the Competitions list, you will see the edit icon to the right of the name of the competition you will organize. When you click on this icon, you will see the screen where you created the contest. Here you can organize the competitions as you wish.

How can I see the ranking of competing users?

To view the success ranking of users who have completed the competitions you have created, you must first click on the “Competitions” tab on the right side of the admin panel. There is a “leaderboard” icon to the right of the name of the relevant competition in the list. When you click on this icon, you will be able to view the success ranking of all users who completed your competition.

How do I disable or delete a created competition?

In order to update the status of the competition you created, you must click on the “Contests” tab on the right side of the admin panel. You can change the status of the competition at any time by clicking the “Active”, “Passive” or “Archived” button in the “Status” section to the left of the name of the relevant competition in the list. If you want to delete the contest completely, all you have to do is click on the “trash can” icon to the right of the contest name and delete the contest. Remember, deleted contests cannot be retrieved!

Users

How can I create a new user?

There are three different ways to add users in Motivacraft. You can create a user manually, by using an invitation link or by sending an invitation. To add a new user, you must click on the “Users” tab on the left side of the administration panel. Here you can see all the users in the application and download the list of users as an Excel file by pressing the “Export” button. To add a user manually, you must press the “New user” button at the top right. This is the user creation screen. Here, after entering the user’s name, surname and e-mail address, you will create a username and password to use as login information. You can then assign a role to that user, connect them to one of your teammates, or add a tag to include them in any group you’ve created. You can also enter date of hire and date of resignation information here. After entering your Registration ID, you will complete the information. Finally, you can successfully create the new user by pressing the “save” button. As a second method, you can copy the invitation link in the upper right corner of the “Users” tab, send it to the person you want to invite, and help them register for the application. As the last method, you should press the “Send Invitation” button in the upper right corner of the “Users” tab. On the screen that appears, you must write the name, surname and e-mail address of the user you will invite. The user can register for the application from the link sent to his e-mail address. Congratulations, you have successfully created the new user!

How do I deactivate or delete a user?

In order to update the status of the user you created, you must click on the “Users” tab on the right side of the admin panel. Here you will see the list of all users. First of all, to change the user’s status, you must press the “dot” icon on the left side of the username. When you select the “active” option here, the icon will be green and the user will be included in the application. In the “Passive” state, the user will not be able to log in to the application and it will be disabled and the color of the icon will be red. If you want to delete the user completely, all you have to do is click on the “trash can” icon to the right of the username and delete the user. Remember, deleted users cannot be retrieved!

Can I change the information of an active user?

To edit a user you created, you must first click on the “Users” tab on the left side of the admin panel. Here you will see the list of users you created. In the user list, you will see the edit icon to the right of the name of the user you will edit. When you click on this icon, you will see the screen where you created a user manually. Here you can organize users as you wish.

Articles

How can I create a new article?

To create a new article, you must first click on the “Articles” tab on the left side of the admin panel. Before creating an article, you need to add an article category here. To do this, you must press the “+” button you will see on the screen. Here you can write the name of the article category and the order in which you want it to appear in the player panel. Then you should return to the “Articles” menu again. You can see all the articles he has created here. To add a new article, you must first select a category and then press the “New Article” button at the top right. This is the article creation section. First, you must write the article name and description. In the “Advanced Settings” section, you need to upload the article file and choose how long to give it to users. If you want, you can add a test at the end of this article. In the “Users & Awards” section, you must choose which users you will assign the article to and then choose the reward you will distribute. After pressing the “Submit” button, you can successfully create a new article. Congratulations!

How can I edit an article I created?

To organize a contest you have created, you must first click on the “Articles” tab on the left side of the admin panel. In the article list, you will see the edit icon to the right of the name of the article you will edit. When you click on this icon, you will see the screen where you created the article. Here you can edit the article as you wish.

How can I see users who have read the article?

To view the list of users who read the articles you created, you must first click on the “Articles” tab on the right side of the admin panel. There is an “eye” icon to the right of the name of the relevant article in the list. When you click on this icon, you will be able to view the list of all users who read the article you assigned.

How do I disable or delete a created article?

In order to update the status of the article you created, you must click on the “Articles” tab on the right side of the admin panel. You can change the status of the article at any time by clicking the “Active”, “Passive” or “Archived” button in the “Status” section to the left of the name of the relevant article in the list. If you want to delete the article completely, all you have to do is click on the “trash can” icon to the right of the article name and delete the article. Remember, deleted articles cannot be retrieved!

MotivacraftTV

How can I use MotivacraftTV?

We will show you how to use MotivacraftTV step by step.We will show you how to use MotivacraftTV step by step.

Step 1:

Open a browser page and visit motivacraft.tv address. When you first time come to this address you will see an explanatory screen with a registration code. Please write down this registration code and do not close this webpage or refresh the page. Leave it be for now.

Step 2:

On a different tab or on a different computer, log in to motivacraft.com and go to the admin page. Click the Motivacraft TV tab on the left menu and under it, please select the Monitors tab.

Step 3:

Click “New Monitor” ot the top right and fill the information required there. Enter the registration code you got from motivacraft.tv window here and click submit. 

Now you can go back to the motivacraft.tv tab and wait a couple of seconds. As you have no playlist yet, you’d be seeing the registration code screen disappears and an empty screen comes. That’s totally normal.

Step 4:

Now it is time to create our playlist. Please go to the Motivacraft TV > Playlists section on the left menu. Give a name and description to your playlist. At the bottom lies your timeline. You can add 

– General Leaderboard (based on XP)

– Custom Leaderboard(s) After selecting the custom leaderboard, you’ll see a dropdown at the bottom to choose which custom leaderboard you’d like to display. (Collected boxes or performance)

– Mission Leaderboard: You can choose to show leaderboard for any mission, using the dropdowsn at the bottom of the settings page.

– Mission Top 10: This is a wall of fame feature and will display the top 10 players in that mission.

– Competition Leaderboard:

– Competition Top 10

– Announcements: you can display any 1920X1080px JPEG as an announcement. Announcements are managed (uploaded, changed etc.) from a separate panel on the left menu. Any announcement you have uploaded to the system can be added to the playlist directly.

– Date and Time: Please do not forget to select the correct time zone for the display. By default the organization’s time zone will come preselected.

– Weather: Please write the city name at the bottom area. Majority of the world’s cities are already in the database but if the city is not found, please try to enter some other place close to you.

Please note that, using the up and down arrows at the bottom of the playlist partitions, you can set how long each partition will stay on screen. Leaderboards with more than 10 players listed will rotate the users every ten seconds. First 10 will be shown for 10 seconds, later 11-20 will be shown 10 seconds so forth. For instance if you have a list of 50 players, it is recommended to set the mission leaderboard partition time as 50 seconds. 

Step 5:

If you haven’t done it already, attach this playlist to the monitor you have previously created. And enjoy the screens reflecting the actions.

Announcements:

This is the place where you manage your announcements. When you create a new announcement, there are two options given at the bottom. If you choose to automatically add to all playlists, this announcement will be added to all of the playlists without any further steps. If you choose not to automatically add, then you can add this announcement to any playlist as a partition manually later. 

What information can I access in the profile section?

By clicking on the “My Profile” tab in the upper right corner of the screen, you can follow a general statistics of the activities you have done in Motivacraft, see the activities you have done, see the badges you have earned, and also find a section where you can make adjustments to your game. When you click on the My Profile tab, you will see four different sections on the left. In the “My Profile” section at the top, you will see the statistics of the activities you have done in the game (such as the tasks you have completed, the XP you have earned and the articles you have read). In the “My Activities” section, which is in the second place, you can see all the activities you have done in the past and are currently active. In the “My Badges” section in the third row, you will see the badges you have earned or can earn. In the “Edit” section at the bottom, you can change the language option, change your avatar and renew your password. Come on, keep raising your on-screen stats!

Account Management

I forgot my password. What should I do?

You may have lost your login information to the app. Don’t worry about it. First of all, you need to log in to the application at motivacraft.com. You will see the “forgot password” option on the login screen. When you click on this option, you must enter the e-mail address you created your account with. We will send a renewal link to this email address. When you click on this link, you can enter your new password on the page that appears. After creating your new password, you can go back to the login section and log in to the application.

How can I change my password?

You may want to change the password for reasons such as being more memorable and more secure. For this, you must first click on the “My Profile” option in the upper right corner of the game screen. In the window that opens, you must click on the “Edit” option from the options on the left. Here is a section where you can reset your password. To change your password, you must first enter your current password. You must then enter it twice to confirm the new password you want to use. That’s it! You have successfully changed your password. Now you can continue your game with pleasure!

How can I create a new avatar?

There are many different avatars you can use to create your player ID in Motivacraft. By creating these avatars, you and your teammates can shape your player identity as you wish. To create a new avatar, you must first click on the “My Profile” tab in the upper right corner of the screen. Then, when you click the “Edit” option on the left side of the screen, you will see the “Password reset” section. When you click on the avatar here, you will see all the avatars you can choose. Come on, choose one of these avatars and add a different look to your profile!

How does the competition system work?

Welcome to the competition system we’ve created to help you improve your performance! You can see completed or ongoing enjoyable competitions by pressing the “missions and competitions” icon in the upper left corner of the game screen. As in our example company, these competitions can be on more than one subject. Here is your aim; It will be to finish the competition you participated in with the best scores. As a result of the competitions, you will be able to reach the prizes determined by your game manager. So what are you waiting for? Come on, be a part of this race now and enjoy a pleasant competition with your friends!

Activating the User

PUT: /api/v{version}/User/{id}/make-active

Version: 1

Responses:

				
					200 SUCCESS
{
  "success": true
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			

Labels

What is the tag system?

The tag system is a system created to allow you to easily group users in the game. Here you can group users using the application according to their specific characteristics, as in the example company. You can increase efficiency within the application by creating special activities for these groups. For example, in this company, users are grouped according to the cities they live in, their experiences and the regions they belong to, and labels are created accordingly. In this way, the company aims to increase the productivity of an inexperienced employee by creating a special activity for the city or inexperienced employee he sees as lacking.

How can I create a new tag for users?

To create a new tag, you must first click on the “Tags” tab on the left side of the admin panel. Before creating a new tag, you need to add a tag category here. To do this, you must press the “+” button you will see on the screen. Here, you can create the category by typing the name of the tag category and pressing the “save” button. Then, you should go back to the “Tags” menu and select the category in which you will create the tag. To add a new tag, you must press the “New tag” button at the top right. This is the tag creation page. First you need to enter the name of your tag. You will then determine the users you will include in this tag. After completing all these steps, you should press the save button. Congratulations, you’ve successfully created the tag!

How does the testing system work?

Motivacraft offers a pleasant environment where you can talk not only your business performance but also your wisdom. By pressing the “test” icon in the upper left corner of the game screen, you can see the currently active new or previously completed tests. You can expand your knowledge by completing the tests assigned to you by the game administrator. These tests can be on different topics such as general culture questions, product knowledge or company knowledge, as in our example company. In addition, you need to get a certain number of correct answers to successfully complete these tests. Don’t be sad if you can’t. You can continue solving until you successfully complete the tests. Come on, take your first quiz now and raise your knowledge level!

How do I disable or delete a created video?

To update the status of the video you created, you must click on the “Videos” tab on the right side of the admin panel. You can change the status of the video at any time by clicking the “Active”, “Passive” or “Archived” button in the “Status” section to the left of the name of the relevant video in the list. If you want to delete the video completely, all you have to do is click on the “trash” icon to the right of the video name and delete the video. Remember, deleted videos cannot be retrieved!

Creating Activity Properties

POST: /api/v{version}/Metric/properties

Version: 1

Request Body:

				
					{
  "name": "string",
  "type": 1,
  "isActive": true
}
				
			

Responses:

				
					200 SUCCESS
{
  "success": true,
  "propertyId": 0,
  "fieldId": 0
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			
  • Property types:
    ○ Bool = 1
    ○ Numeric = 2
    ○ Text = 3

Can I change the language settings of the application?

Motivacraft has a flexible structure that is used in many countries globally and can be adapted to more than one language. If you want to change the language option in the game, you must first click on the “My Profile” tab in the upper right corner of the screen. Then, when you click on the “Edit” option on the left side of the screen, you will be able to see the active language option. Here you can choose one of the language options presented to you. We keep working to add more language options!

How can I create a new avatar?

There are many different avatars you can use to create your player ID in Motivacraft. By creating these avatars, you and your teammates can shape your player identity as you wish. To create a new avatar, you must first click on the “My Profile” tab in the upper right corner of the screen. Then, when you click the “Edit” option on the left side of the screen, you will see the “Password reset” section. When you click on the avatar here, you will see all the avatars you can choose. Come on, choose one of these avatars and add a different look to your profile!

User API

User API is a powerful programming interface used to manage user accounts and interact with users within an application or platform. This API enables developers to easily integrate user-centric functionalities such as processing user data, managing login and registration processes, and updating user profile information. User APIs are employed in a wide range of digital platforms, from social media integrations to online store applications. In summary, the User API empowers developers with robust user management and interaction capabilities, facilitating the development of more effective and user-focused applications.

User Registration

POST: /api/v{version}/User

Version: 1

Request Body:

				
					{
  "companyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "userName": "string",
  "displayName": "string",
  "email": "string",
  "password": "string",
  "role": 1,
  "image": "string",
  "cultureInfo": "string",
  "tagIds": [
    0
  ],
  "firmId": "string",
  "userIds": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}
				
			

Responses:

				
					200 SUCCESS
{
  "success": true,
  "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			
  • If the user registration is successful, the user Id of the created user is returned.
  • Role types can be:
    ○ Manager = 1,
    ○ User = 2,
    ○ Group User = 3,
    ○ Integration User = 4,
    ○ Report User = 5
  • If a report is requested to be sent to the users’ e-mails, the e-mail information must be filled while creating the user.
  • Password field should be sent unencrypted.
  • The firmId field can be used to add the user’s unique Id in the client system. By using this firmId, data can be sent in data integrations.
  • The userIds field is only for role = 3 ie group users. The activities of the users whose IDs are given here are reflected to this user. This is the setup that should be used for group setups.
  • If the user registration is successful, the user Id of the created user is returned.
    ● Role types can be:
    ○ Manager = 1,
    ○ User = 2,
    ○ Group User = 3,
    ○ Integration User = 4,
    ○ Report User = 5
    ● If a report is requested to be sent to the users’ e-mails, the e-mail information must be filled while creating the user.
    ● Password field should be sent unencrypted.
    ● The firmId field can be used to add the user’s unique Id in the client system. By using this firmId, data can be sent in data integrations.
    ● The userIds field is only for role = 3 ie group users. The activities of the users whose IDs are given here are reflected to this user. This is the setup that should be used for group setups.
    ● tagIds contains the Ids that the user wants to have.
    ● CultureInfo:
       ○ en-TR
       ○ en-US
       It can take one of its values.

Disabling the User

PUT: /api/v{version}/User/{id}/make-passive

Version: 1

Responses:

				
					200 SUCCESS
{
  "success": true
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			

Activating the User

PUT: /api/v{version}/User/{id}/make-active

Version: 1

Responses:

				
					200 SUCCESS
{
  "success": true
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			

Motivacraft Mobile App Home Screen

What awaits you in the Motivacraft Mobile App home screen when you first login.

Register

POST: api/v{version}/Auth/register

Version: 1

Request Body:

				
					{
  "displayName": "string",
  "email": "string",
  "password": "string",
  "passwordConfirm": "string",
  "image": "string",
  "domain": "string",
  "invitationToken": "string",
  "companyName": "string",
  "defaultCulture": "string",
  "demoType": 1
}
				
			

Responses:

				
					200 SUCCESS
{
  "type": "string",
  "token": "string",
  "expireIn": 0,
  "role": 0
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			
  • If there is no authenticated bearer token during registration, the guest bearer token should be used.
  • If user registration is successful, authenticated bearer token is also returned.
  • If the user is requested to register with a certain company, it can be ensured that the company is registered by using the InvitationToken belonging to that company.
  • If the user does not have a company and the company will be created with this user, if the “companyName” part is filled, the company belonging to this user will be created.

Features

How does the quest system work?

You can see your missions by pressing the “missions and competitions” icon in the upper left corner of the game screen. With the tasks created by your game manager, you will be able to view your goals easily and follow them instantly. You will also see the rankings of your teammates here and you will be in a pleasant competition with them. If you successfully complete the tasks assigned to you, you will be able to reach the rewards (eg moti, badge, etc.) determined by your game administrator. This way, you’ll improve your performance and get one step closer to being at the top of the leaderboard. Good games!

How does the competition system work?

Welcome to the competition system we’ve created to help you improve your performance! You can see completed or ongoing enjoyable competitions by pressing the “missions and competitions” icon in the upper left corner of the game screen. As in our example company, these competitions can be on more than one subject. Here is your aim; It will be to finish the competition you participated in with the best scores. As a result of the competitions, you will be able to reach the prizes determined by your game manager. So what are you waiting for? Come on, be a part of this race now and enjoy a pleasant competition with your friends!

How does the testing system work?

Motivacraft offers a pleasant environment where you can talk not only your business performance but also your wisdom. By pressing the “test” icon in the upper left corner of the game screen, you can see the currently active new or previously completed tests. You can expand your knowledge by completing the tests assigned to you by the game administrator. These tests can be on different topics such as general culture questions, product knowledge or company knowledge, as in our example company. In addition, you need to get a certain number of correct answers to successfully complete these tests. Don’t be sad if you can’t. You can continue solving until you successfully complete the tests. Come on, take your first quiz now and raise your knowledge level!

How does the quiz system work?

In Motivacraft, we have created a system where you can always keep your information fresh. If there is a quiz you can participate in by pressing the “quiz” icon in the upper left corner of the game screen, you can start answering the questions immediately. Remember, you can only solve quizzes only once, so your score matters! There can also be more than one quiz active at the same time. In this case, after you’ve finished answering the first one, you’ll need to come back to the Quiz page to view the next quiz. You will reinforce and repeat the knowledge you have learned by answering the questions created by your game manager. In this way, you will take your performance one step further with your ever-fresh range of knowledge! Let’s solve the first problem and test your knowledge!

What is Moti?

You win Moti after the enjoyable competitions you participate in and the missions you successfully complete in Motivacraft. You will use your Moti in the reward market to access rewards created by your game manager. To reach these rewards, you must accumulate Moti. You can see the Moti points you have in the upper right corner of the game screen. Come on, complete your missions and competitions at the top, collect Moti and get the prizes you want!

How to use the reward market?

We have created a reward market system where you can spend the Moti points you earn after completing your tasks in Motivacraft and having enjoyable competitions with your team. To reach the prize market, simply click on the gift icon in the upper right corner of the game screen. You can see how many Moti are required for each reward in the reward market created by your game manager. You can convert your accumulated Moti into rewards here and enjoy the reward. You will also find that there are some special rewards available in the reward market that you cannot purchase using Moti. To earn these rewards, you must complete a special mission or rank up in the competition. In the description section of the rewards, it will be written in detail what you need to do to win. Come on, big prizes are waiting for you!

How does the activity system work?

At Motivacraft, we attach great importance to data analysis to improve its performance. You can monitor the process of reaching your goals with the activities created by your game manager, or you can add data yourself by clicking the “+” icon at the bottom of the game screen. To add an activity, you must click on the “Add Activity” tab on the left. Then you have to choose the category of the activity to add and choose which activity to add here. Activities can be added numerically or textually. After adding an activity, you can browse your current and past activities from the “My Activities” tab on the left. Come on, add your completed activities to Motivacraft and get one step closer to your goals!

How does the badge system work?

You can access the badges you can earn after completing missions, competitions and tests from the “My Profile” tab. The colored badges represent the badges you have earned. The numbers written in the red area at the top left of the badges show how many of those badges they have won so far. Badges you haven’t earned yet are shown in gray/dim. If you want to get more detailed information about any badge, you can access the details page by clicking the badge. Here you can see detailed information about how you can earn the badge, as well as the dates you have already earned. Come on, now is the time to grow your badge collection!

How does the ranking system work?

One of the main purposes in Motivacraft is to continue the story on the main screen by gaining XP, that is, experience points, after activities such as tasks, competitions and tests you have completed. When you enter the “Ranking” tab in the upper right corner of the screen, you can see the experience points you have and the points of your teammates. You can also examine the competition in different subgroups by using the tabs (if any) in the ranking area. Come on now, increase your ranking by completing the events given to you and enjoy the sweet competition with your teammates!

How does the social networking system work?

Motivacraft is not only a working platform for you and your teammates, it also creates an environment where you can socialize. When you click on the “Social” tab in the upper right corner of the game screen, you will see the “Wall” and “Praise” sections. In the “Wall” section, you can see the posts shared by your teammates; You can interact with them by liking or commenting. You can also share a post using the area prepared for you to share. A little tip; You can click the “add photo” icon to add photos to your posts. (The photos you add should not be larger than 10 MB and should be in .jpg or .png format.) In the “Praise” section, you can praise your teammates for their work or achievements. To do this, you must first choose a compliment. Then you have to choose the person you want to send it to, and you can also send him a message if you want. In the “Praise Transaction History”, you can view the compliments you have sent and received. Come on, now enjoy chatting with your teammates by sharing a post on your wall!

How does the level system work?

To pass each level on the Motivacraft gamification platform, you need to reach a predetermined experience point (XP). You can earn XP points by completing tasks assigned to you, ranking in competitions, and participating in other activities (reading articles, watching videos, giving a certain number of correct answers in tests, etc.). You can follow your level progress from the level bar at the top of the game screen. Each time you level up, you’ll unlock a new spot on your game map, and you’ll be one step closer to completing the story. You can also see the levels you have completed by clicking the “i” button on the right side of the level bar. Come on now, get one step ahead of your friends by successfully completing the activities assigned to you and discover the next level!

How does the video system work?

We have created a video system to make it easier for you to learn in Motivacraft. By clicking the icon in the upper left corner of the game screen, you will reach the screen where you will see tests, quizzes, videos and articles. Here, when you click on the “video” tab on the left, you will be able to see the video content assigned by your game manager. You can access the video by selecting the content you want to watch. After completing your video, you can successfully complete the task by pressing the “Wached” button at the bottom. Come on, reinforce what you’ve learned by watching the videos assigned to you right now!

How does the article system work?

We have created an article system to make it easier for you to learn in Motivacraft. By clicking the icon in the upper left corner of the game screen, you will reach the screen where you will see tests, quizzes, videos and articles. Here, when you click on the “article” tab on the left, you will be able to see the articles assigned by your game administrator. You can reach the article by selecting the content you want to read. After you have finished reading the article, you can successfully complete the task by clicking the “I have read” button at the bottom. Come on, reinforce what you’ve learned by reading the articles assigned to you right now!

Learning the Characteristics of the Activity

GET: /api/v{version}/Metric/properties

Version: 1

Responses:

				
					200 SUCCESS
[
  {
    "id": 0,
    "name": "string",
    "type": 1,
    "isActive": true
  }
]
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			
  • Property types:
    ○ Bool = 1
    ○ Numeric = 2
    ○ Text = 3

Badges

How can I create a new badge?

To create a new badge, you must first click on the “Badges” tab on the left side of the admin panel. Before creating a new badge, you need to create a badge category here. To do this, you must press the “+” button you will see on the screen. Here you can set the order in which the tag category will appear after typing its name. Additionally, if you want to customize the badge for a specific group, you can select that group from the labels section. After completing these procedures

How can I edit the badges I've created?

To edit a badge you created, you must first click on the “Badges” tab on the left side of the admin panel. In the badge list, you will see the edit icon to the right of the name of the badge you will edit. When you click on this icon, you will see the screen where you created the badge. Here you can edit the badge as you wish.

How can I view badge winners?

To view the users who have earned the badges you created, you must first click on the “Badges” tab on the right side of the admin panel. Here, there is a “Badge Winners” icon to the right of the name of the badge. When you click on this option, you will be able to view the ranking of users who earned the badge you created. You can also download this data to your computer as an Excel file by clicking the “Export” button above.

How does the quiz system work?

In Motivacraft, we have created a system where you can always keep your information fresh. If there is a quiz you can participate in by pressing the “quiz” icon in the upper left corner of the game screen, you can start answering the questions immediately. Remember, you can only solve quizzes only once, so your score matters! There can also be more than one quiz active at the same time. In this case, after you’ve finished answering the first one, you’ll need to come back to the Quiz page to view the next quiz. You will reinforce and repeat the knowledge you have learned by answering the questions created by your game manager. In this way, you will take your performance one step further with your ever-fresh range of knowledge! Let’s solve the first problem and test your knowledge!

Mobile App

How can I download the iOS version of the app?

To access our mobile application that we have created so that you can easily access Motivacraft from anywhere, you can download it from the link you will reach by clicking the “Download from App Store” option on the home screen. You can also install the application that comes up by typing “Motivacraft” in the App Store and enjoy gamification anywhere!

How can I download the Android version of the application?

To access our mobile application that we have created so that you can easily access Motivacraft from anywhere, you can download it from the link you will reach by clicking the “Get from Google Play” option on the home screen. You can also install the application that comes up by typing “Motivacraft” on Google Play and enjoy gamification anywhere!

Motivacraft Mobile App Home Screen

What awaits you in the Motivacraft Mobile App home screen when you first login.

How can i see missions and competitions in mobile app?

How to get details for the missions and competitions you are attending to in the mobile app.

Motivacraft Mobile App Trainings

Learn more about Motivacraft Mobile App.

Motivacraft Mobile App Manual Data Entry

How to enter data manually using mobile app.

Motivacraft Mobile App Your Story

Learn more about your story in Motivacraft mobile app.

Motivacraft Mobile App My Profile

Learn more about your profile in Motivacraft Mobile App.

Motivacraft Mobile App Reward Market

Learn more about reward market in Motivacraft Mobile App.

Motivacraft Mobile App Settings

Learn more about settings in Motivacraft Mobile App.

How can I edit a video I created?

To edit a video you have created, you must first click on the “Videos” tab on the left side of the admin panel. You will see the edit icon to the right of the name of the article you will edit in the video list. When you click on this icon, you will see the screen where you created the video. Here you can edit the video as you wish.

How can i see missions and competitions in mobile app?

How to get details for the missions and competitions you are attending to in the mobile app.

Awards

What is the reward system?

At Motivacraft, we have created a reward system to help users improve their performance. Users earn Moti points as a reward after completing actions such as tasks, competitions or articles. Then, by accumulating these Moti points they earn, they receive a reward from the reward market you created. These rewards aim to increase users’ motivation. Now you can help users embellish their enjoyable competitions with rewards by creating a reward market.

How can I create my reward market?

To create a reward market, you must first click on the “Rewards” tab on the left side of the admin panel. Before creating a new reward, you need to add a reward category here. To do this, you must press the “+” button you will see on the screen. Here you need to specify the name of the award category. Then, you should go back to the “Awards” menu and select the category of the reward you will create. To create a new award, you must press the “New award” button at the top right. This is the reward creation page. Here, after determining the name, description and image of the award, you must determine how many Moti points it is worth and the number of stocks. Finally, there are two different types of challenges here. These can be “taken” and “earned”. The “purchasable” ones can be owned for a certain Moti point. “Earnable” ones are rewards earned as a result of activities such as any task, article or test. After entering the reward information, you must press the “save” button. Congratulations, you have successfully created the bounty!

Company Activity Categories

GET: /api/v{version}/Metric/category/all

Version: 1

Responses:

				
					200 SUCCESS
{
  "metricCategories": [
    {
      "id": 0,
      "name": "string",
      "isActive": true
    }
  ]
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			

How can I create a new test or quiz?

To create a new test, you must first click on the “Tests” tab on the left side of the admin panel. Here you can see all the tests you have created. To add a new test, you must press the “New Test” button at the top right. This is the test creation section. First, you need to choose the test name and type, then determine the start and end dates. You can also determine at what time it will start and end in the box where you see the dates. If you do not set a custom time, the system time will be used by default. Finally, on this page, you should write the description of the test. In the “Advanced Settings” section, you need to select the group you want to define this test for, how many questions will be per test and how long you will give it. Here you can choose to automatically check for true and false. If you want, you can add a test at the end of this video. In the “Schedule & Difficulties” section, you can customize which days and between which times the test will be published. You can also assign tests randomly by determining the difficulty level of the questions. Finally, you can successfully create a new test by clicking the “Create” button. Congratulations!

What is Moti?

You win Moti after the enjoyable competitions you participate in and the missions you successfully complete in Motivacraft. You will use your Moti in the reward market to access rewards created by your game manager. To reach these rewards, you must accumulate Moti. You can see the Moti points you have in the upper right corner of the game screen. Come on, complete your missions and competitions at the top, collect Moti and get the prizes you want!

Motivacraft Mobile App Trainings

Learn more about Motivacraft Mobile App.

User's Roles

GET: /api/v{version}/User/missions

Version: 1

Responses:

				
					200 SUCCESS
{
  "userMissions": [
    {
      "id": 0,
      "categoryId": 0,
      "orderNumber": 0,
      "isJoinable": true,
      "isVisible": true,
      "name": "string",
      "progress": 0,
      "endDate": "2023-07-26T20:07:02.937Z",
      "startDate": "2023-07-26T20:07:02.937Z",
      "progressItems": [
        "string"
      ],
      "progressItemList": [
        {
          "targetType": "string",
          "metricName": "string",
          "metricPropertyName": "string",
          "userValue": "string",
          "userTarget": "string"
        }
      ]
    }
  ],
  "generalMissions": [
    {
      "id": 0,
      "categoryId": 0,
      "orderNumber": 0,
      "isJoinable": true,
      "isVisible": true,
      "name": "string",
      "progress": 0,
      "endDate": "2023-07-26T20:07:02.937Z",
      "startDate": "2023-07-26T20:07:02.937Z",
      "progressItems": [
        "string"
      ],
      "progressItemList": [
        {
          "targetType": "string",
          "metricName": "string",
          "metricPropertyName": "string",
          "userValue": "string",
          "userTarget": "string"
        }
      ]
    }
  ],
  "userCompletedMissions": [
    {
      "id": 0,
      "categoryId": 0,
      "orderNumber": 0,
      "isJoinable": true,
      "isVisible": true,
      "name": "string",
      "progress": 0,
      "endDate": "2023-07-26T20:07:02.937Z",
      "startDate": "2023-07-26T20:07:02.937Z",
      "progressItems": [
        "string"
      ],
      "progressItemList": [
        {
          "targetType": "string",
          "metricName": "string",
          "metricPropertyName": "string",
          "userValue": "string",
          "userTarget": "string"
        }
      ]
    }
  ]
}
				
			
				
					400 BAD REQUEST
{
  "message": "string",
  "exceptionType": 1,
  "version": "string"
}
				
			
  • “userMissions” means active tasks of the user,
  • “generalMissions” missions that the user cannot complete,
  • “userCompletedMissions” returns user completed tasks.

Motivacraft Mobile App Manual Data Entry

How to enter data manually using mobile app.

How to use the reward market?

We have created a reward market system where you can spend the Moti points you earn after completing your tasks in Motivacraft and having enjoyable competitions with your team. To reach the prize market, simply click on the gift icon in the upper right corner of the game screen. You can see how many Moti are required for each reward in the reward market created by your game manager. You can convert your accumulated Moti into rewards here and enjoy the reward. You will also find that there are some special rewards available in the reward market that you cannot purchase using Moti. To earn these rewards, you must complete a special mission or rank up in the competition. In the description section of the rewards, it will be written in detail what you need to do to win. Come on, big prizes are waiting for you!

Levels

How can I create a new level?

To create a new level, you must first click on the “Levels” tab on the left side of the administration panel. Here you can see and manage the list of levels you have created. To add a new level, you must press the “New level” button at the top right. This is the level creation screen. First you need to determine which level you are doing. Afterwards, you must determine in which XP ranges this level will be in the minimum and maximum XP sections. In the “Background Image” section, you should upload the game image that users will see throughout that level. In the starting text section, you can add the welcome text and image that the player will see when they reach the level you created. You can also indicate that you have completed the level by adding an end image and text. Finally, you can optionally set a reward or badge that the player can earn if they beat the level. After filling in the information on the page, you should press the “save” button. Congratulations, you have successfully created the level!

How do I edit or delete the levels I've created?

In order to view the levels you have created, you must first click on the “Levels” tab on the left side of the administration panel. Here you can see and manage the list of levels you have created. To delete a created level, just press the “trash can” icon on the right. Remember, deleted levels cannot be restored! If you want to edit the level, you will reach the level creation screen by pressing the blue edit icon on the right side of the relevant level in the “Levels” list. Here you can edit the levels you create as you wish.

How can I add a new question?

After you successfully create a new test, you should prepare the questions that will fill that test. To do this, you must first click on the “Tests” tab on the left side of the administration panel. Here you will see the list of tests you have created. You should click on the “question mark” icon on the right side of the test to which you want to add a question. By pressing this button, you can see all the questions you have prepared for the relevant test. For a new question, you should press the “Edit questions” button at the top right. Here you will see all the questions you created for that test. You can add a new question by pressing the “Add question” button. First you need to choose whether the question is text or option. Then you need to determine the priority order and difficulty level. After writing the question in the Question section, you need to add the answers to the “Options” section. Don’t forget to tick the option with the correct answer here. Finally, you can create the question by pressing the “create” button. Congratulations!

Motivacraft Mobile App Your Story

Learn more about your story in Motivacraft mobile app.

How can I edit a test I created?

To edit a test you have created, you must first click on the “Tests” tab on the left side of the admin panel. You will see the edit icon to the right of the name of the test you will edit in the test list. When you click on this icon, you will see the test creation screen. Here you can edit the test as you wish.

Dynamic Goals

How can I add a new dynamic target?

To create a new dynamic target, you must first click on the “Dynamic Targets” tab on the left side of the admin panel. Here you can see the dynamic targets you have created. To add a new dynamic target, you must press the “New target” button at the top right. This is the dynamic goal creation page. You can edit your dynamic target using the visual or JSON editor. We will use the visual editor in the training. First you need to determine a name for the dynamic target and how much the target will be. After determining these, you can use a visual that defines this goal if you wish. If you want to personalize the goal you have given, you should select the user by pressing the “Add User” button and determine how much your new goal will be. You can personalize this for as many users as you want. If you do not want to personalize, you can easily remove the users you added and create the general target for everyone. After entering the information about the dynamic target, you should press the “save” button. Congratulations, you have successfully created the dynamic target!

What is a dynamic target system?

At Motivacraft, we added a dynamic goal system to encourage users to further improve their performance. With this system, you can create dynamic goals for users and personalize these goals for each user. To reinforce the point, let’s look at the dynamic goals of our example company. This company of ours has determined its monthly sales target as a dynamic target. When we examine the dynamic target they created in detail, all users were given a monthly target of 10000 dollars. We can also see in the “Goals” section that several users have personalized goals. In this way, the company may have given such a goal to users who already have a successful performance graph, to take their performance one step further. So what will you do? Come on, assign the most appropriate goals to your team and watch their development!

How competitions based on test results work?

This provides clarity on how our platform conducts competitions based on test and quiz results. Understanding the mechanisms of these competitions will enhance your strategy and performance.
Core Principles
Competitions are centered on the correct answers provided within the competition’s timeframe. However, the calculation of scores differs between tests and quizzes to accurately capture the essence of each type, as well as their contribution to overall competition results.
Tests: Continuous Improvement
Multiple Attempts Allowed: Participants can take the same test multiple times during the competition.
Score Calculation: The highest number of correct answers from all attempts by each user is recorded. This reflects the best individual effort and learning progression.
Purpose: Designed to support iterative learning and mastery, encouraging users to build upon previous knowledge and skills.
Quizzes: Comprehensive Understanding
Cumulative Performance: Quizzes can only be repeated on different days, therefore the competition considers the total number of correct answers from all attempts.
Score Calculation: Every correct answer from each attempt is added to create a cumulative score that contributes to the competition outcome.
Purpose: Aims to measure overall knowledge breadth and consistent performance across attempts.
Combined Competitions
In competitions that incorporate both tests and quizzes:
Tests’ Contribution: Only the maximum correct answers from one test attempt are considered.
Quizzes’ Contribution: The total correct answers from all quiz attempts are summed up.
Objective: This blended approach ensures fairness by capturing the strengths of both formats—rewarding deep learning and consistent performance.
Why This Approach?
Tests’ Specialty: Reflects growth and peak achievement through multiple trials.
Quizzes’ Specialty: Captures comprehensive and reliable knowledge representation.
With these scoring methodologies, our platform offers a balanced and fair competition structure, highlighting different skills and learning styles.

How does the activity system work?

At Motivacraft, we attach great importance to data analysis to improve its performance. You can monitor the process of reaching your goals with the activities created by your game manager, or you can add data yourself by clicking the “+” icon at the bottom of the game screen. To add an activity, you must click on the “Add Activity” tab on the left. Then you have to choose the category of the activity to add and choose which activity to add here. Activities can be added numerically or textually. After adding an activity, you can browse your current and past activities from the “My Activities” tab on the left. Come on, add your completed activities to Motivacraft and get one step closer to your goals!

How does the badge system work?

You can access the badges you can earn after completing missions, competitions and tests from the “My Profile” tab. The colored badges represent the badges you have earned. The numbers written in the red area at the top left of the badges show how many of those badges they have won so far. Badges you haven’t earned yet are shown in gray/dim. If you want to get more detailed information about any badge, you can access the details page by clicking the badge. Here you can see detailed information about how you can earn the badge, as well as the dates you have already earned. Come on, now is the time to grow your badge collection!

How do I edit a question I created?

To edit a question you have created, you must first click on the “Tests” tab on the left side of the admin panel. Here you will see the list of tests you have created. You should click on the “question mark” icon on the right side of the test to which you want to add a question. By pressing this button, you can see all the questions you have prepared for the relevant test. To edit the question, you must press the “Edit questions” button at the top right. Here you can see and edit all the questions you created for that quiz.

Activities

How can I create a new activity?

To create a new activity, you must first click on the “Activities” tab on the left side of the admin panel. Before creating a new activity, you need to add an activity category here. To do this, you must press the “+” button you will see on the screen. Here you should write the name of the activity category and the feature of the activity. Then, you should go back to the “Activities” menu, select the category of the activity you will create and press the “New activity” button at the top. This is the activity creation page. First, you must enter the activity name. You can check the box to allow the user to manually add activities. Optionally, you can assign the activity you created to specific users with the tag system. Finally, after determining the XP and Moti that the user will earn, you should press the “save” button! Congratulations, you have successfully created the activity!

How can I edit or delete activities that I have created?

To change the status of an activity you created, you must first click on the “Activities” tab on the left side of the admin panel. Here you can see all the activities you have created. To delete a created activity, simply press the “delete” icon on the right. You can also make the activity invisible by pressing the “disable” button. If you want to edit the activity, you will reach the activity creation screen by pressing the blue edit icon on the right side of the relevant level in the “Activities” list. You can edit the activities you create here as you wish.

Motivacraft Mobile App My Profile

Learn more about your profile in Motivacraft Mobile App.

Motivacraft Mobile App Reward Market

Learn more about reward market in Motivacraft Mobile App.

How can I view users test results?

To view the list of users who completed the test you created, you must first click on the “Tests” tab on the right side of the admin panel. There is a “show results” icon to the right of the name of the relevant test in the list. When you click on this icon, you will be able to view the list of all users who have completed the test you assigned.

How does the ranking system work?

One of the main purposes in Motivacraft is to continue the story on the main screen by gaining XP, that is, experience points, after activities such as tasks, competitions and tests you have completed. When you enter the “Ranking” tab in the upper right corner of the screen, you can see the experience points you have and the points of your teammates. You can also examine the competition in different subgroups by using the tabs (if any) in the ranking area. Come on now, increase your ranking by completing the events given to you and enjoy the sweet competition with your teammates!

Organization Settings

How do I update the logo that appears in-game?

To update the logo that appears in the game, you must first click on the “Organization Settings” tab on the left side of the admin panel. Here you will see active company information. When you press the blue edit icon to the right of the company name you want to edit, you will reach the organization editing page. You can update the in-game logo as you wish from the “gamification logo” section here.

How do I update my organization information?

To update organization information, you must first click on the “Organization Settings” tab on the left side of the admin panel. Here you will see active company information. When you press the blue edit icon on the right side of the company name you want to update, you will reach the organization editing page. On this page, you can change the name of the organization you created, add an announcement, edit the logo and make arrangements for the leaderboard.

How can I list the experience point ranking on a monthly basis?

If you wish, you can list the experience point ranking displayed in the game for all time or monthly. To select this, you must first click on the “Organization Settings” tab on the left side of the administration panel. Here you will see active company information. When you press the blue edit icon on the right side of the company name you want to update, you will reach the organization editing page. Under the “Leaderboard Privacy Settings” section on this page, click “Leaderboard reflects only current month” When you select the mark, the ranking will be listed monthly. When you uncheck it, you will be listing for all times. You can make changes to the listing on this page whenever you want.

Missions

How can I create a new missions?

To create a new task, you must first click on the “Tasks” tab on the left side of the admin panel. Before creating a task, you need to add a task category here. To do this, you must press the “+” button you will see on the screen. Here you can write the name of the mission category and the order in which you want it to appear in the player panel. Then you have to return to the “missions” menu again. After selecting a category here, you must press the “New Mission” button at the top right to add a new mission. This is the task creation section. First of all, you need to determine the task name, the order in which this task will appear, and the start and finish dates. You can also determine at what time it will start and end in the box where you see the dates. If you do not set a custom time, the system time will be used by default. After completing these, you should write your job description in the description section. After writing the task description, you can click the “Next” button and choose which users to assign the task to. Afterwards, you can determine the metrics of the task in the “Rule Sets” section. In the “Actions” section, you can determine the rewards you will assign to the players as a result of the mission. In the “Schedule” section, you can give a command to renew the task daily or weekly. In the “Miscellaneous” section, you can also select the final details about the mission. Here you can delete xp or moti for users who cannot complete the task in the “leaderboard” settings and “penalties” sections. Finally, you can create the task by pressing the “Submit” button. Congratulations!

How can I edit a mission I created?

Is there something missing in the task you created? Or do you want to update your rewards? You can make any arrangements regarding your duties. To do this, you must first click on the “Tasks” tab on the left side of the admin panel. You will see the edit icon to the right of the name of the task you will edit in the task list. When you click on this icon, you will see the screen where you created the task. Here you can organize your tasks as you wish.

How can I see who has completed missions?

To view the users who have completed the tasks you created, you must first click on the “Tasks” tab on the right side of the admin panel. There is an “completed by” icon to the right of the name of the relevant task in the list where you can list those who have completed the task. When you click on this icon, you will be able to view all users who have completed the task you gave.

How can I see the mission achievement ranking?

To view the success ranking of users who have completed the tasks you have created, you must first click on the “Tasks” tab on the right side of the admin panel. There is a “leaderboard” icon to the right of the name of the relevant task in the list. When you click on this icon, you will be able to view the success ranking of all users who have completed the task you have given.

How do I disable or delete a created mission?

You can change the status of the task at any time by clicking the “Active”, “Passive” or “Archived” button in the “Status” section to the left of the name of the relevant task in the list. If you want to delete the task completely, all you have to do is click on the “trash” icon to the right of the task name and delete the task. Remember, deleted tasks cannot be undone!

How do I disable or delete a created test?

In order to update the status of the test you created, you must click on the “Tests” tab on the right side of the admin panel. You can change the status of the test at any time by clicking the “Active”, “Passive” or “Archived” button in the “Status” section to the left of the name of the relevant test in the list.

Motivacraft Mobile App Settings

Learn more about settings in Motivacraft Mobile App.

How does the social networking system work?

Motivacraft is not only a working platform for you and your teammates, it also creates an environment where you can socialize. When you click on the “Social” tab in the upper right corner of the game screen, you will see the “Wall” and “Praise” sections. In the “Wall” section, you can see the posts shared by your teammates; You can interact with them by liking or commenting. You can also share a post using the area prepared for you to share. A little tip; You can click the “add photo” icon to add photos to your posts. (The photos you add should not be larger than 10 MB and should be in .jpg or .png format.) In the “Praise” section, you can praise your teammates for their work or achievements. To do this, you must first choose a compliment. Then you have to choose the person you want to send it to, and you can also send him a message if you want. In the “Praise Transaction History”, you can view the compliments you have sent and received. Come on, now enjoy chatting with your teammates by sharing a post on your wall!

Competitions

How can I create a new competition?

To create a new competition, you must first click on the “Competitions” tab on the left side of the admin panel. Before creating a competition, you need to add a competitions category here. To do this, you must press the “+” button you will see on the screen. Here you can write the name of the competitions category and the order in which you want it to appear in the player panel. Then you should return to the “Competitions” menu again. You can see all the competitions he created here. To add a new competition, you must press the “New competition” button at the top right. This is the competitions creation section. First of all, you need to determine the name of the competition, the order in which this competition will appear and the start and end dates. You can also determine at what time it will start and end in the box where you see the dates. If you do not set a custom time, the system time will be used by default. Once you’ve completed these, you must upload an image for the contest. After uploading the contest image, you will click on the “Next” button and you will be taken to the “Advanced Settings” section where you will determine the details of the contest. Here you must first select the competition type. Next, you should determine the visibility of this contest and details such as which users will participate in the contest. In the “Awards” section, you can determine the awards you will assign to the players as a result of the competition. You can personalize the rewards as you wish. In addition, when players click on the option to automatically distribute the reward, the system will automatically distribute the rewards as soon as the competition is completed. Congratulations, you have successfully created a new contest!

How do I edit a competition I created?

To organize a competition you have created, you must first click on the “Competitions” tab on the left side of the admin panel. In the Competitions list, you will see the edit icon to the right of the name of the competition you will organize. When you click on this icon, you will see the screen where you created the contest. Here you can organize the competitions as you wish.

How can I see the ranking of competing users?

To view the success ranking of users who have completed the competitions you have created, you must first click on the “Competitions” tab on the right side of the admin panel. There is a “leaderboard” icon to the right of the name of the relevant competition in the list. When you click on this icon, you will be able to view the success ranking of all users who completed your competition.

How do I disable or delete a created competition?

In order to update the status of the competition you created, you must click on the “Contests” tab on the right side of the admin panel. You can change the status of the competition at any time by clicking the “Active”, “Passive” or “Archived” button in the “Status” section to the left of the name of the relevant competition in the list. If you want to delete the contest completely, all you have to do is click on the “trash can” icon to the right of the contest name and delete the contest. Remember, deleted contests cannot be retrieved!

What is the tag system?

The tag system is a system created to allow you to easily group users in the game. Here you can group users using the application according to their specific characteristics, as in the example company. You can increase efficiency within the application by creating special activities for these groups. For example, in this company, users are grouped according to the cities they live in, their experiences and the regions they belong to, and labels are created accordingly. In this way, the company aims to increase the productivity of an inexperienced employee by creating a special activity for the city or inexperienced employee he sees as lacking.

How does the level system work?

To pass each level on the Motivacraft gamification platform, you need to reach a predetermined experience point (XP). You can earn XP points by completing tasks assigned to you, ranking in competitions, and participating in other activities (reading articles, watching videos, giving a certain number of correct answers in tests, etc.). You can follow your level progress from the level bar at the top of the game screen. Each time you level up, you’ll unlock a new spot on your game map, and you’ll be one step closer to completing the story. You can also see the levels you have completed by clicking the “i” button on the right side of the level bar. Come on now, get one step ahead of your friends by successfully completing the activities assigned to you and discover the next level!

How does the video system work?

We have created a video system to make it easier for you to learn in Motivacraft. By clicking the icon in the upper left corner of the game screen, you will reach the screen where you will see tests, quizzes, videos and articles. Here, when you click on the “video” tab on the left, you will be able to see the video content assigned by your game manager. You can access the video by selecting the content you want to watch. After completing your video, you can successfully complete the task by pressing the “Wached” button at the bottom. Come on, reinforce what you’ve learned by watching the videos assigned to you right now!

How can I create a new tag for users?

To create a new tag, you must first click on the “Tags” tab on the left side of the admin panel. Before creating a new tag, you need to add a tag category here. To do this, you must press the “+” button you will see on the screen. Here, you can create the category by typing the name of the tag category and pressing the “save” button. Then, you should go back to the “Tags” menu and select the category in which you will create the tag. To add a new tag, you must press the “New tag” button at the top right. This is the tag creation page. First you need to enter the name of your tag. You will then determine the users you will include in this tag. After completing all these steps, you should press the save button. Congratulations, you’ve successfully created the tag!

Users

How can I create a new user?

There are three different ways to add users in Motivacraft. You can create a user manually, by using an invitation link or by sending an invitation. To add a new user, you must click on the “Users” tab on the left side of the administration panel. Here you can see all the users in the application and download the list of users as an Excel file by pressing the “Export” button. To add a user manually, you must press the “New user” button at the top right. This is the user creation screen. Here, after entering the user’s name, surname and e-mail address, you will create a username and password to use as login information. You can then assign a role to that user, connect them to one of your teammates, or add a tag to include them in any group you’ve created. You can also enter date of hire and date of resignation information here. After entering your Registration ID, you will complete the information. Finally, you can successfully create the new user by pressing the “save” button. As a second method, you can copy the invitation link in the upper right corner of the “Users” tab, send it to the person you want to invite, and help them register for the application. As the last method, you should press the “Send Invitation” button in the upper right corner of the “Users” tab. On the screen that appears, you must write the name, surname and e-mail address of the user you will invite. The user can register for the application from the link sent to his e-mail address. Congratulations, you have successfully created the new user!

How do I deactivate or delete a user?

In order to update the status of the user you created, you must click on the “Users” tab on the right side of the admin panel. Here you will see the list of all users. First of all, to change the user’s status, you must press the “dot” icon on the left side of the username. When you select the “active” option here, the icon will be green and the user will be included in the application. In the “Passive” state, the user will not be able to log in to the application and it will be disabled and the color of the icon will be red. If you want to delete the user completely, all you have to do is click on the “trash can” icon to the right of the username and delete the user. Remember, deleted users cannot be retrieved!

Can I change the information of an active user?

To edit a user you created, you must first click on the “Users” tab on the left side of the admin panel. Here you will see the list of users you created. In the user list, you will see the edit icon to the right of the name of the user you will edit. When you click on this icon, you will see the screen where you created a user manually. Here you can organize users as you wish.

How can I create a new badge?

To create a new badge, you must first click on the “Badges” tab on the left side of the admin panel. Before creating a new badge, you need to create a badge category here. To do this, you must press the “+” button you will see on the screen. Here you can set the order in which the tag category will appear after typing its name. Additionally, if you want to customize the badge for a specific group, you can select that group from the labels section. After completing these procedures

Articles

How can I create a new article?

To create a new article, you must first click on the “Articles” tab on the left side of the admin panel. Before creating an article, you need to add an article category here. To do this, you must press the “+” button you will see on the screen. Here you can write the name of the article category and the order in which you want it to appear in the player panel. Then you should return to the “Articles” menu again. You can see all the articles he has created here. To add a new article, you must first select a category and then press the “New Article” button at the top right. This is the article creation section. First, you must write the article name and description. In the “Advanced Settings” section, you need to upload the article file and choose how long to give it to users. If you want, you can add a test at the end of this article. In the “Users & Awards” section, you must choose which users you will assign the article to and then choose the reward you will distribute. After pressing the “Submit” button, you can successfully create a new article. Congratulations!

How can I edit an article I created?

To organize a contest you have created, you must first click on the “Articles” tab on the left side of the admin panel. In the article list, you will see the edit icon to the right of the name of the article you will edit. When you click on this icon, you will see the screen where you created the article. Here you can edit the article as you wish.

How can I see users who have read the article?

To view the list of users who read the articles you created, you must first click on the “Articles” tab on the right side of the admin panel. There is an “eye” icon to the right of the name of the relevant article in the list. When you click on this icon, you will be able to view the list of all users who read the article you assigned.

How do I disable or delete a created article?

In order to update the status of the article you created, you must click on the “Articles” tab on the right side of the admin panel. You can change the status of the article at any time by clicking the “Active”, “Passive” or “Archived” button in the “Status” section to the left of the name of the relevant article in the list. If you want to delete the article completely, all you have to do is click on the “trash can” icon to the right of the article name and delete the article. Remember, deleted articles cannot be retrieved!

How does the article system work?

We have created an article system to make it easier for you to learn in Motivacraft. By clicking the icon in the upper left corner of the game screen, you will reach the screen where you will see tests, quizzes, videos and articles. Here, when you click on the “article” tab on the left, you will be able to see the articles assigned by your game administrator. You can reach the article by selecting the content you want to read. After you have finished reading the article, you can successfully complete the task by clicking the “I have read” button at the bottom. Come on, reinforce what you’ve learned by reading the articles assigned to you right now!

How can I edit the badges I've created?

To edit a badge you created, you must first click on the “Badges” tab on the left side of the admin panel. In the badge list, you will see the edit icon to the right of the name of the badge you will edit. When you click on this icon, you will see the screen where you created the badge. Here you can edit the badge as you wish.

How can I view badge winners?

To view the users who have earned the badges you created, you must first click on the “Badges” tab on the right side of the admin panel. Here, there is a “Badge Winners” icon to the right of the name of the badge. When you click on this option, you will be able to view the ranking of users who earned the badge you created. You can also download this data to your computer as an Excel file by clicking the “Export” button above.

MotivacraftTV

How can I use MotivacraftTV?

We will show you how to use MotivacraftTV step by step.We will show you how to use MotivacraftTV step by step.

Step 1:

Open a browser page and visit motivacraft.tv address. When you first time come to this address you will see an explanatory screen with a registration code. Please write down this registration code and do not close this webpage or refresh the page. Leave it be for now.

Step 2:

On a different tab or on a different computer, log in to motivacraft.com and go to the admin page. Click the Motivacraft TV tab on the left menu and under it, please select the Monitors tab.

Step 3:

Click “New Monitor” ot the top right and fill the information required there. Enter the registration code you got from motivacraft.tv window here and click submit. 

Now you can go back to the motivacraft.tv tab and wait a couple of seconds. As you have no playlist yet, you’d be seeing the registration code screen disappears and an empty screen comes. That’s totally normal.

Step 4:

Now it is time to create our playlist. Please go to the Motivacraft TV > Playlists section on the left menu. Give a name and description to your playlist. At the bottom lies your timeline. You can add 

– General Leaderboard (based on XP)

– Custom Leaderboard(s) After selecting the custom leaderboard, you’ll see a dropdown at the bottom to choose which custom leaderboard you’d like to display. (Collected boxes or performance)

– Mission Leaderboard: You can choose to show leaderboard for any mission, using the dropdowsn at the bottom of the settings page.

– Mission Top 10: This is a wall of fame feature and will display the top 10 players in that mission.

– Competition Leaderboard:

– Competition Top 10

– Announcements: you can display any 1920X1080px JPEG as an announcement. Announcements are managed (uploaded, changed etc.) from a separate panel on the left menu. Any announcement you have uploaded to the system can be added to the playlist directly.

– Date and Time: Please do not forget to select the correct time zone for the display. By default the organization’s time zone will come preselected.

– Weather: Please write the city name at the bottom area. Majority of the world’s cities are already in the database but if the city is not found, please try to enter some other place close to you.

Please note that, using the up and down arrows at the bottom of the playlist partitions, you can set how long each partition will stay on screen. Leaderboards with more than 10 players listed will rotate the users every ten seconds. First 10 will be shown for 10 seconds, later 11-20 will be shown 10 seconds so forth. For instance if you have a list of 50 players, it is recommended to set the mission leaderboard partition time as 50 seconds. 

Step 5:

If you haven’t done it already, attach this playlist to the monitor you have previously created. And enjoy the screens reflecting the actions.

Announcements:

This is the place where you manage your announcements. When you create a new announcement, there are two options given at the bottom. If you choose to automatically add to all playlists, this announcement will be added to all of the playlists without any further steps. If you choose not to automatically add, then you can add this announcement to any playlist as a partition manually later. 

What is the reward system?

At Motivacraft, we have created a reward system to help users improve their performance. Users earn Moti points as a reward after completing actions such as tasks, competitions or articles. Then, by accumulating these Moti points they earn, they receive a reward from the reward market you created. These rewards aim to increase users’ motivation. Now you can help users embellish their enjoyable competitions with rewards by creating a reward market.

How can I create my reward market?

To create a reward market, you must first click on the “Rewards” tab on the left side of the admin panel. Before creating a new reward, you need to add a reward category here. To do this, you must press the “+” button you will see on the screen. Here you need to specify the name of the award category. Then, you should go back to the “Awards” menu and select the category of the reward you will create. To create a new award, you must press the “New award” button at the top right. This is the reward creation page. Here, after determining the name, description and image of the award, you must determine how many Moti points it is worth and the number of stocks. Finally, there are two different types of challenges here. These can be “taken” and “earned”. The “purchasable” ones can be owned for a certain Moti point. “Earnable” ones are rewards earned as a result of activities such as any task, article or test. After entering the reward information, you must press the “save” button. Congratulations, you have successfully created the bounty!

How can I create a new level?

To create a new level, you must first click on the “Levels” tab on the left side of the administration panel. Here you can see and manage the list of levels you have created. To add a new level, you must press the “New level” button at the top right. This is the level creation screen. First you need to determine which level you are doing. Afterwards, you must determine in which XP ranges this level will be in the minimum and maximum XP sections. In the “Background Image” section, you should upload the game image that users will see throughout that level. In the starting text section, you can add the welcome text and image that the player will see when they reach the level you created. You can also indicate that you have completed the level by adding an end image and text. Finally, you can optionally set a reward or badge that the player can earn if they beat the level. After filling in the information on the page, you should press the “save” button. Congratulations, you have successfully created the level!

How do I edit or delete the levels I've created?

In order to view the levels you have created, you must first click on the “Levels” tab on the left side of the administration panel. Here you can see and manage the list of levels you have created. To delete a created level, just press the “trash can” icon on the right. Remember, deleted levels cannot be restored! If you want to edit the level, you will reach the level creation screen by pressing the blue edit icon on the right side of the relevant level in the “Levels” list. Here you can edit the levels you create as you wish.

How can I add a new dynamic target?

To create a new dynamic target, you must first click on the “Dynamic Targets” tab on the left side of the admin panel. Here you can see the dynamic targets you have created. To add a new dynamic target, you must press the “New target” button at the top right. This is the dynamic goal creation page. You can edit your dynamic target using the visual or JSON editor. We will use the visual editor in the training. First you need to determine a name for the dynamic target and how much the target will be. After determining these, you can use a visual that defines this goal if you wish. If you want to personalize the goal you have given, you should select the user by pressing the “Add User” button and determine how much your new goal will be. You can personalize this for as many users as you want. If you do not want to personalize, you can easily remove the users you added and create the general target for everyone. After entering the information about the dynamic target, you should press the “save” button. Congratulations, you have successfully created the dynamic target!

What is a dynamic target system?

At Motivacraft, we added a dynamic goal system to encourage users to further improve their performance. With this system, you can create dynamic goals for users and personalize these goals for each user. To reinforce the point, let’s look at the dynamic goals of our example company. This company of ours has determined its monthly sales target as a dynamic target. When we examine the dynamic target they created in detail, all users were given a monthly target of 10000 dollars. We can also see in the “Goals” section that several users have personalized goals. In this way, the company may have given such a goal to users who already have a successful performance graph, to take their performance one step further. So what will you do? Come on, assign the most appropriate goals to your team and watch their development!

How can I create a new activity?

To create a new activity, you must first click on the “Activities” tab on the left side of the admin panel. Before creating a new activity, you need to add an activity category here. To do this, you must press the “+” button you will see on the screen. Here you should write the name of the activity category and the feature of the activity. Then, you should go back to the “Activities” menu, select the category of the activity you will create and press the “New activity” button at the top. This is the activity creation page. First, you must enter the activity name. You can check the box to allow the user to manually add activities. Optionally, you can assign the activity you created to specific users with the tag system. Finally, after determining the XP and Moti that the user will earn, you should press the “save” button! Congratulations, you have successfully created the activity!

How can I edit or delete activities that I have created?

To change the status of an activity you created, you must first click on the “Activities” tab on the left side of the admin panel. Here you can see all the activities you have created. To delete a created activity, simply press the “delete” icon on the right. You can also make the activity invisible by pressing the “disable” button. If you want to edit the activity, you will reach the activity creation screen by pressing the blue edit icon on the right side of the relevant level in the “Activities” list. You can edit the activities you create here as you wish.

How do I update the logo that appears in-game?

To update the logo that appears in the game, you must first click on the “Organization Settings” tab on the left side of the admin panel. Here you will see active company information. When you press the blue edit icon to the right of the company name you want to edit, you will reach the organization editing page. You can update the in-game logo as you wish from the “gamification logo” section here.

How do I update my organization information?

To update organization information, you must first click on the “Organization Settings” tab on the left side of the admin panel. Here you will see active company information. When you press the blue edit icon on the right side of the company name you want to update, you will reach the organization editing page. On this page, you can change the name of the organization you created, add an announcement, edit the logo and make arrangements for the leaderboard.

How can I list the experience point ranking on a monthly basis?

If you wish, you can list the experience point ranking displayed in the game for all time or monthly. To select this, you must first click on the “Organization Settings” tab on the left side of the administration panel. Here you will see active company information. When you press the blue edit icon on the right side of the company name you want to update, you will reach the organization editing page. Under the “Leaderboard Privacy Settings” section on this page, click “Leaderboard reflects only current month” When you select the mark, the ranking will be listed monthly. When you uncheck it, you will be listing for all times. You can make changes to the listing on this page whenever you want.

How can I create a new missions?

To create a new task, you must first click on the “Tasks” tab on the left side of the admin panel. Before creating a task, you need to add a task category here. To do this, you must press the “+” button you will see on the screen. Here you can write the name of the mission category and the order in which you want it to appear in the player panel. Then you have to return to the “missions” menu again. After selecting a category here, you must press the “New Mission” button at the top right to add a new mission. This is the task creation section. First of all, you need to determine the task name, the order in which this task will appear, and the start and finish dates. You can also determine at what time it will start and end in the box where you see the dates. If you do not set a custom time, the system time will be used by default. After completing these, you should write your job description in the description section. After writing the task description, you can click the “Next” button and choose which users to assign the task to. Afterwards, you can determine the metrics of the task in the “Rule Sets” section. In the “Actions” section, you can determine the rewards you will assign to the players as a result of the mission. In the “Schedule” section, you can give a command to renew the task daily or weekly. In the “Miscellaneous” section, you can also select the final details about the mission. Here you can delete xp or moti for users who cannot complete the task in the “leaderboard” settings and “penalties” sections. Finally, you can create the task by pressing the “Submit” button. Congratulations!

How can I edit a mission I created?

Is there something missing in the task you created? Or do you want to update your rewards? You can make any arrangements regarding your duties. To do this, you must first click on the “Tasks” tab on the left side of the admin panel. You will see the edit icon to the right of the name of the task you will edit in the task list. When you click on this icon, you will see the screen where you created the task. Here you can organize your tasks as you wish.

How can I see who has completed missions?

To view the users who have completed the tasks you created, you must first click on the “Tasks” tab on the right side of the admin panel. There is an “completed by” icon to the right of the name of the relevant task in the list where you can list those who have completed the task. When you click on this icon, you will be able to view all users who have completed the task you gave.

How can I see the mission achievement ranking?

To view the success ranking of users who have completed the tasks you have created, you must first click on the “Tasks” tab on the right side of the admin panel. There is a “leaderboard” icon to the right of the name of the relevant task in the list. When you click on this icon, you will be able to view the success ranking of all users who have completed the task you have given.

How do I disable or delete a created mission?

You can change the status of the task at any time by clicking the “Active”, “Passive” or “Archived” button in the “Status” section to the left of the name of the relevant task in the list. If you want to delete the task completely, all you have to do is click on the “trash” icon to the right of the task name and delete the task. Remember, deleted tasks cannot be undone!

How can I create a new competition?

To create a new competition, you must first click on the “Competitions” tab on the left side of the admin panel. Before creating a competition, you need to add a competitions category here. To do this, you must press the “+” button you will see on the screen. Here you can write the name of the competitions category and the order in which you want it to appear in the player panel. Then you should return to the “Competitions” menu again. You can see all the competitions he created here. To add a new competition, you must press the “New competition” button at the top right. This is the competitions creation section. First of all, you need to determine the name of the competition, the order in which this competition will appear and the start and end dates. You can also determine at what time it will start and end in the box where you see the dates. If you do not set a custom time, the system time will be used by default. Once you’ve completed these, you must upload an image for the contest. After uploading the contest image, you will click on the “Next” button and you will be taken to the “Advanced Settings” section where you will determine the details of the contest. Here you must first select the competition type. Next, you should determine the visibility of this contest and details such as which users will participate in the contest. In the “Awards” section, you can determine the awards you will assign to the players as a result of the competition. You can personalize the rewards as you wish. In addition, when players click on the option to automatically distribute the reward, the system will automatically distribute the rewards as soon as the competition is completed. Congratulations, you have successfully created a new contest!

How do I edit a competition I created?

To organize a competition you have created, you must first click on the “Competitions” tab on the left side of the admin panel. In the Competitions list, you will see the edit icon to the right of the name of the competition you will organize. When you click on this icon, you will see the screen where you created the contest. Here you can organize the competitions as you wish.

How can I see the ranking of competing users?

To view the success ranking of users who have completed the competitions you have created, you must first click on the “Competitions” tab on the right side of the admin panel. There is a “leaderboard” icon to the right of the name of the relevant competition in the list. When you click on this icon, you will be able to view the success ranking of all users who completed your competition.

How do I disable or delete a created competition?

In order to update the status of the competition you created, you must click on the “Contests” tab on the right side of the admin panel. You can change the status of the competition at any time by clicking the “Active”, “Passive” or “Archived” button in the “Status” section to the left of the name of the relevant competition in the list. If you want to delete the contest completely, all you have to do is click on the “trash can” icon to the right of the contest name and delete the contest. Remember, deleted contests cannot be retrieved!

How can I create a new user?

There are three different ways to add users in Motivacraft. You can create a user manually, by using an invitation link or by sending an invitation. To add a new user, you must click on the “Users” tab on the left side of the administration panel. Here you can see all the users in the application and download the list of users as an Excel file by pressing the “Export” button. To add a user manually, you must press the “New user” button at the top right. This is the user creation screen. Here, after entering the user’s name, surname and e-mail address, you will create a username and password to use as login information. You can then assign a role to that user, connect them to one of your teammates, or add a tag to include them in any group you’ve created. You can also enter date of hire and date of resignation information here. After entering your Registration ID, you will complete the information. Finally, you can successfully create the new user by pressing the “save” button. As a second method, you can copy the invitation link in the upper right corner of the “Users” tab, send it to the person you want to invite, and help them register for the application. As the last method, you should press the “Send Invitation” button in the upper right corner of the “Users” tab. On the screen that appears, you must write the name, surname and e-mail address of the user you will invite. The user can register for the application from the link sent to his e-mail address. Congratulations, you have successfully created the new user!

How do I deactivate or delete a user?

In order to update the status of the user you created, you must click on the “Users” tab on the right side of the admin panel. Here you will see the list of all users. First of all, to change the user’s status, you must press the “dot” icon on the left side of the username. When you select the “active” option here, the icon will be green and the user will be included in the application. In the “Passive” state, the user will not be able to log in to the application and it will be disabled and the color of the icon will be red. If you want to delete the user completely, all you have to do is click on the “trash can” icon to the right of the username and delete the user. Remember, deleted users cannot be retrieved!

Can I change the information of an active user?

To edit a user you created, you must first click on the “Users” tab on the left side of the admin panel. Here you will see the list of users you created. In the user list, you will see the edit icon to the right of the name of the user you will edit. When you click on this icon, you will see the screen where you created a user manually. Here you can organize users as you wish.

How can I create a new article?

To create a new article, you must first click on the “Articles” tab on the left side of the admin panel. Before creating an article, you need to add an article category here. To do this, you must press the “+” button you will see on the screen. Here you can write the name of the article category and the order in which you want it to appear in the player panel. Then you should return to the “Articles” menu again. You can see all the articles he has created here. To add a new article, you must first select a category and then press the “New Article” button at the top right. This is the article creation section. First, you must write the article name and description. In the “Advanced Settings” section, you need to upload the article file and choose how long to give it to users. If you want, you can add a test at the end of this article. In the “Users & Awards” section, you must choose which users you will assign the article to and then choose the reward you will distribute. After pressing the “Submit” button, you can successfully create a new article. Congratulations!

How can I edit an article I created?

To organize a contest you have created, you must first click on the “Articles” tab on the left side of the admin panel. In the article list, you will see the edit icon to the right of the name of the article you will edit. When you click on this icon, you will see the screen where you created the article. Here you can edit the article as you wish.

How can I see users who have read the article?

To view the list of users who read the articles you created, you must first click on the “Articles” tab on the right side of the admin panel. There is an “eye” icon to the right of the name of the relevant article in the list. When you click on this icon, you will be able to view the list of all users who read the article you assigned.

How do I disable or delete a created article?

In order to update the status of the article you created, you must click on the “Articles” tab on the right side of the admin panel. You can change the status of the article at any time by clicking the “Active”, “Passive” or “Archived” button in the “Status” section to the left of the name of the relevant article in the list. If you want to delete the article completely, all you have to do is click on the “trash can” icon to the right of the article name and delete the article. Remember, deleted articles cannot be retrieved!

Motivacraft Mobile App Settings

https://vimeo.com/1069966982/7d406797c1?share=copy Learn more about settings in ...

Motivacraft Mobile App Reward Market

https://vimeo.com/1069955830/e5e4a559a9?share=copy Learn more about reward marke...

Motivacraft Mobile App My Profile

https://vimeo.com/1069946863/63c2bce8b9?share=copy Learn more about your profile...

Motivacraft Mobile App Your Story

https://vimeo.com/1069877756/3f9c985da3?share=copy Learn more about your story i...

Motivacraft Mobile App Manual Data Entry

https://vimeo.com/1069929212/4ec1056165?share=copy How to enter data manually us...

Motivacraft Mobile App Trainings

https://vimeo.com/1069888868/0bb082552f?share=copy Learn more about Motivacraft ...

How can i see missions and competitions in mobile app?

https://vimeo.com/1069877756/3f9c985da3?share=copy How to get details for the mi...

Motivacraft Mobile App Home Screen

https://vimeo.com/1069866069/6d878ffd57?share=copyWhat awaits you in the Motivac...

How competitions based on test results work?

This provides clarity on how our platform conducts competitions based on test an...

How can I use MotivacraftTV?

We will show you how to use MotivacraftTV step by step.We will show you how to u...

MotivacraftTV

Articles

Chat Icon Close Icon