This topic describes how to configure the iOS and Android push channels through console.
Configure iOS push channel
When you push messages to an iPhone, the APNs service is used as the message push gateway. You must upload the iOS push certificate on the console to access APNs service.
Complete the following steps to configure the iOS push certificate:
Log in to the mPaaS console, select the target app, and enter the Message Push Service > Settings page from the left-side navigation pane.
Click the Push configuration tab, and in the iOS channel area, configure the iOS push certificate.
Certificate file: Select and upload the pre-prepared iOS push certificate. The backend will obtain the certificate environment and BundleId by parsing the uploaded certificate. For how to generate iOS push certificate, see Create an iOS push certificate.
Certificate password: Enter the certificate password, which refers to the password you set when exporting the .p12 certificate.
Click the Upload button to save the settings. If the certificate is in a correct format, you can view the details. You can use Simple push to test whether a certificate is valid and is compatible with the environment.
The iOS push certificate is only valid for a certain period, please renew the certificate before it becomes invalid to keep the message push working normally. You will be prompted to replace the certificate 15 days before the certificate expires. To replace the certificate, you can click Re-upload at the bottom to upload a new one.
Configure Android push channels
To improve the arrival rate of pushed messages, mPaaS integrates the push functions some mainstream mobile phone manufacturers such as Huawei, Xiaomi, OPPO, and vivo. Xiaomi Push, Huawei Push, OPPO Push, and vivo Push are used for message push. Notifications can still be sent even if the app is not running. The process can be activated when users tap the notification bar.
Mobile phone manufacturers' proprietary push channels can help apps achieve stable push performance. Therefore, we recommend that you integrate third-party push channels to your app.
This topic describes the console-side configurations required for integrating push channels of Xiaomi, Huawei, OPPO, and vivo.
Configure Huawei push channel
On the left-side navigation pane, select the Message Push Service > Settings menu, and then enter the Channel configuration tab page.
Click Configure in the upper right corner of the Huawei push channel area.
Parameter
Required
Description
Status
Yes
Channel integration status, if the status switch is turned on, MPS integrates Huawei Push based on the configurations. If this switch is turned off, the integration is cancelled.
Package name
Yes
Huawei app package name, you can customize the package name. If you don't fill the field, the Xiaomi app package name that you register will be applied by default.
Huawei app ID
Yes
Huawei app ID.
App key
Yes
The secret key (AppSecret) of the Huawei app.
NoteTo obtain the App package name, App ID, and secret key, go to Huawei Developer, log in to Console, and choose My Products > Mobile App details.
Click OK to save the settings.
Configure Xiaomi push channel
On the left-side navigation pane, select the Message Push Service > Settings menu, and then enter the Channel configuration tab page.
Click Configure in the upper right corner of the Xiaomi push channel area.
Parameter
Required
Description
Status
Yes
Channel integration status, if the status switch is turned on, MPS integrates MiPush based on the configurations. If this switch is turned off, the integration is cancelled.
Package name
Yes
The name of the main Xiaomi app package.
AppSecret
Yes
The secret key (AppSecret) of the Xiaomi app.
NoteTo obtain the app package name and secret key, go to Xiaomi Developer, and choose App management > App info.
Click OK to save the settings.
Configure OPPO push channel
On the left-side navigation pane, select the Message Push Service > Settings menu, and then enter the Channel configuration tab page.
Click Configure in the upper right corner of the OPPO push channel area.
Parameter
Required
Description
Status
Yes
Channel integration status, if the status switch is turned on, MPS integrates OPPO Push based on the configurations. If the switch is turned off, the integration is cancelled.
Package name
Yes
OPPO app package name, you can customize the package name which must be consistent with that on the OPPO PUSH Operation Platform. If you don't fill the field, the Xiaomi app package name that you register will be applied by default.
AppKey
Yes
AppKey is the client ID used when you initialize the client SDK.
MasterSecret
Yes
MasterSecret is the identifier used by developers to authenticate their identities when using server APIs.
NoteAfter activating OPPO Push on the OPPO PUSH Operation Platform, you can view the AppKey and MasterSecret of the app by logging into OPPO PUSH Operation Platform, and choosing Push management > App configuration.
Click OK to save the settings.
Configure vivo push channel
On the left-side navigation pane, select the Message Push Service > Settings menu, and then enter the Channel configuration tab page.
Click Configure in the upper right corner of the vivo push channel area.
Parameter
Required
Description
Status
Yes
The integration status switch of the channel. If the switch is turned on, MPS integrates vivo Push based on the configurations. If the switch is turned off, the integration is cancelled.
Package name
Yes
vivo app package name, you can customize the package name which must be consistent with that on the vivo Developers Platform. If you don't fill the field, the Xiaomi app package name that you register will be applied by default.
AppID
Yes
AppID is the client ID used when you initialize the client SDK.
AppKey
Yes
AppKey is the client ID used when you initialize the client SDK.
MasterSecret
Yes
MasterSecret is the identifier used by developers to authenticate their identities when using server APIs.
NoteAfter activating the Push service for an app on the vivo Developers Platform, you can obtain the AppId, AppKey, and MasterSecret of the app.
Click OK to save the settings.
Configure FCM push channel
When you push messages to an Android device outside China, the FCM service is used as the message push gateway. You must configure FCM on the console.
Prerequisites
You have obtained the FCM server key from the Firebase console (Project settings > Cloud messaging > Server key).
Procedure
On the left-side navigation pane, select the Message Push Service > Settings menu, and then enter the Channel configuration tab page.
Click Configure in the upper right corner of the FCM push channel area.
Turn on the Status switch, MPS accesses the FCM service. If the switch is turned off, the FCM service is disabled in MPS.
Enter the FCM server key. Make sure that this is the server key. Android, iOS, and browser keys will be rejected by FCM.
Click OK to save the settings.