mPaaS MPS は新しいコンソールを使用するようになりました。以前の 4 つのプッシュメソッド (シンプルプッシュ、テンプレートプッシュ、バッチプッシュ、ブロードキャストプッシュ) は、シンプルプッシュとバッチプッシュの 2 つのメソッドに統合されました。新しいシンプルプッシュメソッドは、元のシンプルプッシュとテンプレートプッシュの機能を組み合わせたものです。新しいバッチプッシュメソッドは、元のバッチプッシュとブロードキャストプッシュの機能を組み合わせたものです。
シンプルプッシュは、単一のターゲットにメッセージを送信します。メッセージ内容をカスタマイズするか、事前に作成されたメッセージテンプレートを使用することができます。
メッセージ内容のカスタマイズは、Apple プッシュ証明書の有効性のテストや、Android プッシュ SDK の統合の検証など、ターゲットが少ないシナリオに適しています。メッセージテンプレートは、複数のターゲットに複数回プッシュするシナリオに適しています。コンソールでテンプレートベースのプッシュメッセージを作成して、自動化や大規模なプッシュに使用する前にテンプレート機能の検証とテストを行うことができます。
メッセージが作成されると、すぐにプッシュされ、削除や変更はできません。
このメソッドはページでの手動操作が必要なため、システム検証、運用サポート、緊急のアドホックなニーズなど、低頻度のシナリオでの使用を推奨します。
このトピックでは、コンソールでシンプルなプッシュメッセージを作成する方法について説明します。
前提条件
iOS デバイスにメッセージをプッシュする前に、MPS SDK for iOS を統合してください。詳細については、「iOS SDK の統合」をご参照ください。また、コンソールの [チャンネル設定] ページで Apple デバイスのプッシュ証明書を設定してください。詳細については、「iOS プッシュチャンネルの設定」をご参照ください。
Android ベンダーチャンネルを使用してメッセージをプッシュする前に、MPS SDK for Android と関連するベンダーチャンネルを統合してください。詳細については、「Android SDK の統合」をご参照ください。また、コンソールの [チャンネル設定] ページで対応するプッシュチャンネルの設定を完了してください。詳細については、「Android プッシュチャンネルの設定」をご参照ください。
操作手順
mPaaS コンソールにログインし、対象のアプリケーションを選択してから、左側のナビゲーションウィンドウで [メッセージプッシュサービス] > [メッセージ管理] を選択します。
[メッセージプッシュタスクの作成] をクリックします。表示されるダイアログボックスで、[シンプルプッシュ] タブを選択します。
[シンプルプッシュ] タブで、プッシュメッセージの基本情報を設定します。パラメーターは以下のとおりです。
パラメーター
必須
説明
メッセージタイプ：サイレント
はい
メッセージを表示するかどうかを指定します。
はい：メッセージはサイレントです。ユーザーはメッセージに気づかず、ターゲットデバイスにいかなる形式でも表示されません。
いいえ：メッセージは通知バーに表示されます。
Android プラットフォームでは、プッシュチャンネルに基づいて異なるフォローアップ操作を実行します。
MPS チャンネル：このパラメーターは参照フィールドとしてクライアントに送信されます。メッセージ本文を解析し、このフィールドの値を取得してから、必要に応じてメッセージ表示を制御する必要があります。
ベンダーチャンネル：このパラメーターがターゲットデバイスに送信されると、ベンダーのシステムがフィールドを解析し、メッセージ表示を制御します。他の操作は必要ありません。
iOS プッシュプラットフォームでは、メッセージの表示は他の操作を必要としないシステムの動作です。
メッセージ内容の作成方法
はい
2 つの作成方法をサポートしています。
作成：タイトル、本文、表示スタイルなど、メッセージ内容をカスタマイズします。
テンプレートを使用：事前に作成されたプッシュテンプレートを使用します。
プッシュテンプレート
はい
メッセージテンプレートを選択します。現在のアプリケーションの [メッセージテンプレート] ページのリストから任意のテンプレートを選択できます。
説明このパラメーターは、[メッセージ内容の作成方法] が [テンプレートを使用] に設定されている場合にのみ必須です。
テンプレートプレースホルダー
はい
テンプレート内の変数の値を入力します。システムは、選択されたテンプレートのプレースホルダーに基づいて設定項目を提供します。
プッシュディメンション
はい
メッセージ配信モードを選択します。オプションは次のとおりです。
ユーザー：ユーザー ID に基づいてメッセージをプッシュします。バインディング API を呼び出して、ユーザー ID をデバイス ID にアタッチする必要があります。バインディング API の詳細については、「クライアント API」をご参照ください。
Android：Android デバイス ID に基づいてメッセージをプッシュします。
iOS：iOS デバイス ID に基づいてメッセージをプッシュします。
ユーザー/デバイス ID
はい
選択したプッシュディメンションに基づいて、対応するユーザー ID またはデバイス ID を入力します。
プッシュディメンションが Android ディメンションの場合、Ad-token を入力します。
プッシュディメンションが iOS ディメンションの場合、Device Token を入力します。
プッシュディメンションがユーザーディメンションの場合、ユーザー ID を入力します。これは、ユーザーがバインディング API を呼び出すときに渡される
useridの値です。ログやその他のソースから取得したデバイス ID にスペースが含まれている場合は、それらを削除する必要があります。
Android メッセージチャンネルのプッシュ優先度
はい
これは Android プラットフォームにのみ適用されます。オプションは次のとおりです。
ベンダーチャンネル優先：システムはベンダーチャンネルを優先してメッセージをプッシュします。統合されたベンダーチャンネルの場合、メッセージは対応するベンダーチャンネルサービスを通じて送信されます。統合されていないベンダーチャンネルの場合、メッセージは MPS 自社構築チャンネルを通じて送信されます。
MPS チャンネル：メッセージは MPS 自社構築チャンネルを使用してプッシュされます。
Android プッシュプラットフォームでは、このパラメーターは MPS チャンネルとベンダーチャンネルのどちらかを選択するために使用されます。iOS および HarmonyOS のプッシュはベンダーチャンネルを通じて送信されるため、これらのプラットフォームではこのパラメーターを設定する必要はありません。
表示スタイル
はい
クライアント上のメッセージの表示スタイルです。サポートされているスタイルは Default、Big Text、および Image with Text です。
デフォルト：このスタイルはプッシュのタイトルとテキストを表示します。シンプルで明確なメッセージに使用します。メッセージテキストは、カスタムパラメーターと記号を含めて 100 文字以内にする必要があります。
ビッグテキスト：このスタイルはプッシュのタイトルとテキストを表示します。ニュースや情報更新など、テキスト量が多いメッセージに使用します。これにより、ユーザーはアプリケーションを開かずに情報をすばやく取得できます。メッセージテキストは、カスタムパラメーターと記号を含めて 256 文字以内にする必要があります。
リッチテキスト：このスタイルは、アイコンと大きな画像を含むメッセージをサポートします。プレーンテキストを超えるリッチなコンテンツに使用します。最適な表示のため、メッセージテキストは 2 行を超えないようにしてください。
説明[メッセージ内容の作成方法] が [作成] の場合にのみ、このパラメーターを設定する必要があります。
メッセージタイトル
はい
メッセージタイトルを入力します。[新規プッシュメッセージ] テキストボックスの右側にあるプレビューエリアで、メッセージが配信された後の表示効果をプレビューできます。
説明[メッセージ内容の作成方法] が [作成] の場合にのみ、このパラメーターは必須です。
メッセージ内容
はい
メッセージ本文を入力します。[新規プッシュメッセージ] テキストボックスの右側にあるプレビューエリアで、メッセージが配信された後の表示効果をプレビューできます。
説明[メッセージ内容の作成方法] が [作成] の場合にのみ、このパラメーターは必須です。
アイコン
いいえ
通知バーのメッセージ内容の右側に表示されるアイコン。JPG、JPEG、PNG 形式をサポートしています。公開アクセス可能なアイコンアセットの URL を入力します。各ベンダーチャンネルにアセットをアップロードせず、デフォルトのアセット URL のみをアップロードした場合、システムは自動的にデフォルトのアセットをプルして各ベンダーチャンネルのアイコンを表示します。ただし、ベンダーチャンネルはアセットに対する要件が異なるため、表示効果の低下を避けるために、各チャンネルに個別にアセットをアップロードすることを推奨します。
デフォルトアイコン：推奨サイズは 140 × 140 px、50 KB 以内。
OPPO アイコン：推奨サイズは 140 × 140 px、50 KB 以内。
Xiaomi アイコン：推奨サイズは 120 × 120 px、50 KB 以内。
Huawei アイコン：推奨サイズは 40 × 40 dp、512 KB 以内。
FCM アイコン：特定の設定要件はありません。システムは自動的にデフォルトアイコンをプルして適応させます。
説明このパラメーターは、[メッセージ内容の作成方法] が [作成] で、[表示スタイル] が [リッチテキスト] に設定されている場合にのみ必須です。
メッセージ大画像
いいえ
通知バーのメッセージ内容の下に表示される画像。公開アクセス可能な大画像アセットの URL を入力します。各ベンダーチャンネルにアセットをアップロードせず、デフォルトのアセット URL のみをアップロードした場合、システムは自動的にデフォルトのアセットをプルして各ベンダーチャンネルの大画像を表示します。ただし、ベンダーチャンネルはアセットに対する要件が異なるため、表示効果の低下を避けるために、各チャンネルに個別にアセットをアップロードすることを推奨します。
デフォルト大画像：推奨サイズは 876 × 324 px、1 MB 以内。JPG、JPEG、PNG 形式をサポートしています。
OPPO 大画像：推奨サイズは 876 × 324 px、1 MB 以内。JPG、JPEG、PNG 形式をサポートしています。
Xiaomi 大画像：推奨サイズは 876 × 324 px、1 MB 以内。JPG、JPEG、PNG 形式をサポートしています。
iOS 大画像：ユーザー定義の画像で、サイズ制限はありません。
FCM 大画像：特定の設定要件はありません。システムは自動的にデフォルトアイコンをプルして適応させます。
説明このパラメーターは、[メッセージ内容の作成方法] が [作成] で、[表示スタイル] が [リッチテキスト] に設定されている場合にのみ必須です。
プッシュ時間
はい
メッセージをプッシュするタイミングを選択します。
今すぐ：メッセージプッシュタスクが作成されるとすぐにメッセージをプッシュします。
スケジュール済み：メッセージをプッシュする時間を指定します。たとえば、6 月 19 日の午前 8:00 にメッセージをプッシュします。
循環：期間内に特定の時間に周期的にメッセージをプッシュします。たとえば、6 月 1 日から 9 月 30 日まで毎週金曜日の午前 8:00 にメッセージをプッシュします。
ダイアログボックスの右側には [プッシュプレビュー] エリアがあります。[通知]、[Apple メッセージ本文]、[Android メッセージ本文]、[HarmonyOS メッセージ本文] をクリックして、メッセージの表示と各プラットフォームに送信されるメッセージ本文をプレビューできます。
(オプション) 必要に応じて詳細設定を行います。詳細設定エリアで、以下の設定を完了します。
クリック後のリダイレクト：ユーザーが携帯電話でメッセージをタップした後に実行される操作を指定します。このパラメーターは参照フィールドとしてクライアントに送信されます。フィールドを参照して後続の操作を実装する必要があります。
Web ページ：ユーザーは Web ページにリダイレクトされます。
カスタムページ：ユーザーはネイティブページにリダイレクトされます。
リダイレクト先アドレス：ユーザーが携帯電話でメッセージをタップした後にアクセスするページ。選択したオプションに従ってアドレスを入力します。
Web ページの場合、アクセスする Web ページの URL を入力します。
カスタムページの場合、アクセスするネイティブページのアドレスを入力します (Android：ActivityName、iOS：VCName)。
カスタムメッセージ ID：カスタムメッセージ ID は、クライアントのシステムでメッセージを一意に識別するためにシステムによって自動的に生成されます。カスタマイズ可能で、最大 64 文字まで許可されます。
- 説明
メッセージタイプがサイレントの場合にのみ、カスタム ID を設定する必要があります。
有効期間：メッセージの有効期間 (秒単位)。デバイスがオフラインであるか、ユーザーがログアウトしているためにメッセージの配信に失敗した場合、MPS は有効期間内にデバイスが再接続するか、ユーザーバインディングリクエストが開始されたときにメッセージを再送信します。これにより、より高い配信率が保証されます。このパラメーターが設定されていない場合、デフォルトの有効期間は 180 秒です。
説明メッセージの有効期間は 180 秒未満または 72 時間を超えることはできません。
拡張パラメーター：スイッチをオンにし、[パラメーターを追加] をクリックしてキー/値を設定し、ページの任意の領域を左クリックして設定を完了します。拡張パラメーターは、メッセージ本文とともにお客様が使用するためにクライアントに渡されます。 拡張パラメーターには、次の 3 種類があります。
システム拡張パラメーター
これらのパラメーターはシステムによって予約されており、その値を変更することはできません。これらには、notifyType、action、silent、pushType、templateCode、channel、taskId が含まれます。
特別な意味を持つシステム拡張パラメーター
これらのパラメーターはシステムによって予約されており、特別な意味を持ちます。これらのパラメーターの値を設定できます。次の表に、これらのパラメーターを示します。
パラメーター
説明
sound
カスタム着信音。パラメーター値は着信音ファイルへのパスです。このパラメーターは、Xiaomi および Apple の携帯電話でのみ有効です。
badge
アプリケーションアイコンのバッジ番号。パラメーター値は特定の数値です。このパラメーターはメッセージ本文とともにクライアントに送信されます。
Android 携帯電話の場合、バッジを実装するためのロジックを処理する必要があります。
Apple 携帯電話の場合、システムが自動的にバッジを実装します。メッセージがターゲットの携帯電話にプッシュされると、アプリケーションアイコンのバッジに設定された値が表示されます。
mutable-content
APNs カスタムプッシュ識別子。プッシュにこのパラメーターを含めると、iOS 10 の
UNNotificationServiceExtensionのサポートを示します。このパラメーターが含まれていない場合は、通常のプッシュです。パラメーター値を1に設定します。badge_add_num
Huawei チャンネルプッシュのバッジに追加する数。
badge_class
Huawei チャンネルのデスクトップアイコンに対応するアプリケーションのエントリ Activity クラス。
big_text
ビッグテキストスタイル。パラメーター値は 1 に固定されています。その他の値は無効です。このパラメーターは、Xiaomi および Huawei の携帯電話でのみ有効です。
ユーザー定義の拡張パラメーター
システム拡張パラメーターまたは特別な意味を持つシステム拡張パラメーターではないパラメーター (キー) は、ユーザー定義の拡張パラメーターです。これらのパラメーターは、メッセージ本文の拡張パラメーターとともにクライアントに送信され、カスタム処理が行われます。
[送信] をクリックします。作成されたメッセージは、シンプルメッセージのレコードリストに表示されます。
API を呼び出してメッセージをプッシュすることもできます。詳細については、「サーバーサイド API リファレンス」をご参照ください。