Add Singular as a Destination

To begin, set up a Singular destination in your Segment dashboard. You will need the Singular SDK Key and SDK Secret (you can retrieve them by logging into your Singular account and going to Developer Tools > SDK Keys).

Add the SDK to your Project

1. Add AdServices.framework in Link Binary With Libraries and mark it as Optional (only available for devices with iOS 14.3 and higher). This is needed to support Apple Search Ads attribution.

2. Add the Singular Segment integration pod to your app's podfile as follows:

   pod ‘Segment-Singular’

3. Import the Singular Library in your file:

   #import "SingularIntegrationFactory.h"

Add Code to Initialize the Singular SDK

SEGAnalyticsConfiguration *configuration = 
[SEGAnalyticsConfiguration configurationWithWriteKey:@”<SEGMENT_WRITE_KEY>”];

configuration use:[SingularIntegrationFactory instance]];
configuration.trackApplicationLifecycleEvents = YES;
configuration.recordScreenViews = YES;

[SEGAnalytics setupWithConfiguration:configuration];

let configuration = AnalyticsConfiguration(writeKey: "<SEGMENT_WRITE_KEY>")
configuration.trackApplicationLifecycleEvents = true // Enable this to record certain application events automatically!
configuration.recordScreenViews = true // Enable this to record screen views automatically!
// Add any of your Device-mode destinations.
configuration.use(SingularIntegrationFactory.instance())
Analytics.setup(with: configuration)

[OPTIONAL] Implement Event Tracking

Use the Segment track function to have events translated and sent to Singular:

[[SEGAnalytics sharedAnalytics] track:@"simple event"];

Segment includes all the event properties as callback parameters on the Singular event, and automatically translates properties.revenue to the appropriate Singular purchase event properties.

Purchase event example:

[[SEGAnalytics sharedAnalytics] track:@"segment revenue event" properties:@{@"currency": @"USD", @"revenue":@20}];

[OPTIONAL] Implement User Identification

The Singular SDK can send a user ID from your app to Singular. This can be a username, email address, randomly generated string, or whichever identifier you use as a user ID.

Singular uses the user ID in user-level data exports as well as internal BI postbacks (if you configure such postbacks).

To set user identification, call the identify method:

[[SEGAnalytics sharedAnalytics] identify:@"segment custom user id"];

To unset the user ID, call the ​reset​ method:

[[SEGAnalytics sharedAnalytics] reset];

[OPTIONAL] Implement SKAN support

The Singular SDK can control your SKAdnetwork integration. For details on how this works, see iOS SDK: Adding SKAdNetwork Support.

To let Singular control your SKAdNetwork integration, add the following code before the initialization of the Segment SDK:

[SingularIntegation setSKANOptions:YES
  isManualSkanConversionManagementMode: NO
  withWaitForTrackingAuthorizationWithTimeoutInterval:@0
  withConversionValueUpdatedHandler:^(NSInteger conversionValue) {
      NSLog(@"Your SKAN handler %ld",conversionValue);
  }];

SingularIntegation.setSKANOptions(
      true,
      isManualSkanConversionManagementMode: false,
      withWaitForTrackingAuthorizationWithTimeoutInterval: NSNumber(value: 0),
      withConversionValueUpdatedHandler: { conversionValue in
          print(String(format: "Your SKAN handler %ld", conversionValue))
      })

Add Singular as a Destination

To begin, set up a Singular destination in your Segment dashboard. You will need the Singular SDK Key and SDK Secret (to retrieve them, log into your Singular account and go to Developer Tools > SDK Keys).

Add the Plugin to Your Project

Add the Singular Segment integration dependency to your app's build.gradle file:

compile'net.singular.segment.integration:singular_segment_sdk:+'

Add the Required Permissions

The AndroidManifest.xml file should include the following permissions:

<uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
    <uses-permission android:name="BIND_GET_INSTALL_REFERRER_SERVICE" />

Add Code to Initialize the Singular SDK

Use the following code to initialize the Singular SDK in your app.

Add .trackApplicationLifecycleEvents() to send app open, app updated, and app installed events to Singular.

static final String SEGMENT_WRITE_KEY = "<YOUR_KEY>";
    @Override protected void onCreate(Bundle savedInstanceState) {
        Analytics analytics = new Analytics.Builder(this , SEGMENT_WRITE_KEY)
            .use(SingularIntegration.FACTORY
            .logLevel(Analytics.LogLevel.VERBOSE)
            .recordScreenViews()
            .trackApplicationLifecycleEvents()
            .build();
        Analytics.setSingletonInstance(analytics);
    }

[OPTIONAL] Implement Event Tracking

Use the Segment track function to have events translated and sent to Singular:

 Analytics.with(this).track("event_name");

Segment includes all the event properties as callback parameters on the Singular event, and automatically translates properties.revenue to the appropriate Singular purchase event properties.

Purchase event example:

Analytics.with(this).track("purchase", new Properties().putRevenue(2.5).putValue("currency","USD"));

[OPTIONAL] Implement User Identification

The Singular SDK can send a user ID from your app to Singular. This can be a username, email address, randomly generated string, or whichever identifier you use as a user ID.

Singular uses the user ID in user-level data exports as well as internal BI postbacks (if you configure such postbacks).

To set the user ID, call the identify method:

Analytics.with(this).identify("user1234")

To unset the user ID, call the ​reset​ method:

analytics.reset();