Prerequisite: Complete the SDK Integration Guide first
- This guide requires you to have already integrated the Branch SDK into your app.
You can measure your app growth in the Dashboard through automatic event tracking and user identity tracking.
Branch automatically creates events whenever a user accesses your site or your app. We measure installs, re-opens and web page visits with separate events. Here is a list of the auto-created ones:
||Triggered the first time a user launches your app|
||Trigged when the user opens the app after the very first launch OR if a user reinstalls the app after uninstalling it|
||Triggered when the user views a webpage using the Branch Web SDK.|
||Triggered in addition to install, open or web session start if a user comes from a Branch link|
You can be notified via a postback to your server every time that an event occurs. Visit the Webhooks page for more information on configuring postbacks.
You can also define as many custom events (signups, purchases, shares, etc.) as you wish - see the User Value Attribution guide for more on tracking custom events. You can see these events as they occur on the Live View > Events page.
Identifying your users will help you associate all activities and links created to a particular person. This can show you which of your users are the most influential.
setIdentity call wherever you create or login a user. This should be done after you have successfully initialized a Branch session. Only call
setIdentity when the user first logs in. We will cache the identity for future sessions.
logout call anywhere you allow the user to logout.
Logout should only be called when the user logs out. Calling it at other times could lead to hard-to-discover errors. Failing to call
logout can likewise lead to bugs if multiple users log in on the same device.
Retroactive event attribution
The first time an identity is set for each unique user ID, it will retroactively associate any previously recorded events from the current device with that user ID. This only occurs once.
The Influencers page on the dashboard will show you who is driving the most new signups.
You must identify your users in order for the
User IDcolumn to be populated. The
Branch IDrefers to the internal Branch ID associated with that user. It is set automatically in the SDK.