Segment is the single platform that collects, translates, and routes your user data to hundreds of analytics & marketing tools with the flip of a switch. By integrating Segment with Cooladata you can track events using the Segment APIs from any source and save them to your Cooladata project, in addition to or instead of using Cooladata’s SDKs or APIs.
Segment integration with Cooladata works via Amazon Kinesis. Integrating Segment with Cooladata allows you to stream event data via Amazon Kinesis in addition to, or instead of using Cooladata’s SDKs or APIs.
Settings up a Segment integration
- Set up an Amazon Kinesis integration, as explained here.
- In your Segment account, set up a new Amazon Kinesis source. You will need the following details:
- AWS User access KEY ID
- AWS Kinesis Stream Regio: use “us-east-1”
- AWS user secret access KEY
- AWS Stream kinesis name
- Click “Activate integration”
For more information on Segment’s integration with Amazon Kinesis see Segment’s documentation.
Cooladata supports the following Segment APIs:
For more information on the various Segment APIs see Segment’s documentation.
Segment events are slightly different from Cooladata events. Segment events use nested JSON, and have different property names than Cooladata. When integration Segment and Cooladata, Cooladata flattens these event Segment property names are mapped to Cooladata properties.
When a Segment event contains a nested JSON, it will be flattened using the standard JSON format. For example:
will be converted to
Thus, the property name of this key will be “a.b”.
Segment property names are mapped to Cooladata properties according to the following table. Where more than one Segment property can apply, the priority matches the order in the table.
|Segment Property||Cooladata Property|