OneSignal Help & Documentation

Welcome to the OneSignal New IA developer hub. You'll find comprehensive guides and documentation to help you start working with OneSignal New IA as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    Discussions

Google Analytics for Firebase

OneSignal will automatically send notification events to your analytics dashboard if Google Analytics for Firebase is correctly implemented.
Works with iOS and Android

For Developers

Google Analytics for Firebase is an event-tracking tool provided for free by Google Firebase. It allows you to easily track events within your app and analyze them later using various filters. You can learn more about Google Analytics for Firebase here

Events

The OneSignal SDK tracks events that pertain to notification open & receive events. The following events are sent:

Event Name
Purpose

os_notification_opened

A OneSignal notification was opened

os_notification_received

A OneSignal notification was received. (Android Only)

os_notification_influence_open

An application was opened within 2 minutes of a OneSignal notification being received.
(iOS requires additional setup)

The OneSignal SDK also sends parameters which contain more info about the particular notification the event is attributed to:

Parameter Name
Parameter Value
Purpose

source

"OneSignal"

To attribute this event's source to the OneSignal SDK

medium

"notification"

A formal indication that the medium for the event is a notification

notification_id

the notification_id from a particular OneSignal notification

You can attribute a notification ID to a particular "sent" notification on the dashboard

campaign

If using a template:
[template_name]-[template_id]
If not:
First 10 letters of the title

Campaigns are a way to group notifications that are similar, such as notifications using the same template or title.


Setup OneSignal events integration with Google Analytics for Firebase

1. Setup Firebase

Follow the Firebase integration documentation and verify that Firebase is correctly functioning inside your application.

2. Enable Firebase In OneSignal

Settings > Integrations

Just click Enable under "Google Analytics for Firebase". This will begin sending event data to Firebase. If you wish to track influenced opens on iOS, you will need to perform some additional setup due to limitations in Firebase.

3. Verify OneSignal Events

A. Verify that Firebase is attempting to send events related to OneSignal notifications

Check in your application's LogCat logs and look for Google Analytics for Firebase entries that indicate events corresponding to OneSignal are being sent. Look for os_notification_opened,os_notification_received, or os_notification_influence_open

B. Go to the Firebase Console for your project

C. Follow the DebugView Setup Guide

The DebugView allows ADB to send Firebase events to your project when it's in debug mode

D. As OneSignal events propagate, they will appear in real-time on the DebugView

E. Your application has been verified to track OneSignal notification events through Google Analytics for Firebase!

You're Done!

Google Analytics for Firebase is now set up to receive OneSignal events.


What's Next

See other integrations you can set up with OneSignal

Integrations

Google Analytics for Firebase


OneSignal will automatically send notification events to your analytics dashboard if Google Analytics for Firebase is correctly implemented.
Works with iOS and Android

For Developers

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.