Branch

Send iOS and Android in-app subscription events to Branch with Qonversion.

Qonversion can automatically send every valuable mobile subscription event to your Branch account to help you measure the marketing performance. Measure what drives your revenue by tracking trial-to-paying-user conversion, subscription renewals, refunds, and other useful subscription events.

1. Set up the SDKs

  1. Make sure you have Branch SDK installed. If you do not have Branch integration yet, please use this documentation for iOS and Android.

  2. Set Qonversion SDKs following installing the SDKs guides.

  3. Attribute events sent from Qonversion and events received from the Branch SDK to the same user by setting the same user id to Branch that you set to Qovnersion SDK in Using the SDKs guide.

// Initialize Branch SDK with the user ID
Branch.getInstance().setIdentity("yourSideUserID")
[[Branch getInstance] setIdentity:@"yourSideUserID"];
Branch.getInstance().setIdentity("yourSideUserID");
Branch.getInstance().setIdentity("yourSideUserID")

❗️

Do not track any purchase events on the client side

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

2. Configure the Branch Integration

Provide Integration Details

  1. Get your Branch Key from Branch Settings Dashboard

  2. Navigate to the Integrations section in your Qonversion project, select Branch, and provide the Branch Key and Save.

👍

Done

Now Qonversion will start sending in-app purchases and subscriptions data to your Branch account.

3. Check the integration

Qonversion sends all events as "Purchase" with a custom event alias to Branch. The event names that you set in Qonversion dashboards are the aliases. To see the events from Qonversion in Branch:

  • navigate to the Summary dashboard in Branch
  • filter PURCHASE events with the "show" filter
  • use the additional filter below the chart: "custom_event_alias" equals to the event name you set in Qonversion (e.g. trial_started)

4. Countries events attribution

Branch attributes all server events to the country where the server sending these events is located.
The only way to change this and attribute events to users' countries is to contact Branch support.
You should contact branch support with the request to whitelist your app (include your app's Branch ID in the communication) to record users' IP address instead of the server IP address.

Event Payload

We are providing an event payload that Qonversion sends to Branch below for your reference:

{
   "branch_key":"key_live_KEY",
   "customer_event_alias":"trial_converted",
   "user_data":{
      "os":"",
      "developer_identity":"",
      "idfa":""
   },
   "name":"PURCHASE",
   "event_data":{
      "transaction_id":"",
      "currency":"EUR",
      "revenue":2.39
   }
}

Read more about tracked events here


Did this page help you?