Setup Guide

This guide will help you set up Refiner as a destination in the RudderStack dashboard. It also lists the configuration settings required to correctly send data from the supported sources to Refiner.

Connection compatibility

Destination Information
Status: Generally Available Supported sources: Web, Cloud, Android (Java) , Android (Kotlin) , iOS (Obj-C) , iOS (Swift) , Unity, AMP , Warehouse, React Native , Flutter, Cordova, Shopify Refer to it as Refiner in the Integrations object.

Connection Modes
Source	Cloud mode	Device mode	Hybrid mode
AMP
Android (Java)
Android (Kotlin)
Cloud
Cordova
Flutter
iOS (Obj-C)
iOS (Swift)
React Native
Shopify
Unity
Warehouse
Web

Supported Message Types
Source	Identify	Page	Track	Screen	Group	Alias	Record	AudienceList
Cloud mode
Supported sources
Device mode
Web

Get started

Once you have confirmed that the source platform supports sending events to Refiner, follow these steps:

1. From your RudderStack dashboard, add the source. Then, from the list of destinations, select Refiner.
2. Assign a name to your destination and click Continue.

Connection settings

To successfully set up Refiner as a destination, you need to configure the following settings:

• Refiner REST API Key: Enter your Refiner REST API key.
• Refiner Web Client API Key: Enter your web client API key.

For more information on obtaining the Refiner REST API key and web client API key, refer to the FAQ section below.

• Map Rudder user attributes to Refiner contact traits: Use this setting to map specific properties from the RudderStack event to Refiner’s contact traits.
• Map Rudder account attributes to Refiner account traits: Use this setting to map specific properties from the RudderStack event to Refiner’s account traits.
• Client-side Events Filtering: This setting lets you specify which events should be blocked or allowed to flow through to Refiner. For more information on this setting, refer to the Client-side Events Filtering guide.
• Use device mode to send events: Enable this setting to send your events to Refiner via web device mode.
• Consent management settings: Configure the consent management settings for the specified source by choosing the Consent management provider from the dropdown and entering the relevant consent category IDs. See Consent Management in RudderStack for more information on this feature.

FAQ

Where can I find the Refiner REST API key and web client API key?

To get your Refiner REST API key and web client API key, follow these steps:

1. Log into your Refiner dashboard.
2. From the left sidebar, click the Integrations icon and go to REST API. You will find the REST API Key listed here under Secret API Key:

3. To get your Refiner web client API key, click the Settings icon from the left sidebar and go to Web Client. You will find the API key listed here: