Back to Docs

RudderStack

On This Page

Adding a RudderStack Integration in Variance

RudderStack is a great way to get your customer data into Variance. Hooking up RudderStack is easy. To start, head to the Integrations > RudderStack page in Variance.

You'll find the integrations section under your company name in the top nav

Then you'll Add a RudderStack Connection. You can describe it in any way you want, but we suggest using the name of the RudderStack source you're going to be piping from. We recommend you use one connection per source, as you can then filter by source, but it's up to you.


Name your source and (only the first time) tell us how you identify the company

On the first time you connect a RudderStack integration we ask for a little bit of additional information about you how link users with their companies in your RudderStack data. We support whatever way you currently manage things:

  1. Use `group` call: if you already use `group` to indicate the account, then you don’t need to fill in anything. We will extract the  Account automatically, and you’re good to go.
  2. Use `identify` call with custom traits (ex. `company.id` and `company.name`): choose this option if you include some information about the Account/Company/Organization as a trait in each `identify` call. When you choose this option you'll need to let us know the name of the trait you use. For instance, if you do something like `{'company':{'id':1,'name':'Awesome Company'}}` you could add `company.id` as the Account ID trait and `company.name` as the Account Name trait.
  3. (Fallback) Use domain from the `email` trait of the `identify` call: if you don't use either of the methods above, we can extract the domain from the `email` trait and use that as the Account name.

If you have any questions at all, please reach out and we're happy to hop on a Zoom and help you get set up.

Connecting Variance in Rudderstack

Once you've added your RudderStack integration, you'll see two pieces of data:

  1. Webhook URL
  2. Authorization Header Value
Hooking up RudderStack is a breeze

Now head over to RudderStack, choose the Source you are piping data from and then click Add Destination.

There's the handy Add Destination button

From there you'll scroll down and choose the Variance destination and then click Next.

Just Click Variance and you're good to go.

Then you'll name your destination. This really only matters for keeping things organized in RudderStack. You could call it ... Variance.

Give your Variance destination a name

If you choose on the next page you can also send more Sources to Variance. It's up to you.

Finally, you'll arrive at the Connection Settings page. This is where we're going to add the Webhook URL and the Authorization Header Value that we gave you on the Integrations page. Just copy them into the fields below.

Two values and you're all set

After that you'll choose whether to apply a transformation (that's up to you) and you're all set.

If you want to check the status, just create some events in the source and they should flow through RudderStack to Variance. If you have any problems let us know.

Grabbing Your Identify Structure

If you aren't sure what properties you're using for identifying accounts, it's easy to go into the RudderStack live events view to to find the payload of a recent `identify` call.

  1. Find the Source you want to connect to Variance
  2. Click into the Live events view with the button in the top right
  3. Log into your app to trigger an `identify` call
  4. Open the `identify` call and copy the source

It should look something like this:

Easy to find your identify payload
Last Updated: 
August 18, 2021