Activity tracking

This section explains how to create activities directly from the browser using the JavaScript SDK.

Creating activities

The JavaScript SDK allows you to track user activities directly from the client side. All activity types described in the Activities API can be created through the SDK if enabled in your security settings.

Behaviours configured with "JS Tracking" enabled can be tracked directly from the browser. When configuring these behaviours, it's important to set a reasonable "cool off" period to prevent potential abuse.

Security warning

Creating activities via JavaScript is not recommended for production environments. This approach is vulnerable to manipulation by technically skilled users. For secure implementations, use the server-side SDKs and the ActivitiesService instead.

When creating activities through the JavaScript SDK:

• If successful, widgets automatically update to show new points or rewards, and notifications appear for unlocked rewards
• If unsuccessful, error messages are logged to the browser console

Here's how to create activities:

JavaScript

// Initialise the Mambo Callbacks array
var mamboCallbacks = window.mamboCallbacks || [];
mamboCallbacks.push(function() {

  // The SDK allows for a special case which is that of creating behaviour activities by
  // specifying only the verb of the behaviour being tracked. This is the most frequent activity
  // which is why this handy shortcut is provided. 
  Mambo.createActivity('purchase');

  // This is how to create a behaviour activity with verb, metadata and content objects
  // See the Activities API for more information about each parameter.
  var data = {
    attrs: {
      type: 'behaviour',
      verb: 'purchase',
      // Alternative to verb is using the behaviourId field
      // behaviourId: '5782eb30d685a8050e3da089',
      metadata: {
        brand: 'Sony',
        category: ['Laptop', 'TV']
      }
    },
    content: {
      id: 'sony_vaio_z837',
      title: 'Sony Vaio Z837',
      description: 'Sony Vaio Z837 is a beautiful machine.',
      type: 'Product',
      imageUrl: 'http://www.domain.com/sony_vaio.png',
      url: 'http://www.domain.com/sony_vaio_z837'
    },
    target: {
      id: 'store_id_657',
      title: 'Sony Store Downtown Chicago',
      description: 'Sony Store, 245 Michigan Avenue, 82742-984, United States',
      type: 'Location',
      imageUrl: 'http://www.domain.com/storefront.png',
      url: 'http://www.domain.com/store_id_657'
    }
  };

  Mambo.createActivity(data);
});

Activity data structure

The SDK supports creating various activity types. For a simple behaviour activity, you can just pass the verb:

JavaScript

Mambo.createActivity('purchase');

For a detailed explanation of each activity type and its properties, see the Activities API documentation.

Bounty management

The SDK also provides methods to manage bounties:

Awarding bounties

JavaScript

// Award a bounty to a specific user
Mambo.awardBounty('activity-id-123', 'user-uuid-456');

Cancelling bounties

JavaScript

// Cancel a previously created bounty
Mambo.cancelBounty('activity-id-123');

These operations trigger the respective events (mambo.activity.award_bounty and mambo.activity.cancel_bounty), which you can listen for to perform additional actions.