Countly Destination
Our Countly destination code is open source on GitHub. Feel free to check it out: iOS, Android.
Getting Started
To get started with Countly and Segment, you’ll want to first integrate your mobile app with our iOS or Android sources.
Once the Segment library is integrated with your app, toggle Countly on in your Segment destinations catalog, and add your application’s App Key and Server URL which you can find in your Countly Application Management. If you’re using their cloud hosted solution (not hosting your own Count.ly server), then your Server URL is https://cloud.count.ly
.
These new settings will take up to an hour to propogate to all of your existing users. For new users it’ll be instanteneous!
Track
Countly is built to help you better understand your user’s behavior. To accomplish that, you’ll want to track
your user’s actions in detail.
Whenever you call track
from our iOS or Android library, we’ll record an event with Countly. track
takes the name of the event and any optional properties
you want to associate with the event.
Custom Events
All you have to do is make a track
call to send a custom event to Countly. The event name will map to the countly “key” and we automatically set “count” to 1. If you add properties to the event those will be passed to Countly as well.
Revenue
It’s easy to track revenue in Countly through Segment. All you have to do is use our track
method with a property labeled revenue
. The value must be a number.
Supported Sources and Connection Modes
Before you start, make sure Countly supports the source type and connection mode you’ve chosen to implement. You can learn more about connection modes here.
Web | Mobile | Server | |
---|---|---|---|
📱 Device-mode | ✅ | ||
☁️ Cloud-mode |
This destination requires that you use a Device-based Connection Mode for Mobile data. Make sure you package the Countly mobile SDK with the Segment mobile library.
Settings
Segment lets you change these destination settings from the Segment app without having to touch any code.
App Key
You can find your App Key on your Countly server. It should be 40 characters long, and look something like this: c801156663bfcc4694aafc0dd26023a6d9b9544a
.
Server URL
You’ll need to add your own Countly Server URL here.
This page was last modified: 18 Sep 2020
Need support?
Questions? Problems? Need more info? Contact us, and we can help!