📝 Issue #2087: Sending one unique push for iOS and Android

README.md

@@ -14,6 +14,17 @@ FCM. If you are using version 1.x please reference the docs in the
 This plugin offers support to receive and handle native push notifications with
 a **single unified API**.
 
+This does not mean you will be able to send a single push message and have it
+arrive on devices running different operating systems. By default Android uses
+FCM and iOS uses APNS and their payloads are significantly different. Even if
+you are using FCM for both Android and iOS there are differences in the payload
+required for the plugin to work correctly. For Android **always** put your push
+payload in the `data` section of the push notification. For more information on
+why that is the case read
+[Notification vs Data Payload](https://github.com/phonegap/phonegap-plugin-push/blob/master/docs/PAYLOAD.md#notification-vs-data-payloads).
+For iOS follow the regular
+[FCM documentation](https://firebase.google.com/docs/cloud-messaging/http-server-ref).
+
 Starting with version `2.0.0`, this plugin will support `CocoaPods` installation
 of the `Firebase Cloud Messaging` library. More details are available in the
 [Installation](docs/INSTALLATION.md#cocoapods) documentation.