All Products
Search
Document Center

Channel configuration

Last Updated: Mar 21, 2022

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:

  1. Log in to the mPaaS console, select the target app, and enter the Message Push Service > Settings page from the left-side navigation pane.

  2. 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.

  3. 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.

Note

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.

ios

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.

Note

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

  1. On the left-side navigation pane, select the Message Push Service > Settings menu, and then enter the Channel configuration tab page.

  2. Click Configure in the upper right corner of the Huawei push channel area.

    huawei

    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

    Enter the name of the Huawei app package.

    Huawei app ID

    Yes

    Enter the App ID of the Huawei app.

    App key

    Yes

    Enter the secret key (AppSecret) of the Huawei app.

    Note

    To 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.

  3. Click OK to save the settings.

Configure Xiaomi push channel

  1. On the left-side navigation pane, select the Message Push Service > Settings menu, and then enter the Channel configuration tab page.

  2. Click Configure in the upper right corner of the Xiaomi push channel area.

    xiaomi

    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

    Enter the name of the main Xiaomi app package.

    AppSecret

    Yes

    Enter the secret key (AppSecret) of the Xiaomi app.

    Note

    To obtain the app package name and secret key, go to Xiaomi Developer, and choose App management > App info.

  3. Click OK to save the settings.

Configure OPPO push channel

  1. On the left-side navigation pane, select the Message Push Service > Settings menu, and then enter the Channel configuration tab page.

  2. Click Configure in the upper right corner of the OPPO push channel area.

    oppo

    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.

    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.

    Note

    After 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.

  3. Click OK to save the settings.

Configure vivo push channel

  1. On the left-side navigation pane, select the Message Push Service > Settings menu, and then enter the Channel configuration tab page.

  2. Click Configure in the upper right corner of the vivo push channel area.

    vivo

    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.

    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.

    Note

    After activating the Push service for an app on the vivo developers platform, you can obtain the AppId, AppKey, and MasterSecret of the app.

  3. 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

  1. On the left-side navigation pane, select the Message Push Service > Settings menu, and then enter the Channel configuration tab page.

  2. Click Configure in the upper right corner of the FCM push channel area. fcm

    1. Turn on the Status switch, MPS accesses the FCM service. If the switch is turned off, the FCM service is disabled in MPS.

    2. Enter the FCM server key. Make sure that this is the server key. Android, iOS, and browser keys will be rejected by FCM.

  3. Click OK to save the settings.