Refiner Web Device Mode Integration
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"
})userIdis required to make anidentifycall successfully.
Supported mappings
The following table lists the RudderStack attributes and their mappings with the Refiner properties:
| RudderStack property | Refiner property |
|---|---|
userIdRequired | id |
properties.email | email |
context.traits | traits |
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 thetrackevent.
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 property | Refiner 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 property | Refiner property |
|---|---|
userIdRequired | id |
traits.email | account.email |
context.traits.email | email |
groupId | account.id |
traits | account |
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.
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",
})