<commit_before><h1 align="center">
  <a href="https://branch.io"><img src="http://i.imgur.com/Y5EPQTo.png" alt="Branch for Cordova/PhoneGap/Ionic" width="600"></a>
</h1>
<p align="center">
  <a href="https://travis-ci.org/BranchMetrics/cordova-ionic-phonegap-branch-deep-linking"><img src="https://img.shields.io/travis/BranchMetrics/cordova-ionic-phonegap-branch-deep-linking/master.svg" alt="Travis"></a>
  <a href="https://www.npmjs.com/package/branch-cordova-sdk"><img src="https://img.shields.io/npm/dt/branch-cordova-sdk.svg" alt="npm downloads"></a>
  <a href="https://www.npmjs.com/package/branch-cordova-sdk"><img src="https://img.shields.io/npm/v/branch-cordova-sdk.svg" alt="npm version"></a>
  <a href="https://www.npmjs.com/package/branch-cordova-sdk"><img src="https://img.shields.io/npm/l/branch-cordova-sdk.svg" alt="npm version"></a>
</p>

# Branch for Cordova/PhoneGap/Ionic
*Questions? [Contact us](https://support.branch.io/support/tickets/new)*

- [Getting Started](#getting-started)
  - [Configure Branch](#configure-branch)
  - [Install Branch](#install-branch)
  - [Configure App](#configure-app)
  - [Initialize Branch](#initialize-branch)
  - [Test Deep Link iOS](#test-deep-link-ios)
  - [Test Deep Link Android](#test-deep-link-android)
- [Features](#features)
  - [Initialize Branch Features](#initialize-branch-features)
  - [Create Content Reference](#create-content-reference)
  - [Create Deep Link](#create-deep-link)
  - [Share Deep Link](#share-deep-link)
  - [Read Deep Link](#read-deep-link)
  - [Display Content](#display-content)
  - [Track Content](#track-content)
  - [Track User](#track-user)
  - [Track Event](#track-event)
  - [Handle Referrals](#handle-referrals)
- [Troubleshooting](#troubleshooting)
  - [Testing: Key Points](#testing-key-points) 
  - [Testing: Sample Testing App](#testing-sample-testing-app)
  - [Testing: Sample Integration App](#testing-sample-integration-app)
  - [Testing: Show Console Logs](#testing-show-console-logs)
  - [Testing: Supported Platforms](#testing-supported-platforms)
  - [Testing: Simulating an Install](#testing-simulating-an-install)
  - [Link Domain: Custom](#link-domain-custom)
  - [Link Domain: Bnc.lt](#link-domain-bnclt)
  - [Link Data: Convert to Ionic/Angular](#link-data-convert-to-ionicangular)
  - [Link Data: Global Listener Warning](#link-data-global-listener-warning)
  - [Compiling: Updating the Branch SDK](#compiling-updating-the-branch-sdk)
  - [Compiling: Cordova Dependencies](#compiling-cordova-dependencies)
  - [Compiling: Visual Studio TACO](#compiling-visual-studio-taco)
  - [Compiling: Multiple support-lib v4s](#compiling-multiple-support-lib-v4s)
  - [Compiling: Missing Android Dependency](#compiling-missing-android-dependency)
- [Additional](#additional)
  - [SDK Development](#sdk-development)
  - [Bulk Link Creation](#bulk-link-creation)
  - [Analytical Data](#analytical-data)
  - [Webpage Features](#webpage-features)
  - [Premium Features](#premium-feature)
  - [Support](#support)

# Getting Started

- #### Configure Branch

  - Complete your [Branch Dashboard](https://dashboard.branch.io/settings/link)
  
    ![image](http://i.imgur.com/tkEolFM.png)

- #### Install Branch

  - Cordova and Ionic and PhoneGap
    ```sh
    # terminal<commit_msg>docs: added purpose and video<commit_after><h1 align="center">
  <a href="https://branch.io"><img src="http://i.imgur.com/Y5EPQTo.png" alt="Branch for Cordova/PhoneGap/Ionic" width="600"></a>
</h1>
<p align="center">
  <a href="https://travis-ci.org/BranchMetrics/cordova-ionic-phonegap-branch-deep-linking"><img src="https://img.shields.io/travis/BranchMetrics/cordova-ionic-phonegap-branch-deep-linking/master.svg" alt="Travis"></a>
  <a href="https://www.npmjs.com/package/branch-cordova-sdk"><img src="https://img.shields.io/npm/dt/branch-cordova-sdk.svg" alt="npm downloads"></a>
  <a href="https://www.npmjs.com/package/branch-cordova-sdk"><img src="https://img.shields.io/npm/v/branch-cordova-sdk.svg" alt="npm version"></a>
  <a href="https://www.npmjs.com/package/branch-cordova-sdk"><img src="https://img.shields.io/npm/l/branch-cordova-sdk.svg" alt="npm version"></a>
</p>

> Users should have the best experience regardless of device or operating system when clicking on hyperlinks.

> Branch deep links allow users to install and open your app with custom data.

> Branch deep links can also navigate users to specific app content, convert web users to app users, have user-to-user sharing, track referrals, track users, and track conversion, increase engagement, and grow your app.

<p align="center">
  <a href="https://youtu.be/MXgLQ8QDXk8"><img src="http://i.imgur.com/NF2NEDn.gif"/></a>
</p>

# Branch for Cordova, PhoneGap, and Ionic
*Questions? [Contact us](https://support.branch.io/support/tickets/new)*

- [Getting Started](#getting-started)
  - [Configure Branch](#configure-branch)
  - [Install Branch](#install-branch)
  - [Configure App](#configure-app)
  - [Initialize Branch](#initialize-branch)
  - [Test Deep Link iOS](#test-deep-link-ios)
  - [Test Deep Link Android](#test-deep-link-android)
- [Features](#features)
  - [Initialize Branch Features](#initialize-branch-features)
  - [Create Content Reference](#create-content-reference)
  - [Create Deep Link](#create-deep-link)
  - [Share Deep Link](#share-deep-link)
  - [Read Deep Link](#read-deep-link)
  - [Display Content](#display-content)
  - [Track Content](#track-content)
  - [Track User](#track-user)
  - [Track Event](#track-event)
  - [Handle Referrals](#handle-referrals)
- [Troubleshooting](#troubleshooting)
  - [Testing: Key Points](#testing-key-points) 
  - [Testing: Sample Testing App](#testing-sample-testing-app)
  - [Testing: Sample Integration App](#testing-sample-integration-app)
  - [Testing: Show Console Logs](#testing-show-console-logs)
  - [Testing: Supported Platforms](#testing-supported-platforms)
  - [Testing: Simulating an Install](#testing-simulating-an-install)
  - [Link Domain: Custom](#link-domain-custom)
  - [Link Domain: Bnc.lt](#link-domain-bnclt)
  - [Link Data: Convert to Ionic/Angular](#link-data-convert-to-ionicangular)
  - [Link Data: Global Listener Warning](#link-data-global-listener-warning)
  - [Compiling: Updating the Branch SDK](#compiling-updating-the-branch-sdk)
  - [Compiling: Cordova Dependencies](#compiling-cordova-dependencies)
  - [Compiling: Visual Studio TACO](#compiling-visual-studio-taco)
  - [Compiling: Multiple support-lib v4s](#compiling-multiple-support-lib-v4s)
  - [Compiling: Missing Android Dependency](#compiling-missing-android-dependency)
- [Additional](#additional)
  - [SDK Development](#sdk-development)
  - [Bulk Link Creation](#bulk-link-creation)
  - [Analytical Data](#analytical-data)
  - [Webpage Features](#webpage-features)
  - [Premium Features](#premium-feature)
  - [Support](#support)

# Getting Started

- #### Configure Branch

  - Complete your [Branch Dashboard](https://dashboard.branch.io/settings/link)
  
    ![image](http://i.imgur.com/tkEolFM.png)

- #### Install Branch

  - Cordova and PhoneGap and Ionic
    ```sh
    # terminal
{'fraction_non_alphanumeric': 0.1759572072072072, 'fraction_numerical': 0.0026745495495495496, 'mean_word_length': 4.684, 'pattern_counts': {'":': 0, '<': 46, '<?xml version=': 0, '>': 49, 'https://': 23, 'lorem ipsum': 0, 'www.': 6, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2780448', 'n_tokens_mistral': 2498, 'n_tokens_neox': 2319, 'n_words': 419}