Refiner Cloud Mode Integration

Send events to Refiner using RudderStack cloud mode.

RudderStack lets you send your event data to Refiner via cloud mode.

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

Identify

You can use the identify call to create or update a contact in Refiner.

A sample identify call is shown below:

rudderanalytics.identify("1hKOmRA4GRlm", {
  name: "Alex Keener",
  email: "alex@example.com"
})
warning
To make an identify call successfully, either the email or userId is required.

Supported mappings

The following table lists the RudderStack attributes and their mappings with the Refiner properties:

RudderStack propertyRefiner property
userId
Required, if email is absent.
id
properties.email
Required, if userId is absent.
email
traits
context.traits
traits

Track

The track call lets you capture user events and send them to Refiner as trackEvent events. If a track event contains a userId, then Refiner updates the corresponding user’s information. Otherwise, it creates a new user.

warning
Refiner does not store any additional properties sent with the track event.

A sample track call is shown below:

rudderanalytics.track("Order Completed", {
  orderId: "ORD122",
  price: "5.67",
  currency: "USD",
});

The following table lists the RudderStack properties and their mappings with the Refiner properties:

RudderStack propertyRefiner property
userIdid
event nameevent

Group

The group call lets you link an identified user with a group, such as a company, organization, or an account. Note that Refiner associates all group traits with the account object associated with the user.

A sample group call is shown below:

rudderanalytics.group("group@123", {
  name: "Sample Company",
  employees: 1000,
  industry: "Software",
})

The following table lists the RudderStack properties and their mappings with the Refiner properties:

RudderStack propertyRefiner property
userId
Required
id
traits.emailaccount.email
context.traits.emailemail
groupIdaccount.id
traitsaccount

Page

The page call lets you record your website’s page views with any additional relevant information about the viewed page and send this information to Refiner.

info
The behavior of the page call is the same as the call described above. However, note that if you do not set the event name, RudderStack sets pageView as the event name by default.

A sample page event is shown below:

rudderanalytics.page("Cart", "Cart Viewed", {
  path: "/cart",
  referrer: "samplewebsite.com",
  search: "some item",
  title: "New Item",
  url: "http://samplewebsite.in",
})

Questions? Contact us by email or on Slack