User Identifier and Property

Properties

Hackle SDK supports adding properties to a User object.

  • Properties must be sent as a pair with both property name (key) and a property value (value).
  • The maximum number of properties that can be added to a User object is 64.

Property Key (Name)

  • The key should be set as a general name, but easily identifiable.
  • The character limit is 64 characters.
  • It is not case sensitive. For example, AGE and age are recognized as the same key.

Property Value

  • The value supports boolean, string, and number types.
  • In the case of string type, the character limit is 64 characters.
  • In the case of number type, up to 15 integers and up to 6 decimal places are supported.

Example

User objects are used as parameters in distributing traffic into test groups, determining feature flags, and sending user events.

Refer to the example code and add the desired properties to each user. In the example below, you can see that three properties (age, grade, is_paying_user) have been added.

hackleClient.onReady(function() {
  const user = { id: "ae2182e0" };

  // Traffic distribution
  hackleClient.variation(experimentKey, user);

  // Send user events 
  hackleClient.track("purchase", user);
});

Additional Identifiers

In addition to the default identifier, additional identifiers can be sent through the example code below.

const user = {
  id: "ae2182e0", // Default identifier provided
  userId: "143", // User ID (Hackle integrated identifier supported)
  deviceId: "ae2182e0", // Device ID (Hackle integrated identifier supported)
  identifiers: {
    myCustomId: "42" // Custom ID
  }
}

Property

Hackle SDK supports adding properties to a User object.

  • Properties must be sent as a pair with both property name (key) and a property value (value).
  • The maximum number of properties that can be added to a User object is 64.

Property Key (Name)

  • The key should be set as a general name, but easily identifiable.
  • The character limit is 64 characters.
  • It is not case sensitive. For example, AGE and age are recognized as the same key.

Property Value

  • The value supports boolean, string, and number types.
  • In the case of string type, the character limit is 64 characters.
  • The string type is case-sensitive. For example, APPLE and apple are recognized as different property values.
  • In the case of number type, up to 15 integers and up to 6 decimal places are supported.

Example

User objects are used as parameters in distributing traffic into test groups, determining feature flags, and sending user events.

Refer to the example code and add the desired properties to each user. In the example below, you can see that three properties (age, grade, is_paying_user) have been added.

const user = {
  id: "ae2182e0",
  properties: {
    age: 30,
    grade: "GOLD",
    is_paying_user: false
  }
}

// Traffic distribution
hackleClient.onReady(function() {
  const variation = hackleClient.variation(experimentKey, user);
});

// Feature flag determination
hackleClient.onReady(function() {
  const featureOn = hackleClient.isFeatureOn(featureKey, user);
});

// Send user events
hackleClient.onReady(function() {
  hackleClient.track({ key: "purchase" }, user);
});