Analytics Events
BuildFire automatically sends analytics events for every app. They track installs, app launches, sessions, sign-ups, logins, purchases and push notifications.
The tables below show the exact event name that Facebook, Google Analytics for Firebase and Segment receive for each event.
If tracking is set to anonymous in your app's settings, events are still sent but without the user's details
Data Sent With Every Event
Each event also carries the data below, except Push Notification Sent, Screen Viewed and the automatic events collected by Firebase and Facebook. The Event Data column in each table lists the data each event adds.
| Data | Description | Google Analytics | Segment | |
|---|---|---|---|---|
url, path, title, referrer | The page in the app where the event happened. | yes | yes | yes |
platform | The device platform, such as ios or android. | yes | yes | yes |
source | Where the event came from, app for the app. | yes | yes | yes |
user | When a user is signed in and tracking is enabled for current user, the user's details: userId, username, email, displayName, firstName and lastName. | yes | yes | yes |
user.tags | The signed-in user's tags in the app. | yes | — | yes |
anonymousId | A random ID saved on the device that identifies it without revealing who the user is. When tracking is anonymous, it replaces the user's details. | — | — | yes |
deviceId | The device's push notification ID, when the device is registered for push notifications. | yes | yes | yes |
ipInfo | The user's location based on their IP address when a user is signed in and tracking is enabled for current user, such as their country, when it can be found. | — | — | yes |
context | The app and feature the event came from: appId, pluginId and instanceId. | — | — | yes |
Google Analytics does not accept nested data, so it receives every field at the top level, such as gameScore instead of game.score. It keeps up to 25 fields per event, cuts values longer than 100 characters, and drops lists
Events
App
| Event | Sent when | Event Data | Facebook / Google Analytics | Segment |
|---|---|---|---|---|
| App Installed | The app is opened for the first time on a device. | N/A | app_installed | app/installed |
| App Opened | The app is launched. | N/A | app_openedApp | app/openedApp |
| Feature Opened | The home screen or any feature is opened. | pluginTitle, pluginId, instanceId when a feature is opened. N/A when the home screen is opened. | app_openedPlugin | app/openedPlugin |
Users
| Event | Sent when | Event Data | Facebook / Google Analytics | Segment |
|---|---|---|---|---|
| User Registered | A user creates an account. | N/A | app_userRegistered | app/userRegistered |
| User Logged In | A user logs in. | N/A | app_userLogin | app/userLogin |
In-App Purchases
| Event | Sent when | Event Data | Facebook / Google Analytics | Segment |
|---|---|---|---|---|
| Purchase Started | A user starts an in-app purchase. | productId, product | app_purchaseStarted | app/purchaseStarted |
| Purchase Completed | An in-app purchase is approved by the store. | productId, product | app_purchaseCompleted | app/purchaseCompleted |
product
| Data | Description |
|---|---|
storeId | The product ID in the App Store or Google Play. |
alias | The product alias. |
state | The product state reported by the store. |
price | The display price, such as $4.99. |
priceMicros | The price in micros, such as 4990000 for 4.99. |
currency | The currency code, such as USD. |
billingPeriod | The billing period of a subscription, such as P1M for one month. |
type | The product type, such as a subscription or a one-time purchase. |
transactionType | The type of the store transaction. |
Push Notifications
| Event | Sent when | Event Data | Facebook / Google Analytics | Segment |
|---|---|---|---|---|
| Push Notification Sent | Push notifications are sent to the app's users. | N/A | — | push_notification/sent |
| Push Notification Viewed | A push notification is shown to the user in the app. | context.instanceId: the notification ID (Segment only) | push_notification_viewed | push_notification/viewed |
| Push Notification Clicked | The user taps the action button of a push notification. | context.instanceId: the notification ID (Segment only) | push_notification_clicked | push_notification/clicked |
Share Links and Files
| Event | Sent when | Event Data | Facebook / Google Analytics | Segment |
|---|---|---|---|---|
| Opened From Share Link | The app is opened from a share link. | shortLinkId | app_openedShortLink | app/openedShortLink |
| Share Link Created | A share link is created. | shortLinkUrl, pluginToken, instanceId, and when the feature sets them: title, description, imageUrl, keywords, data, extraMetaTags | shortlink_generate | shortlink/generate |
Firebase Only
| Event | Sent when | Event Data | Google Analytics |
|---|---|---|---|
| Screen Viewed | A user views a screen in the app. | screen_name | screen_view |
| Firebase Automatic Events | Firebase collects its own automatic events. | Set by Firebase | first_open, session_start and others |
Facebook Only
| Event | Sent when | Event Data | |
|---|---|---|---|
| Facebook Automatic Events | Facebook collects its own automatic app events: app installs, app launches and in-app purchases. | Set by Facebook | See Facebook's list |
Facebook's automatic app events are sent only when your app's third-party tracking is set to identified, or set to ask for consent and the user agreed. Apps with anonymous third-party tracking do not send them