すべてのプロダクト
Search

このプロダクト

    Mobile Platform as a Service:チャネル構成

    ドキュメントセンター

    Mobile Platform as a Service:チャネル構成

    最終更新日:Jan 17, 2025

    このトピックでは、iOS および Android のプッシュチャネルを構成する方法について説明します。

    iOS プッシュチャネルを構成する

    Apple モバイルフォンにアクセスする場合、メッセージプッシュゲートウェイとして APNs サービスに依存します。 コンソール側で iOS プッシュ証明書をアップロードして、APNs サービスに接続する必要があります。

    iOS プッシュ証明書を構成するには、次の手順を実行します。

    1. mPaaS コンソールにログインします。 左側のナビゲーションウィンドウで、[メッセージプッシュサービス] > メッセージ プッシュ サービス > 設定 を選択します。

    2. 右側の [設定] ページで、チャネル設定iOS チャネル タブをクリックします。 セクションで、iOS 証明書を構成します。

      • [証明書ファイルを選択]: 準備した iOS プッシュ証明書を選択してアップロードします。バックエンドは、アップロードされた証明書を解析して、証明書の環境と BundleId を取得します。iOS プッシュ証明書の作成方法の詳細については、「iOS プッシュ証明書を作成する」をご参照ください。

      • 証明書のパスワード: .p12 証明書のエクスポート時に設定した証明書のパスワードを入力します。

    3. [アップロード] をクリックして構成を保存します。証明書のフォーマットが正しい場合は、証明書の詳細を表示できます。証明書が環境に対応していて有効かどうかを確認する必要がある場合は、コンソールでメッセージをプッシュすることでテストできます。

    説明

    iOS プッシュ証明書には有効期間があります。 メッセージプッシュが正常に機能しなくなるのを防ぐために、プッシュ証明書の有効期限が切れる前に証明書を更新してください。 システムは、証明書の有効期限が切れる 15 日前に証明書の交換を促すメッセージを表示し始めます。 証明書を置き換えるには、証明書情報の下にある 再アップロード をクリックして、新しい証明書をアップロードします。

    iOS ライブアクティビティメッセージプッシュ証明書を構成する

    重要

    iOS ライブアクティビティメッセージプッシュ証明書を構成する前に、まず iOS の元のプッシュ証明書、つまり .p12 証明書が構成されていることを確認する必要があります。そうでない場合、ライブアクティビティメッセージ証明書を構成できません。

    iOS ライブアクティビティメッセージング証明書を構成する手順は次のとおりです。

    1. mPaaS コンソールにログインし、対象のアプリケーションを選択して、左側のナビゲーションバーから [メッセージプッシュ] サービス > [設定] ページに移動します。

    2. [ios チャネル] の設定ページで、トークン認証の構成を確認します。 bundleId、keyId、および teamId を構成した後、.p8 ファイルである p8AuthKey 秘密鍵ファイルをアップロードし、[OK] をクリックします。

    重要

    • 上記のパラメータは、「iOS P8 リアルタイムアクティビティ証明書を作成する」をご参照ください。

    • ライブアクティビティメッセージをプッシュするための環境は元の iOS 証明書にバインドされているため、使用効果は次のとおりです。

      • 元の iOS 証明書がテスト環境サンドボックス証明書の場合、テスト環境のライブアクティビティメッセージがプッシュされます。

      • 元の iOS 証明書が本番環境証明書の場合、本番環境のライブアクティビティメッセージがプッシュされます。

    Android プッシュチャネルを構成する

    プッシュの到達率を向上させるために、mPaaS は Huawei、Xiaomi、OPPO、vivo などのメーカーのプッシュチャネルを統合しています。 Xiaomi 通知バーメッセージ、Huawei 通知バーメッセージ、OPPO 通知バーメッセージ、vivo 通知バーメッセージを使用して、メッセージプッシュを実現します。 アプリケーションが実行されていない場合でも、通知を送信することができ、ユーザーは通知バーをクリックすることでプロセスをアクティブ化できます。

    説明

    メーカー所有のプッシュチャネルに接続すると、アプリケーションは安定したプッシュパフォーマンスを実現できます。 そのため、メーカー所有のプッシュチャネルをアプリケーションに接続することをお勧めします。

    この記事では、Xiaomi、Huawei、OPPO、vivo プッシュチャネルにアクセスする際に必要なコンソール側の構成を完了するためのガイダンスを提供します。

    前提条件

    クライアント側のアクセスを構成する必要があります。 詳細については、「メーカープッシュチャネルに接続する」をご参照ください。

    手順

    Huawei プッシュチャネルを構成する

    1. 左側のナビゲーションウィンドウで、[メッセージプッシュサービス] > [設定] > [チャネル設定] を選択します。

    2. 構成するHuawei プッシュ チャネル セクションの右上隅にある をクリックします。 構成エントリが表示されます。

      パラメーター

      必須

      説明

      ステータス

      はい

      チャネルのアクセスステータススイッチ。 スイッチをオンにすると、MPS は構成に基づいて Huawei プッシュチャネルにアクセスします。スイッチをオフにすると、アクセスはキャンセルされます。

      SDK パッケージ

      はい

      カスタム Huawei アプリケーションパッケージ名をサポートします。 このパラメータが指定されていない場合、Xiaomi チャネルによって登録されたパッケージ名がデフォルトで使用されます。

      Huawei アプリケーション ID

      はい

      Huawei アプリケーションの App ID を入力します。

      Huawei アプリケーションキー

      はい

      Huawei アプリケーションの App Secret を入力します。

      説明

      Huawei Developer Alliance ウェブサイトにログインし、[管理センター] > [マイ プロダクト] > [モバイル アプリケーション 詳細] を選択して、アプリケーション パッケージ名、アプリケーション ID、およびキーを取得できます。

    3. [OK] をクリックして構成を保存します。

    HONOR プッシュチャネルを構成する

    1. 左側のナビゲーションウィンドウで、メッセージプッシュサービス > 設定 > チャネル設定 を選択します。

    2. 構成するHONOR プッシュチャネル 構成セクションの右上隅にある をクリックします。 構成エントリが表示されます。

      パラメーター

      必須

      説明

      ステータス

      はい

      チャネルのアクセスステータススイッチ。 スイッチをオンにすると、MPS は構成に従って HONOR プッシュチャネルにアクセスします。スイッチをオフにすると、アクセスがキャンセルされます。

      SDK パッケージ

      はい

      カスタム HONOR アプリケーションパッケージ名をサポートします。

      HONOR AppID

      はい

      一意のアプリケーション識別子。デベロッパープラットフォームで対応するアプリケーションの HONOR プッシュサービスがアクティブ化されると生成されます。

      HONOR アプリケーション ID

      はい

      アプリケーションのカスタマー ID。メッセージ送信トークンの ID を取得するために使用されます。 対応するアプリケーションの PUSH サービスがデベロッパープラットフォームでアクティブ化されると生成されます。

      HONOR アプリケーションキー

      はい

      HONOR アプリシークレット (App Secret) を入力します。

      説明

      HONOR Developer Alliance ウェブサイトにログインし、[管理センター] > [マイ プロダクト] > [モバイル アプリケーション 詳細] ページに移動して、アプリケーション パッケージ名、アプリケーション ID、およびキーを取得できます。

    3. [OK] をクリックして構成を保存します。

    Xiaomi プッシュチャネルを構成する

    1. 左側のナビゲーション ウィンドウで、[メッセージプッシュ] > [設定] > [チャネル設定] を選択します。

    2. 構成するXiaomiプッシュチャネル セクションの右上隅にある をクリックします。 構成エントリが表示されます。

      パラメーター

      必須

      説明

      ステータス

      はい

      チャネルのアクセスステータススイッチ。 スイッチをオンにすると、MPS は構成に従って Xiaomi プッシュチャネルにアクセスします。スイッチをオフにすると、アクセスはキャンセルされます。

      SDK パッケージ

      はい

      Xiaomi アプリのメインパッケージ名を入力します。

      sqlserver パスワード

      はい

      Xiaomi アプリの AppSecret を入力します。

      説明

      パッケージ名とキーを取得するには、Xiaomi オープン プラットフォーム コンソールにログインし、アプリケーション管理アプリケーション情報 > を選択します。

    3. [OK] をクリックして構成を保存します。

    OPPO プッシュチャネルを構成する

    1. 左側のナビゲーションウィンドウで、[メッセージプッシュ] > [設定] > メッセージプッシュ > 設定 > チャネル設定 を選択します。

    2. OPPO プッシュ チャネル構成する セクションの右上隅で、 をクリックします。 構成エントリが表示されます。

      パラメーター

      必須

      説明

      ステータス

      はい

      チャネルのアクセスステータススイッチ。 スイッチをオンにすると、MPS は構成に基づいて OPPO プッシュチャネルに接続します。スイッチをオフにすると、アクセスはキャンセルされます。

      SDK パッケージ

      はい

      OPPO アプリケーションパッケージ名をカスタマイズできます。 名前は、OPPO オープン プラットフォームのアプリケーションパッケージ名と同じである必要があります。 このパラメータが指定されていない場合、Xiaomi チャネルによって登録されたパッケージ名がデフォルトで使用されます。

      AppKey

      はい

      AppKey はクライアントの ID であり、クライアント SDK が初期化されるときに使用されます。

      MasterSecret

      はい

      MasterSecret は、開発者がサーバーで API 操作を呼び出すときに ID を検証するために使用されます。

      説明

      OPPO オープン プラットフォーム で、OPPO プッシュ権限を付与した後、OPPO プッシュ プラットフォーム > 構成管理アプリケーション構成 > ページでアプリケーションの AppKey と MasterSecret を表示できます。

    3. [OK] をクリックして構成を保存します。

    vivo プッシュチャネルを構成する

    1. 左側のナビゲーション ウィンドウで、[メッセージ プッシュ] > [設定] > [チャネル構成] を選択します。

    2. VIVO プッシュ チャネル構成する セクションの右上隅で、 をクリックします。 構成エントリが表示されます。

      パラメーター

      必須

      説明

      ステータス

      はい

      チャネルのアクセスステータススイッチ。 スイッチをオンにすると、MPS は構成に基づいて vivo プッシュチャネルに接続します。スイッチをオフにすると、アクセスはキャンセルされます。

      SDK パッケージ

      はい

      vivo アプリケーションパッケージ名をカスタマイズできます。 名前は、vivo オープン プラットフォームのアプリケーションパッケージ名と同じである必要があります。 このパラメータが指定されていない場合、Xiaomi チャネルによって登録されたパッケージ名がデフォルトで使用されます。

      APP ID

      はい

      AppId はクライアントの ID であり、クライアント SDK が初期化されるときに使用されます。

      AppKey

      はい

      AppKey はクライアントの ID であり、クライアント SDK が初期化されるときに使用されます。

      MasterSecret

      はい

      MasterSecret は、開発者がサーバーで API 操作を呼び出すときに ID を検証するために使用されます。 このパラメータは、vivo デベロッパープラットフォームから取得した AppSecret に対応します。

      説明

      vivo オープン プラットフォーム でアプリケーションのプッシュサービスを申請した後、アプリケーションの AppId、AppKey、および MasterSecret (AppSecret) を取得できます。

    3. [OK] をクリックして構成を保存します。

    FCM プッシュチャネルを構成する

    中国以外の Android デバイスに接続する際に、Google の FCM サービスをメッセージプッシュゲートウェイとして使用する場合は、コンソールで FCM プッシュチャネルを構成する必要があります。

    前提条件

    FCM プッシュチャネルを構成する前に、Firebase コンソールで FCM サーバーキーを取得する必要があります。

    手順

    1. 左側のナビゲーションウィンドウで、[メッセージプッシュサービス] > [設定] > [チャネル設定] を選択します。

    2. 構成するFCM プッシュ チャネル セクションの右上隅にある をクリックして、チャネルを構成します。

    3. 状態 スイッチをクリックします。 スイッチをオンにすると、MPS は FCM に接続されます。スイッチをオフにすると、MPS は FCM に接続されません。

    4. FCM サーバー キー を入力します。キーがサーバー キーであることを確認してください。Android キー、iOS キー、およびブラウザ キーは FCM によって拒否されます。

    5. [OK] をクリックして構成を保存します。

    新しい FCM プッシュチャネルを構成する

    重要

    古い FCM API は 2024 年 6 月 20 日以降サポートされなくなり、廃止されます。MPS の中断を回避するために、できるだけ早く新しい FCM API に移行してください。

    1. コンソールから FCM 認証ファイルをアップロードします。

      20fac4b855cdd4679a55cf094cdbee06

      Firebase プロジェクトは Google サービスアカウント をサポートしており、アプリケーションサーバーまたは信頼できる環境から Firebase サーバー API を呼び出すために使用できます。 ローカルでコードを記述したり、アプリをローカルにデプロイしたりする場合は、このサービスアカウントで取得した認証情報を使用してサーバーリクエストを承認できます。

      説明

      サービスアカウントを認証し、Firebase サービスへのアクセスを許可するには、次の手順に従って JSON 形式の秘密鍵ファイルを生成する必要があります。

      1. Firebase コンソールで、設定 サービスアカウント > を選択します。

      2. 新しい秘密キーを生成するキーの生成 をクリックし、 ボタンをクリックして確認します。

      3. キーを含む JSON ファイルを安全な場所に保存します。

    2. プッシュリンクモードを切り替えます。

      新しいバージョンの FCM ロジックによって提供されるリンク切り替え方法は、拡張パラメータ (extended_params) 構成を追加し、キーと値のペア useNewFcmApi=1 を追加して、新しいリンクを介してメッセージをプッシュすることです。

      image

      メッセージをプッシュするときは、拡張パラメータを追加する必要があります。

      • 旧バージョン: useNewFcmApi, 0;

      • 新バージョン: useNewFcmApi, 1;

      拡張パラメータが追加されていない場合は、デフォルトで旧バージョンが使用されます。