Singular's integration with Segment is based on a server-to-server implementation. To integrate with Segment you may follow the steps below:
Getting Started
- From your Segment UI's Destinations page click on "Add Destination".
- Search for "Singular" within the Destinations Catalog and confirm the Source you'd like to connect to.
- Add your Singular "API KEY", found in your Singular Dashboard under 'Settings' > 'SDK Keys', to the Segment Settings UI.
What's supported
- Install Attribution
- Apple Search Ads Attribution
- Custom Event Tracking
- Revenue tracking
- Custom User ID
- "Install Attributed" Postback to Segment (Requires Singular SDK)
Install Attribution
Enable automatic tracking of lifecycle events (Application Opened, Application Installed, Application Updated) via initialization config parameters (iOS, Android) to track installs and sessions in Singular. The Singular “session” will be sent automatically by the integration as long as you are including the events above.
Apple Search Ads Attribution
To get iAD attribution data into Singular, you must include the analytics-ios-iads-attribution dependency and version 3.6.0 or higher of the Analytics SDK.
To install it, simply add the following line to your Podfile:
pod "Analytics"
pod "Analytics-iAds-Attribution"
Then import the header and initialize the configuration:
iOS (Obj-C):
#import <Analytics-iAds-Attribution/SEGADTracker.h>
// Initialize the configuration as you would normally.
SEGAnalyticsConfiguration *configuration = [SEGAnalyticsConfiguration configurationWithWriteKey:@"YOUR_WRITE_KEY"];
...
// Configure the client with the iAD middleware to attach iAd properties.
configuration.middlewares = @[ [SEGADTracker middleware] ];
[SEGAnalytics setupWithConfiguration:configuration];
iOS (Swift):
import Analytics-iAds-Attribution
// Initialize the configuration as you would normally.
var configuration = SEGAnalyticsConfiguration(writeKey: "WriteKey")
...
// Configure the client with the iAD middleware to attach iAd properties.
configuration.middlewares = [SEGADTracker.middleware()]
SEGAnalytics.setup(with: configuration)
When iAd information is available, the attribution information is transformed to Segment context this way:
[analytics track:@"Application Installed",
properties: nil,
options: @{
@"context" : @{
@"campaign" : @{
@"provider" : @"Apple",
@"click_date" : attributionInfo[@"iad-click-date"],
@"conversion_date" : attributionInfo[@"iad-conversion-date"],
@"source" : @"iAd",
@"name" : attributionInfo[@"iad-campaign-name"],
@"content" : attributionInfo[@"iad-keyword"],
@"ad_creative" : attributionInfo[@"iad-org-name"],
@"ad_group" : attributionInfo[@"iad-adgroup-name"],
@"id" : attributionInfo[@"iad-campaign-id"],
@"ad_group_id" : attributionInfo[@"iad-adgroup-id"]
}
}
}];
Singular has explicitly mapped the Application Installed lifecycle event to provide the iAd Information.
Tracking Custom Events
If you haven't had a chance to review our spec, take a look to understand what the Track method does. An example call (in Android) would look like:
Analytics.with(context).track("Signup")
Analytics.with(context).track("Level9Passed")
Those calls will be sent to Singular and processed as custom post-install events and will be available in reporting & user-level exports.
Revenue Tracking
Singular will receive revenue tracking when an event containing the revenue property is sent (including zero value). You can optionally pass the currency (as an iso3 code). The default currency is USD.
For example in Android you would do:
Analytics.with(context).track("Order Completed", new Properties().putRevenue(1.99));
Custom User ID
Singular has mapped the Custom User ID to the Segment User ID value. Follow the steps here to configure for: iOS, Android.
Enabling the "Install Attributed" Segment Event
Analytics.with(context).getAnalyticsContext().traits().anonymousId()
Example SDK Event to be sent immediately after Singular Initialization:
Be sure to pass in the appropriate value for the `userId` and `anonymousId`.
iOS (Objective-C):
NSString *userId = @"myUserId";
NSString *anonymousId = [[SEGAnalytics sharedAnalytics] getAnonymousId];
[Singular eventWithArgs:@"Install Attributed",
@"s_user_id",userId,
@"s_anonymous_id",anonymousId, nil];
iOS (Swift):
let userId = "myUserId"
let anonymousId = SEGAnalytics.shared().getAnonymousId()
Singular.event("Install Attributed", withArgs: ["s_user_id":userId,
"s_anonymous_id":anonymousId])
Android (Java):
String userId = new String("myUserID");
String anonymousId = Analytics.with(context).getAnalyticsContext().traits().anonymousId();
Singular.event("Install Attributed", "s_user_id",userId,
"s_anonymous_id",anonymousId);
Once Singular starts receiving the "Install Attributed" Event, you may enable the Event in the Singular UI Partner Configuration screen under Segment: