RudderStack lets you send your event data to Refiner via the 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"
})
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.

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 the 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.

The behavior of the page call is the same as the track 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",
})

Contact us

For more information on the topics covered on this page, email us or start a conversation in our Slack community.

On this page