Loyalty (GM) is the Gigya platform for social interaction and rewards that can be used for gamification, for collecting user data and behavioral data, increasing site engagement and making user experience more enjoyable. Loyalty is highly flexible. You can use it as a straightforward gamification platform, based on Gigya's out-of-the-box configurations, or customize it to count and track any user actions in your site or app. Then use Game Mechanics Reports to analyze these interactions. 



This guide takes you through the steps of integrating GM into your site:

  1. Use Loyalty in one of the following ways:
  2. Get familiar with Loyalty terminology.
  3. Learn about Overall Rank, Gigya's default challenge.
  4. Set up and configure your Loyalty platform.
  5. Go through our best practice checklist.
  6. Get statistics through GM reports.
  7. Understand GM points, and how to redeem them.

Using Loyalty

There are two ways to use Gigya Loyalty:

Incorporating Loyalty Add-Ons

Gigya's Loyalty (GM) add-ons are customizable pre-built Web GUI elements that can be used to display Loyalty information, such as the user's current points, the current achieved level, the number of points needed to achieve the next level, the highest ranking users, etc. The add-ons are easy to implement, and the process involves only adding a few lines of code using the Web SDK. For details of implementing one of the add-ons, go to its relevant page:

In the Loyalty add-ons demo you will find a complete working example of a web-page that uses all five add-ons. You may review the code, run it and view the outcome.

For more details, refer to the Loyalty Add-Ons guide.


In addition to the Loyalty (GM) Web SDK, you can use the server side (REST) API, or use a suitable Server Side SDK that provides a wrapper for the REST API.

Please pay special attention to the following GM API methods:


Gigya's Loyalty platform (GM) uses specific terminology throughout the documentation, site administration, and user interfaces. In order to implement Gigya's Loyalty more easily, familiarize yourself with these commonly used terms:

To summarize: once you integrate Loyalty,  your site will have challenges in which users can participate. The challenges have defined levels, and each level has a badge associated with it. Users on your site will be able to perform predefined actions or simply-defined new actions, and receive virtual rewards such as points for these actions. 

Overall Rank

Overall Rank is the Loyalty default challenge. Overall Rank encourages site engagement through rewards and increases user activity and loyalty. 

The Overall Rank challenge has all enabled actions associated with it, including newly defined actions and default Gigya actions. These actions are all initiated by Gigya's Engagement Add-Ons or APIs; Gigya tracks the enabled actions and rewards users with points, the site does not need to report them. To view all predefined Gigya actions, all of which belong to this challenge, refer to the Default Gigya Actions section of the Gigya Console.

You may define new actions, and any new actions you define are automatically associated with the Overall Rank challenge. These custom user actions are not tracked by Gigya, and your site must report them to Gigya.

Overall Rank has four defined levels; the titles of the levels are Beginner, Enthusiast, Expert, and Master. Each level can be reached by users who perform social actions and accumulate the specified number of points that the level requires. Each level of the challenge also has a badge to represent it.

To view all levels that belong to this challenge, refer to the Levels section of the Challenge Settings page in the Gigya Console.

Many of the Overall Rank challenge properties are customizable; you can add or remove levels, and redefine each level's title, description, badges, and threshold. The default Gigya actions cannot be removed, but the following properties of each action can be changed: name, description, points value, daily cap, minimal Interval, and status.

When you integrate Gigya's Loyalty platform, we recommend you use the Overall Rank challenge, as well as defining new challenges that are suited to your site needs.

Setting up Your GM Console

Your Loyalty console can include just the Overall Rank challenge, which is configured and ready to use, but we recommend adding more challenges to your site, specific to your users' needs.

This section takes you briefly through the steps of adding a new challenge. For detailed information see Loyalty Configuration and AdministrationLoyalty Add-Ons and the Loyalty Quick Start Guide

  1. Go to the Game Mechanics Setup section of Gigya's website. 
  2. Press the Add new challenge  button. Fill in a unique challenge ID and a challenge title, and press Save. The new challenge is now added to the challenges table.
  3. Press the Challenge Settings button to open the Challenge Settings page, which is divided into three sections: 'Configuration', 'Actions', and 'Levels'.
  4. In the 'Configuration' section: Add a description of the new challenge (optional).
  5. In the 'Actions' section: Select the actions you want to associate with your challenge. You must select at least one.
  6. In the 'Levels' section: Add at least one level to your new challenge:
    1. Press the Add new level button in the Levels table in order to open a blank new level form.
    2. Fill in the fields. You need to define at least one of the thresholds (action or points). Press Apply
  7. Return to the 'Configuration' section on the page and change the Status to Enabled .
  8. Press Save Settings

The actions you added to your new challenge were selected from the predefined default Gigya actions, but you can define new custom user actions and add them to your new challenge. 

Best Practice Checklist

The following checklist summarizes the best practices for implementing Gigya's Game Mechanics platform:

GM Reports

Gigya’s cross-platform analytics deliver interaction and traffic data, including details by challenge and activities. Gigya’s graphic reports are available on Gigya's website under the Reports tab (please make sure you are logged in).

The available GM reports are:

For detailed explanations, see Game Mechanics Reports.

Loyalty Points

Loyalty points are appointed to users when they perform an action on your site. These actions for which your users earn points can be either Default Gigya Actions or Custom user actions. A user can accumulate points to earn virtual rewards, such as levels and badges.

In addition, you are allowed to give Custom user actions negative point values, and every time a user performs an action that has a negative point value, the points will be deducted from the user's points. The only limitation is that the user cannot have accumulated points that are less than zero. 

The Loyalty engine accumulates points in three different manners:

Redeeming Points

You can redeem points by using the gm.redeemPoints method. This method deducts a specified number of points from a specified user in a specified challenge. The points are redeemed only if the number of points to redeem isn't higher than the number of current available points, in which case the operation will fail.

Another way to redeem points is by using  the  Loyalty Achievements section of the  Identity Access  tool.

Manually Granting Points to Challenges

You can manually grant points to specified challenges by using the gm.notifyAction API method. Call the method with an action called _points , then in the points parameter specify the number of points you want to award the challenges, and in the challengeIDs enter the challenge IDs of all the challenges to which you want to grant these points. You can also use this method to reduce points, by awarding negative points to the challenge.

Another way to manually add or reduce points to challenges is by using the Loyalty Achievements section of the Identity Access tool.

Loyalty platform is the Gigya gamification platform for social interaction and rewards that can be used for collecting user data and behavioral data, increasing site engagement and making user experience more enjoyable.