Skip to main content

Activities

Activities are used to track how the user is interacting with the engagement strategy. All the mechanics you've configured in Mambo are triggered by tracking activities. Activities are most commonly tracked through integrations that use the Activities APIs but can also be tracked manually using the User management or the Simulator pages.

There are different types of activities that you can track. Below is a brief summary of each.

  • Behaviour: activity used to track the behaviours your users are performing
  • Point: activity used to manually change a user's points
  • Coupon: activity used to redeem or refund a coupon for a user
  • Gift: activity used to allow one user to send a gift to another user
  • KPI: activity used to indicate that there have been updates to a user's KPI state
  • Bounty: activity used to allow a user to offer points to encourage another user to take action
Note

Activities will only be tracked for users who are members of the engagement strategy.

Important shared fields​

There are a number of fields for activities which are shared amongst the different types:

  • URL: this indicates the URL on which the activity took place. Note that this field accepts any value, so you can use abbreviations or keywords. For example, dashboard, profile_page, and so on.
  • Reason: the reason why the user is having their state altered. This field could be populated automatically by your system, or it could contain text that the users type. For example, if a user is sending a gift to another or if a user is creating a bounty, this could contain the reason for those activities.
  • Created On Override: when an activity is created, the time stamp used will be the time at which the activity is created in the system. If you wish to track activities with a past or future date then you can use this field to override the default created on date. Note that this will not change the order in which the activities are processed, which is not guaranteed.
  • Content: when a user performs an activity, the content represents what the activity took place on. For example, if the user completes a training course, we can use the content to represent the course information and then link to it from the Activity Stream widget and the user's Summary page. If the user makes a sale, we can use the content to represent the product or customer to which the sale was made.
  • Target: when a user performs an activity, the target represents the target or area in which the content of the activity can be found. For example, if the user completes a training course and it's a Sales course, then the target could be used to link to the Sales training module.
  • Tags: this allows you to associate a tag to an activity. Tags can be used to filter the activities you retrieve through the APIs.