ABOUT THE MOVE TO FIREBASE:
Recently, Google sent out info about the switch to Firebase. This is the current situation:
- All existing apps linked to existing GCM Projects will continue to work just fine. Next year (April 2019), Twixl will have to be ready for the final move to Firebase but we'll handle this move as a High Priority Change. We will be ready!
- The procedure to create new GCM Projects still exists but has changed a lot. This KB-article explains the new procedure!
In this KB-article, we explain the procedure to setup Push Notifications for Android.
1. Get Started
- 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 application.
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!
2. Add a Project
- 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 create it.
- Choose your Country/region (e.g.
- Click on Create Project.
- Wait for the Project to be created an click on Continue afterwards.
3. Setup your GCM Project
- Click on the Gear icon next to your Project Overview
- Select Project Settings.
In the next screen, select Cloud Messaging.
You'll get 2 important values:
- Legacy Server Key: needs to be entered on the Twixl Distribution Platform.
- 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).
4. Enter API key on Twixl Distribution Platform
Go to the detail view of your app on the Twixl Distribution Platform, then select "Notifications' from the top menu.
Now enter the Server API key in the correct field.
5. Enter GCM Sender ID in build setting
In the build settings of your app on the macOS app (under "Article-based app" or under "App Store Kiosk - Basic Settings"), paste the Sender ID number in the field "Google Cloud Messaging Sender ID".
6. Build your app
You have now configured push notifications for Android in your app and are ready to create the build.