Segment - How to send MadKudu data to Segment?

You've built your models and segmentation with MadKudu and now want to receive the scores in Segment? Just follow the steps below. 

You already have a Segment source to collect MadKudu scores

  1. Log in to Segment (app.segment.com)

  2. Go to the source you want to send your MadKudu data to. 

  3. Inside this project, click on Settings, then to the API Keys section and copy the Write Key. (See Segment instructions to locate your API key)

  4. Login to MadKudu app.madkudu.com

  5. Go to Integrations

  6. Click on Segment

  7. Go to the Push page

  8. Paste the Write Key


  9. Click Save

  10. Head to Settings > Push to define which data models to start pushing to Segment. Learn more here about how to push MadKudu Intelligence to your integrations


    When the setup is completed you should see the fields MadKudu pushes to Segment like this: mceclip8.png

 

You want to create a new Segment source to collect MadKudu scores

  1. Log in to Segment (app.segment.com)

  2. Create a Node.js source and name it as you like. 

  3. Inside the new source, click on Settings, then to the API Keys section, and copy the Write Key. (See Segment instructions to locate your API key)

  4. Login to MadKudu app.madkudu.com

  5. Go to Integrations

  6. Click on Segment

  7. Go to the Push page

  8. Paste the Write Keymceclip5.png

  9. Click Save

  10. Head to Settings > Push to define which data models to start pushing to Segment. Learn more here about how to push MadKudu Intelligence to your integrations.
    When the setup is complete you should see the fields MadKudu pushes to Segment like this: 

 

What data is sent from MadKudu to Segment?

MadKudu sends data to Segment via the Segment Identify method:

{
  "type": "identify",
  "userId": "97980cfea0067",
  "traits": {
    "email": "paul@madkudu.com",
    "mk_customer_fit_segment": "medium",
    "mk_likelihood_to_buy_segment": "high",
    "mk_likelihood_to_buy_score": "72",
    "mk_job_title": "CTO",
    "mk_country": "United States",
  ...
  }
}

Note that

  • the native integration between MadKudu to Segment supports "identify" calls only.

  • only users active in the last 30 days will be scored to avoid increasing your Segment bill

For more about the MadKudu fields being sent to Segment, please consult this article.