Overview

As of April 10, 2018, Google has deprecated Google Cloud Messaging (GCM). The GCM server and client APIs are deprecated and were removed on May 29, 2019.
Campaign users need to Migrate GCM apps to Firebase Cloud Messaging (FCM), which inherits the reliable and scalable GCM infrastructure, plus many new features.

Migrating the Android End point from GCM servers to FCM servers includes:

  • a change of the URL targeted by the connector javascript, 
  • a reference to the URL in the authorized URL permission list stated in the configuration files.

Automatic update

Starting Campaign Classic 18.10 release, the new build comes with Android V2 connector which now allows connections only to the FCM server.

Adobe recommends you to upgrade to the latest build to get automatic benefit of this update.

Manual update

If you cannot upgrade to the latest build before deprecation, you can update your connector manually.

Caution:

This procedure applies to Campaign Classic on-premise deployments only.

To do this, follow the steps below:

  1. In the connector that you are using, either androidPushConnector.js or/and androidPushConnectorV2.js, replace the GCM URL: https://gcm-http.googleapis.com/gcm/send by the new FCM URL to use: https://fcm.googleapis.com/fcm/send as below:

    function androidPushApp() {
      this.GOOGLE_GCM_URL = "https://fcm.googleapis.com/fcm/send";
    ...
  2. In the serverConf.xml file of the instance configuration folder, in the List of URLs that the Javascript code can access section, replace the GCM URL regular expression by the one for the FCM URL in the list of mask for URLs authorized by access through Javascript:

    <urlPermission action="" debugTrace="false">
    ...
          <url dnsSuffix="fcm.googleapis.com" urlRegEx="https://fcm\.googleapis\.com/fcm/send.*"/>
    ...
  3. Post making changes, use the nlserver config -reload to have them applied.
     

  4. Use the nlserver monitor -missing command to make sure all process are running smoothly after the changes have been made.