Segment

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

  1. Set up an Amazon Kinesis integration, as explained here.
  2. In your Segment account, set up a new Amazon Kinesis source. You will need the following details:
    1. AWS User access KEY ID
    2. AWS Kinesis Stream Regio: use “us-east-1”
    3. AWS user secret  access KEY
    4. AWS Stream kinesis name
  3. Click “Activate integration”

For more information on Segment’s integration with Amazon Kinesis see Segment’s documentation.

 

APIs

Cooladata supports the following Segment APIs:

  • Identify
  • Track
  • Page
  • Screen

For more information on the various Segment APIs see Segment’s documentation.

 

Event structure

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.

JSON Flattening:

When a Segment event contains a nested JSON, it will be flattened using the standard JSON format. For example:

{a:{b:”value”}}

 will be converted to

{a.b:"value"}

Thus, the property name of this key will be “a.b”.

 

Property Mapping

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 PropertyCooladata Property
user_idproperties_UserId
user_id
userId
anonymous_id
anonymousId
user_alternative_idanonymous_id
anonymousId
event_nameevent
type
event_server_time_tstimestamp
received_at
receivedAt
event_client_time_tssent_at
sentAt
session_ipcontext_ip
session_ip_countrycontext_locale
session_app_idcontext_app_name
session_brandcontext_device_name
session_modelcontext_device_model
session_os_versioncontext_os_version
session_oscontext_os_name
tracker_typecontext_library_name
tracker_versioncontext_library_version
utm_campaigncontext_campaign_name
utm_contentcontext_campaign_content
utm_mediumcontext_campaign_medium
utm_sourcecontext_campaign_source
utm_termcontext_campaign_term
session_duacontext_userAgent
Print Friendly, PDF & Email

Firebase

Firebase is Google’s mobile platform that helps you quickly develop high-quality apps and grow your business.

You can now integrate Firebase with Cooladata so that all the events generated by Analytics for Firebase will be sent as any other event to your Cooladata project.

To do so, you will need to link your Firebase app to BigQuery. Linking your Firebase app to BigQuery allows you to access your raw, unsampled event data along with all of your parameters and user properties.

Once you’ve linked your Firebase app to a BigQuery project, we will connect it to your Cooladata project. This will stream all your event data directly into your Cooladata project, where you can query, export or join your data with data from other platforms and data sources in your project, to perform custom analysis.

To set up a new Firebase integration, contact your Customer Success Manager or email us at support@cooladata.com.

Print Friendly, PDF & Email

Amazon Kinesis

Amazon Kinesis is a cloud-based service for real-time data streaming, able to process thousands of data streams per-second. It has some similarities in functionality to Apache Kafka.

Amazon Kinesis makes it easy to collect, process, and analyze real-time, streaming data so you can get timely insights and react quickly to new information. Integrating Amazon Kinesis allows you to stream event data in real time via Amazon Kinesis, in addition to or instead of using Cooladata’s SDKs or APIs.

If you already use Amazon Kinesis, you can use your existing service to integrate with Cooladata. If not, we can create one for you.

Using your own Amazon Kinesis account

  1. Contact your CSM or email us at support@cooladata.com to set up a new integration.
  2. Provide your CSM with the following details:
    • IAM User Access Key ID
    • IAM User AWS Secret Access Key
    • AWS Kinesis Stream Name
  3. Your CSM will provide you with the Cooladata service account details. In your AWS account, allow Cooladata read permissions on your Kinesis server.

Once done, all events sent to the Kinesis server defined will also be tracked by Cooladata, the same way as any event sent from the SDKs.

 

Setting up a new Amazon Kinesis account

  1. Contact your CSM or email us at support@cooladata.com to set up a new integration.
  2. We will create a new Kinesis server account for you and provide you with all the access information to it.

Once done, all events sent to the Kinesis server defined will also be tracked by Cooladata, the same way as any event sent from the SDKs.

Print Friendly, PDF & Email