User.com

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.

Find the open source code for this destination in this GitHub repository.

Connection compatibility

Destination info
Status: Generally Available Supported sources: Android, iOS , Web, Unity, AMP , Cloud, Warehouse, React Native , Flutter, Cordova, Shopify Refer to it as USER in the Integrations object.

Connection modes
Source	Cloud mode	Device mode	Hybrid mode
AMP
Android
Cloud
Cordova
Flutter
iOS
React Native
Shopify
Unity
Warehouse
Web

Supported message types
Source	Identify	Page	Track	Screen	Group	Alias
Cloud mode
Supported sources

Get started

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 set up 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.

For more information on obtaining the public REST API key and app subdomain, see the FAQ section below.

• 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

This functionality is applicable only for the identify, track, and page calls.

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

• You can pass the userKey in the externalId array:

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

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

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

You must pass only one of email or phone in lookup. Also, email or phone (whichever is passed) must have unique values in User.com.

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:

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

Traits 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:

rudderanalytics.track('Add to cart', {
  purchased_item: "T-Shirt",
  brand: "Zara",
  email: "alex@example.com"
}, {
  integrations: {
    User.com: {
      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:

rudderanalytics.page("section-name", {
      path: "path",
      url: "url",
      title: "title",
      search: "search",
      referrer: "referrer",
      phone: "1-202-555-0146",
    }, {
      integrations: {
        User.com: {
          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:

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:

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:

Questions? Contact us by email or on Slack