Push Alerts

Chartbeat’s Mobile SDKs integrate Chartbeat analytics with your native iOS, Android, or React Native apps. Beginning with iOS SDK version 1.3.0, Android SDK version 1.4.0, and React Native SDK version 1.0.2, the Chartbeat native app integration provides support for tracking push notifications.

For general SDK documentation, please reference this page. For more information on referrers for native app traffic, please reference this page.

setPushReferrer() Method

When your app responds to push notifications, use the setPushReferrer() method to set an identifier for the notification received. The identifier specified will be sent along with an indicator that the referrer is a push notification. These push notifications and their ids will be viewable in the Real-Time Dashboard, and "Push Alerts" will appear as a canonical referrer in the Historical Dashboard and Unified Dashboard.

iOS

Call setPushReferrer() method with the ID of the push alert before the trackView() call.

Objective-C:

[[CBTracker sharedTracker] setPushReferrer:@"your_push_id"];

Swift:

CBTracker.shared().setPushReferrer("your_push_id")

Android

Set metadata — including setPushReferrer — after trackView(), because view changes purge metadata.

Java

Tracker.setPushReferrer(“your_push_id”);

React Native

Set article metadata after setupTracker and before trackView (or between views, as the article changes).

Chartbeat.setPushReferrer('your_push_id');

Push Vendors

The push identifiers for each vendor will vary slightly. You can follow your vendor’s documentation for retrieving the push identifier to add to the Chartbeat SDK for each application.