Refiner Device Mode Integration

Send events to Refiner using RudderStack web device mode.

  •   2 minute read  

RudderStack lets you send your event data to Refiner via device mode using the native web SDK.

Identify

You can use the identify call to create or update a contact in Refiner. RudderStack uses the identifyUser method to send this information to Refiner.

A sample identify call is shown below:

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

Supported mappings

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

RudderStack propertyRefiner property
userId
Required		id
properties.emailemail
context.traitstraits

Track

The track call lets you capture user events and send them to Refiner as trackEvent events.

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
event name
Required		event

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.

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