Shopgate supports Google Analytics for Firebase in mobile Apps.
Important: Firebase Tracking will only work after a successful app update. For us to update your app, you will need dedicated Developer Accounts at Google and Apple. You can find instructions for that here: App Developer Accounts
Please contact us via mail after the setup is done, so that we can submit updates for the apps. Once Google Analytics for Firebase has been configured for your App, Shopgate will use this Firebase project for sending Push messages on Android via Firebase Cloud Messaging. This change only affects the Push infrastructure - you will not notice the change in the Shopgate Merchant Admin.
Step 1: Set up your Firebase project in the Firebase Console
Recommended: Firebase for Mobile Apps is perfectly complemented with Google Tag Manager.
- Create a Firebase Project: Firebase
- After choosing the project name, the additional setup of Google Analitycs is preset. To analyze your mobile app, we recommend setting up Google Analytics for Firebase. You can do that in this step, or do it later at any time. Deactivate the setting (bottom left) for later setup and click on "Create project."
3. After you have set up your Firebase project, you will be redirected to the homepage of your Firebase console and you can now create your iOS and Android apps in succession.
In this process, Firebase asks for your Android package name and the iOS Bundle Identifier (you do not need to specify your app nickname and App Store ID). These can be found in your Shopgate merchant admin: "Settings" => "Tracking Tools" => "Show App Information."
4. Copy and paste in the information and click on "Register app." Download the current configuration file (one click on the blue button). Shopgate has already done the next steps for you (setup SDK, etc.) and you can always click "Next" until the process is finished. It is expected behavior that at this point Firebase will report not being able to connect to your App. This error will go away once we have recompiled and uploaded the App to the App Stores. This process must be done for iOS and Android separately. Click "Continue to console" to get back to the homepage - go to "Add app" and start the process again with the second app.
5. You should now have two files saved: googleService-Info.plist from your iOS project and google-services.json from your Android project.
6. Navigate to "Project Settings" => "Cloud Messaging." Copy the top server key. You'll need it to configure the Shopgate setup, so your Android users can continue to receive push messages.
Step 1 done! You successfully created your Firebase Project!
Step 2: Connect your Firebase project to your Apps in the Shopgate Merchant Admin
- Go to "Settings" => "Tracking Tools."
- Insert the server key that you copied from Firebase into the field "FCM server key."
- Upload the "google-services.json" file in the Android configuration
- Upload the "GoogleService-Info.plist" file in the iOS configuration
- Choose how you wish to track your revenue with Firebase. This setting should be identical to your shop settings. If you display gross prices but select "net" then net prices are tracked to Firebase (if available in the Shopgate system).
Step 3: We recompile your app and submit an update for you
Please send us a short mail to email@example.com. The support will take care of everything else.
As soon as the next app update is available in the app stores, you will see the tracking data in Firebase and the connected Google Analytics account.
FAQ - Frequently Asked Questions
|Why don't I see any screen_view events, or only cryptic names instead of screen_views?||
The Shopgate App is a hybrid app. In order to be able to always publish latest content quickly and without a lengthy App Store Update process, the presentation layer of your App is served via WebViews. Firebase SDK, unfortunately, doesn't allow WebViews to trigger the reserved event "screen_view" and therefore we can't use this event to track the presentation layer of your app.
So that you can track your shopper's journey and create funnels, we have implemented a custom solution to replace screen_views. Simply use the custom event sg_view_page, which is sent with each screen change of the user.