Branch

Send iOS and Android subscription events to Branch with Qonversion.

Qonversion can automatically send all valuable mobile subscription events to Branch. Qonversion sends iOS and Android subscription data to your Branch account to help you understand your marketing performance. Measure what drives your revenue by tracking trial-to-paying-user conversion, subscription renewals, billing retry state, cancellations, refunds, and other useful subscription events. Here you can find the full list of the events tracked.

Getting Started

1. Configure the SDKs

1. Set Qonversion SDK and Branch SDK to identify a user:

Swift

// Initialize Qonversion SDK with the user ID
Qonversion.launch(withKey: "projectKey")
Qonversion.setUserID("yourSideUserID")

// Initialize Branch SDK with the user ID
Branch.getInstance().setIdentity("yourSideUserID") 

Objective-C

// Initialize Qonversion with user ID
[Qonversion launchWithKey:@"projectKey"];
[Qonversion setUserID:@"yourSideUserID"];

// Identify a Branch SDK user
[[Branch getInstance] setIdentity:"yourSideUserID"]

Java

// Initialize Qonversion with user ID
Qonversion.initialize(this, "projectKey", "yourSideUserID");

// Identify a Branch SDK user
Branch branch = Branch.getInstance(getApplicationContext());
branch.setIdentity("yourSideUserID");

Please note that you should use your Qonversion Application Access Key instead of "projectKey". You can find it in application settings.

If you prefer to use Qonversion user ID as your user identifier across all analytics, use the code below:

Swift

Qonversion.launch(withKey: "projectKey") { (result, error) in 
   // Identify the Branch SDK user
   Branch.getInstance().setIdentity(result.uid)
}

Objective-C

[Qonversion launchWithKey:@"" completion:^(QNLaunchResult * _Nonnull result, NSError * _Nullable error) {
   // Identify a Branch SDK user
   [[Branch getInstance] setIdentity:result.uid]
}];

Java

Not supperted, please write us for more details; 

Full reference of integration with Brach SDK you can find here.

Do not track any purchase events on the client-side with Branch SDK if you are sending these events using Qonversion integration with Branch.

Qonversion tracks and sends revenue events so if you track revenue events with Branch SDK as well, you may double count the events and revenue in your Branch account.

2. Configure the integration

Configure the event names and activate the integration from the Qonversion dashboard. Go to the integrations dashboard and choose Branch:

Branch Integration

Get your Branch key from Branch Settings Dashboard and pass it into Qonversion's Branch Integration dashboard:

Configure Branch Credentials

Done! Now you will be able to receive revenue and subscription events with values in your Branch account.