Getting Data from Segment.io

This guide is intended to help you connect segment.io and Totango.

Segment.io is a customer data hub through which you can send your data from any device or platform. Segment.io translates and forwards it to your apps in a language they understand

Since Totango is all about identifying users, it is important to add a few API calls to your segment implementation with the exact information Totango needs. We’ll show you how.

Overview:

As part of the setup, remember that every page, track and identify call that you want to show up in Totango must be tied to a groupId (defined in Totango as the Account ID). This is done via the group call. You must include context.groupId in every call you want to be sent through to Totango so our system can link the groupId in a call made to Segment with the associated account in Totango.

For our client-side/front-end Javascript library (Analytics.js):

Sending Account data is done via the group call and pushes account attribute data to Totango.

Sending Usage data requires an identify and group call before sending the usage data to Totango via a track or page call. 

For server-side/back-end/session-less and mobile libraries:

You only need to call group or identify once per session as we will cache it and attach it to future calls to other methods for the same account. Please note that if the user and/or both the user and account change, you will need to update the userId and context.groupId via the identify and group calls again.

Sending Account data is done via the group call and pushes account attribute data to Totango.

Sending Usage data requires an identify and group call before sending the usage data to Totango via a track or page call. 

See code specific code examples below.

Activity Tracking - Front End Integration

analytics.identify([user ID], {

  email: [user email],
  //name is optional 
  name: [user name],
  }).group([account ID], {
     //account name is optional
     name: [account name],
     }).track([action],{
        category: [module]
        }).page(["__heartbeat"]);
}}();

Attribute Tracking

[app object].analytics.track({
  userId: [User identification],
  [Attribute name]: [Attribute value],
  context: {
     groupId: [Account identification]
  }
} 

analytics.track({
    userId: 'User ID',
    event: [action],
    properties: {
         "category": [module]
    },
    "context": {
      "groupId": 'Account ID',
      "traits": {
        //user attributes optional
        "email": "a@a.com",
        "age": 23
      }
});

 

In Segment, navigate to Integrations → Totango and, under options, enter your service ID for Totango. You can find your Service ID by clicking on your profile in the top right corner, you will see your Service ID at the very bottom.

Start using your application to trigger the usage data to be sent to Totango and monitor that in the Developer Console.

Before you start, please review Segment Documentation

FAQs

Q: Will Totango create new accounts or users for me?
A: Yes. If the Account does not exist in Totango (based on the Account ID), the HTTP API will create the Account and the user.