RudderSingular 1.2.0

RudderSingular 1.2.0

Maintained by RudderStack.



 
Depends on:
Rudder~> 2.0
Singular-SDK= 12.5.0
 

  • By
  • RudderStack

The Customer Data Platform for Developers

Website · Documentation · Community Slack


Integrating RudderStack iOS SDK with Singular

This repository contains the resources and assets required to integrate the RudderStack iOS SDK with Singular.

For more information on configuring Singular as a destination in RudderStack and the supported events and their mappings, refer to the Singular documentation.

Important: This device mode integration is supported for Singular v12.5.0 and above.

Step 1: Integrate the SDK with Singular

  1. Add Singular as a destination in the RudderStack dashboard.
  2. RudderSingular is available through CocoaPods. To install it, add the following line to your Podfile:
pod 'RudderSingular', '~> 1.2.0'
  1. Run the pod install command.

Step 2: Import the SDK

Swift

import RudderSingular

Objective C

@import RudderSingular;

Step 3: Initialize the RudderStack client (RSClient)

Place the following in your AppDelegate under the didFinishLaunchingWithOptions method.

Swift

let config: RSConfig = RSConfig(writeKey: WRITE_KEY)
            .dataPlaneURL(DATA_PLANE_URL)        

RSClient.sharedInstance().configure(with: config)
let rudderSingularConfig = RudderSingularConfig()
            .skAdNetworkEnabled(true)
            .manualSkanConversionManagement(true)
            .conversionValueUpdatedCallback({ value in
                print("Your SKAN handler \(value)")
            })
            .waitForTrackingAuthorizationWithTimeoutInterval(0)
RSClient.sharedInstance().addDestination(RudderSingularDestination(rudderSingularConfig: rudderSingularConfig))

Objective C

RSConfig *config = [[RSConfig alloc] initWithWriteKey:WRITE_KEY];
[config dataPlaneURL:DATA_PLANE_URL];

[[RSClient sharedInstance] configureWith:config];
RudderSingularConfig *rudderSingularConfig = [[RudderSingularConfig alloc] init];
[rudderSingularConfig skAdNetworkEnabled:YES];
[rudderSingularConfig manualSkanConversionManagement:YES];
[rudderSingularConfig conversionValueUpdatedCallback:^(NSInteger value) {
    printf("Your SKAN handler %ld", value);
}];
[rudderSingularConfig waitForTrackingAuthorizationWithTimeoutInterval:0];
[[RSClient sharedInstance] addDestination:[[RudderSingularDestination alloc] initWithRudderSingularConfig:rudderSingularConfig]];

Step 4: Send events

Follow the steps listed in the RudderStack iOS SDK repo to start sending events to Singular.

About RudderStack

RudderStack is the customer data platform for developers. With RudderStack, you can build and deploy efficient pipelines that collect customer data from every app, website, and SaaS platform, then activate your data in your warehouse, business, and marketing tools.

Start building a better, warehouse-first CDP that delivers complete, unified data to every part of your customer data stack. Sign up for RudderStack Cloud today.

Contact us

For queries on configuring or using this integration, start a conversation in our Slack community.