User.com is a popular marketing automation platform. It provides robust tools for the marketing, sales, management, and support teams to boost their brand value, enhance customer engagement, and increase conversions.

RudderStack supports User.com as a destination where you can seamlessly send your event data.

Getting started

Before configuring User.com as a destination in RudderStack, verify if the source platform is supported by User.com by referring to the table below:

Once you have confirmed that the source platform supports sending events to User.com, follow these steps:

1. From your RudderStack dashboard, add a source. Then, from the list of destinations, select User.com.
2. Assign a name to the destination and click Continue.

Connection settings

To successfully configure User.com as a destination, you will need to configure the following settings:

• Public REST API Key: Enter your public User.com REST API key.
• App Subdomain: Enter the subdomain of your User.com app.

• Map Rudder user attributes to User.com attributes: With this setting, you can map the RudderStack user attributes to specific User.com user attributes.
• Map RudderStack event name to User.com event name: Use this setting to map the RudderStack event names to specific User.com events. You can map one or more RudderStack events to a single User.com event but not vice-versa.
• Map your event property: Enter the RudderStack and User.com event properties you want to map for the above-mentioned event names. You can map a RudderStack property only to one User.com property and vice-versa.
• Map Rudder company attributes to User.com company attributes: Use this setting to map the RudderStack company attributes to specific User.com company attributes.

User lookup

RudderStack looks up a user in User.com using the user_key, email, or phone properties.

• You can pass the user_key in the externalId array, as shown:

Copy
"externalId": [{
  "type": "userKey",
  "id": "uehfuuiuednjk"
}],

• You can pass the email or phone in the integrations object, as shown:

Copy
integrations: {
user: {
  lookup: "email/phone"
}
});

The precedence order for looking up a user based on the above properties is:

• The userKey is given the highest priority.
• The lookup value is given the second highest priority. If phone/email (whichever is passed) is not found, RudderStack will throw an error.
• If none of the above is present, RudderStack falls back to the userId. If not found, RudderStack will throw an error.

Identify

You can use the identify call to create a new user in User.com. If the user already exists, RudderStack updates the user details.

A sample identify call is shown below:

Copy
rudderanalytics.identify('1hKOmRA4el9Zt1WSfVJIVo4GRlm', {
      firstName: 'Alex',
      lastName: 'Keener',
      email: "alex@example.com"
    }, {
      externalId: [{
        type: "userKey",
        id: "Df344sdFgdDsS4"
      }],
      integrations: {
        user: {
          lookup: "email"
        }
      }
    );

Property mapping

The following table lists the mappings between RudderStack and User.com properties for identify call:

Track

You can use the track call to record a new event which, in turn, can be used to filter and bucket users in User.com.

A sample track call is shown below:

Copy
rudderanalytics.track('Add to cart', {
  purchased_item: "T-Shirt",
  brand: "Zara",
  email: "alex@example.com"
}, {
  integrations: {
    user: {
      lookup: "email"
    }
  }
););

Property mapping

The following table lists the mappings between RudderStack and User.com properties for the track call:

Page

The page call lets you record your website's page views with any additional relevant information about the viewed page.

A sample page call is shown below:

Copy
rudderanalytics.page("section-name", {
      path: "path",
      url: "url",
      title: "title",
      search: "search",
      referrer: "referrer",
      phone: "1-202-555-0146",
    }, {
      integrations: {
        user: {
          lookup: "phone"
        }
      });

Property mapping

The following table lists the mappings between RudderStack and User.com properties for page call:

Group

You can use the group call to create or update a company profile and associate a user with it.

A sample group call is shown below:

Copy
rudderanalytics.group(
  "group01", {
    name: "Alex Keener",
    phone: "1-202-555-0146",
    size: 51,
    zipcode: 90009,
    street: "6649 N Blue Gum Street",
    city: "New Orleans",
    region: "Louisiana",
    country: "USA"
  },
);

Property mapping

The following table lists the mappings between RudderStack and User.com properties for the group call:

FAQ

Where can I find the User.com public REST API key?

To get your public REST API key, follow these steps:

1. Log into your User.com dashboard and go to your app.
2. Click Settings > App settings > Advanced > Public REST API keys.
3. Click Create API key, as shown:

Where can I find the User.com app subdomain?

To get your app subdomain, follow these steps:

1. Log into your User.com dashboard and go to your app.
2. Click Settings > Setup & Integrations to see the app domain. The subdomain is the part of the complete domain excluding .user.com, as shown: