Skip to main content

Custom tracking tags

Tracking tags​

Bambuser tracks events to know how the shoppers interact with the players and widgets. By supplying custom tracking tags it is possible to include more information not known to Bambuser for tracking purposes.

Tracking tags are sent once at the beginning of the session via the on-configuration event when using player.configure(). They are not attached to all tracking events. Instead, the tags are sent once during initialization, and Bambuser's backend aggregation system stitches them together with the session data. This is the standard approach for session-level tagging, similar to how other analytics platforms handle session metadata.

Personally Identifiable Information (PII)

Avoid including PII data to make sure to follow GDPR. Doing so anyway may require updates to your terms of use.

The trackingTags should be an array containing key and value pairs.

Usage​

To set tracking tags, you can use the player.configure() method during player initialization:

player.configure({
  trackingTags: [{ key: 'memberId', value: '123-abc' }],
});

Restrictions​

  • No more than 20 tags are allowed. If more are supplied the first valid 20 are passed on
  • Duplicate tracking tag keys are not allowed. If set the last one in the list will be used
  • Allowed value types are String, Number and Boolean
  • Values should be no bigger than 1KB