Google Analytics Plugin

Integrate with Google Analytics to measure user interactions for your mobile and desktop apps.

Measure User Interactions

Send your app's page views or custom events to Google Analytics to learn more about the usage patterns of your apps.

Advanced Analytics

See how your users navigate through your apps, which content is the most valuable for your users and more.

Overview

The Google Analytics Plugin lets you measure user interactions for your mobile and desktop apps. It allows to track screen views and custom events to gain insights into your app's usage.

The two main methods for using the Google Analytics plugin and reports are GoogleAnalytics::logScreen and GoogleAnalytics::logEvent.

Google Analytics Examples

Plugin Demo App

To try the plugin or see an integration example have a look at the V-Play Plugin Demo app.

Please also have a look at our plugin example project on GitHub: https://github.com/V-Play/PluginDemo.

Example Usage

The GoogleAnalytics item can be used like any other QML item. Add a single instance of the item to the root item of your QML files:

 import VPlayPlugins 1.0

 GoogleAnalytics {
   id: ga

   // Property tracking ID from Google Analytics Dashboard
   propertyId: "UA-32264673-5"
 }

You can then track screens like this (the onEntered signal :

 AboutScreen {
   onEntered: ga.logScreen("About")
 }

To track custom events, e.g. from a button press, you can use the following code snippet:

 Button {
   text: "Start Game"
   onClicked: ga.logEvent("User Action", "Start Clicked")
 }

Available QML Items

GoogleAnalytics

Google Analytics Plugin lets you measure user interactions for your mobile and desktop apps

Adding and Activating Plugins

How to Add a V-Play Plugin to your App or Game

When you create a new project, you can choose the Plugin Application template to get your own version of the V-Play Plugin Demo with the plugins you want to include. Open Qt Creator and choose “File / New File or Project”, then select Plugin Application in the V-Play Apps section or Game with Plugins in the V-Play Games section to start the project wizard.

Then select the platforms you want to run your application on. The plugins are available for both iOS & Android. There is a fallback functionality in place on Desktop platforms so your project still works when you call methods of the plugins. This allows you to do the main development on your PC, and for testing the plugin functionality you can run the project on iOS and Android.

After the Kit Selection, you can choose which of the plugins you’d like to add to your project:

Then complete the wizard, your project is now set up with all the correct plugin dependencies for Android & iOS automatically. This includes:

  • Setting up the .gradle file for Android.
  • Setting up the .plist file for iOS.
  • Setting up the .pro file to include the plugin libraries for iOS.

Note: Additional integration steps are still required for most plugins, for example to add the actual plugin libraries for iOS to your project. Please have a look at the integration steps described in the documentation for each of the used plugins.

If you have an existing V-Play application, follow these steps to include a plugin to your app or game:

In Qt Creator, select “File / New File or Project” and choose either V-Play Games or V-Play Apps from Files and Classes. Then select V-Play Plugin and press Choose.

You can now select the plugin you want to add:

The plugin item, which contains the chosen plugin and a short usage example, is now added to your project. To use the item in your project, simply perform these steps:

  • Include the created item (use the name you entered in the template before) in your main.qml file.
  • Modify the .pro file & .plist file for iOS usage. See the iOS integration guide of the chosen plugin for more information.
  • Modify the the .gradle file for Android usage. See the Android integration guide of the chosen plugin for more information.

Note: If you have an existing Qt application, you can also add V-Play Plugins to your app! See here how to do this.

Activating Plugins with a License Key

You can test all plugins as soon as the required integration steps and plugin configuration are completed.

However, the plugins are only available as Trial Versions if they are not activated with a valid license. When you are using unlicensed plugins, a dialog is shown and a watermark overlays your application to notify you about the testing state of the plugin.

All monetization plugins are free to use in all licenses, other plugins are only fully usable if you have purchased the Indie or Enterprise license. To activate plugins and enable their full functionality it is required to create a license key. You can create such a key for your application using the license creation page.

This is how it works:

  • Choose the plugins you want to include in your license key:

  • Click on “Generate License Key” and set the app identifier & version code of your application. You can see that the AdMob plugin was enabled in this license key:

  • Copy the generated licenseKey to your GameWindow or App component.

  • You can now fully use the selected plugins!

Integration

Windows & macOS

Make sure to set the application identifier in your main.cpp file before initializing the QML engine:

 int main(int argc, char *argv[])
 {
     QGuiApplication app(argc, argv);

     // Add this line to match your application identifier:
     app.setOrganizationDomain("net.vplay.plugins.GoogleAnalyticsSample");

     QQmlApplicationEngine engine;
     ...

     return app.exec();
 }

If you want to see information about the app version within the Google Analytics Dashboard add a second line just below the above:

 // Set your app's current version number here:
 app.setApplicationVersion("1.0");

Note: If you're only using the iOS & Android version of the plugin you don't need to modify your main.cpp file, as these values are read from the underyling platform itself.

Google Analytics Account

Set up a Google Analytics user account at https://www.google.com/analytics/ and create a new "Mobile App property like described here. You later on need the generated tracking ID (UA-xxxxxxxx-y).

Note: It usually takes some time for new properties to set up before Google Analytics shows some tracking data.

Voted #1 for:

  • Easiest to learn
  • Most time saving
  • Best support

Develop Cross-Platform Apps and Games 50% Faster!

  • Voted the best supported, most time-saving and easiest to learn cross-platform development tool
  • Based on the Qt framework, with native performance and appearance on all platforms including iOS and Android
  • Offers a variety of plugins to monetize, analyze and engage users
FREE!
create apps
create games
cross platform
native performance
3rd party services
game network
multiplayer
level editor
easiest to learn
biggest time saving
best support