Support Home > Web SDK Integration > Angular Web SDK Integration

Angular Web SDK Integration

Feature Summary: The Kochava Web SDK is a javascript-based solution that provides marketers with Web Tracking capabilities. It can be integrated with a variety of web-based frameworks; this document describes how to integrate with the Angular framework.


If you have already integrated the SDK and started it, please visit Using the SDK support page and choose a topic.

Integrating the SDK


  • NodeJS
  • NPM
  • Angular


Supported Platforms:

  • Angular


Data Privacy:



Estimated Time to Complete
5 Minutes

(Release Notes)


The Kochava Web SDK is available as a first-class Angular library. The SDK itself operates as an Angular service singleton, available within the KochavaAngularModule.

  1. Navigate to the root of your Angular project.
  2. Run ng add kochava-angular.
  3. Run npm install kochava@latest.
  4. In your root component’s module file (typically app.module.ts) add the following:

Starting the SDK

Estimated Time to Complete
1 Minute

Once you have added the Kochava SDK to your project, the next step is to create and start the SDK class in code. Only your App GUID is required to start the SDK with the default settings, which is the case for typical integrations.

Kochava recommends starting the SDK as soon as the application starts, although this can be done later if needed. Starting the tracker as early as possible will ensure it has started before use, resulting in more accurate data/behavior.

  1. In your root component (usually app.component.ts), import the KochavaAngularService and inject it into the constructor. Then call startWithAppGuid with your Kochava app guid.
  2. Replace YOUR_APP_GUID with your Kochava App GUID. For more information on locating your App GUID, refer to our Locating your App GUID support documentation.
  3. For any additional components which use the SDK, import the KochavaAngularService and inject it as a dependency into the component’s constructor. No additional provider entries are required.

NOTE: These calls are optional and used for irregular SDK behavior. In most cases, you do not need to call these functions at all.

  • Disable automatic page events – Call this function with an argument of true to stop the SDK from automatically signaling a page event when the SDK starts.
  • Use cookie storage – Call this function with an argument of true to drop the Cookie on the website to track a device across sub-domains.

Confirm the Integration

After integrating the SDK and adding the code to start the tracker, launch and run the app for at least 10 seconds or more. During this time the tracker will start and send an install payload to Kochava. To confirm integration was successful, visit the app’s Install Feed Validation page Apps & Assets > Install Feed Validation. On this page you should see one of two integration messages, indicating integration success or failure.


Integration Successful:

 Integration Success!


Along with this message you will also see a variety of data points associated with the device used for testing. At this point your integration is successful and you can proceed to the next step(s).

NOTE: It may take a few minutes for the first install to appear within the Install Feed Validation page. If you do not see this message immediately, you may simply need to wait a few minutes and check again.

Integration Not Complete:

 Integration Not Complete!


If you encounter this message, please review the integration steps, uninstall and reinstall the app, and check again.


SDK WAYPOINT: At this point basic integration is complete and the Kochava SDK will begin reporting session activity and attributing installs.


Where to Go From Here:

Now that you have completed integration you are ready to utilize the many features offered by the Kochava SDK. Continue on to Using the SDK and choose a topic.


Last Modified: Aug 24, 2023 at 2:38 pm