In this KB-article, we explain the procedure to setup Push Notifications for Android. We cover both the old Google Cloud Messaging (GCM) part, so your existing apps are still compatible, as well as the new Firebase part (for your new apps).
- Go to https://console.firebase.google.com/
- Signin with a Google Account.
- Go to the Console.
If you login with a Google Account that is linked to a Google Play Developer account, you can link your Firebase Projects (and apps) more easily to your Android apps in the Google Play Developer Console. However, this is not a requirement to setup your Push Notifications for a Twixl Publisher issue-based or article-based app.
ABOUT THE OLD GCM CONSOLE (< 04/2018):
The old url https://developers.google.com/mobile/add will automatically redirect to the new Firebase Console. Handy for people that like to manage their bookmarks: you don't need to update your bookmark!
- Click on Add Project.
- Choose a Project Name (e.g. the name of your app:
My Magazine). You can also choose an existing Project to setup Firebase for.
- Choose a Project ID or accept the proposed one. You cannot change the project ID after you created it.
- Choose your Country/region (e.g.
- Click on Create Project.
- Wait for the Project to be created an click on Continue afterwards.
- Click on the Gear icon next to your Project Overview
- Select Project Settings.
In the next screen, select Cloud Messaging.
You'll get 3 important values:
Server Key: needs to be entered on the Twixl Distribution Platform if you want to publish a completely new Twixl App in the Google Play Store, built with Twixl Publisher
Legacy Server Key: needs to be entered on the Twixl Distribution Platform if you have an existing Twixl App in the Google Play Store! This way, you can continue to send Push Notifications to readers that didn't update their app to Twixl Publisher
- Sender ID: needs to be entered in the build settings in the macOS app
ABOUT FIREBASE ANDROID AND IOS APPS:
In Firebase, you can setup an Android and/or iOS app. This is not necessary for Twixl Publisher issue-based or article-based applications! The only requirement is the setup of a Project (as explained above).
- Go to the detail view of your app on the Twixl Distribution Platform, then select Notifications from the top menu.
- Now enter the API Server Key in the correct field.
Enter the right API Server Key (also see 2. Setup your Firebase Project):
- A Legacy Key for an update of an existing app.
- A Server Key for a brand new Twixl Publisher
In the build settings of your app in the macOS builder app (under "Article-based app" or under "App Store Kiosk - Basic Settings"), drag the
google-services.json file from Step 4 in the field Android google-services.json
You have now configured push notifications for Android in your app and are ready to create the build.