Mobile Platform as a Service:メッセージの作成 - シンプルプッシュ

シンプルプッシュとは、個人ユーザーまたはデバイスにメッセージをプッシュすることです。このモードでメッセージをプッシュする場合、メッセージをカスタマイズするか、事前定義されたメッセージテンプレートに基づいてメッセージを作成できます。

メッセージのカスタマイズは、Apple Push 証明書の有効期間の検証や Android Push SDK が正しく統合されているかどうかの確認など、少数のターゲットにメッセージをプッシュするシナリオに適用できます。メッセージテンプレートは、複数のターゲットに複数回メッセージをプッシュするシナリオに適しています。つまり、テンプレート機能が自動的に、または広く使用される前に、コンソールからテンプレートベースのメッセージを作成することで、テンプレート機能を検証およびテストすることです。

以下のセクションでは、コンソールでシンプルプッシュメッセージを作成する方法について説明します。

前提条件

• iOS デバイスにメッセージをプッシュするには、MPS iOS SDK を統合し（iOS SDK の統合を参照）、mPaaS コンソールの チャネル構成iOS プッシュチャンネルを構成する ページで iOS プッシュ証明書を設定する必要があります。詳細については、「」をご参照ください。

• Android ベンダーチャネル（サードパーティチャネルとも呼ばれます）を介してメッセージをプッシュするには、MPS Android SDK を統合し（Android SDK の統合を参照）、関連するベンダーチャネルを統合し（ベンダープッシュチャネルの統合を参照）、mPaaS コンソールの チャネル構成チャネル構成 ページで対応するプッシュチャネル設定を完了する必要があります。詳細については、「」をご参照ください。

手順

1. mPaaS コンソールにログインし、ターゲット アプリケーションを選択して、メッセージ プッシュ サービスメッセージ管理 > ページに移動します。

2. メッセージプッシュタスクを作成するシンプルなプッシュ ボタンをクリックし、ポップアップ ダイアログボックスで タブを選択します。

3. シンプルプッシュタブページで、メッセージの基本情報を設定します。設定項目は次のとおりです。

   パラメーター	必須	説明
   メッセージタイプ：サイレントメッセージ	はい	メッセージを表示するかどうか： はい：メッセージはターゲットデバイスに表示されず、ユーザーはメッセージに気づきません。 いいえ：メッセージは通知バーに表示されます。 Android デバイスの場合、選択したプッシュチャネルに応じて異なる操作を実行する必要があります。 MPS チャネル：このパラメーターは参照フィールドとしてクライアントに送信されます。メッセージ本文を解析してこのフィールドのコンテンツを取得し、メッセージの表示を制御する必要があります。 ベンダーチャネル：このパラメーターはフィールドとしてターゲットデバイスに送信されます。デバイスベンダーのシステムはこのフィールドのコンテンツを解析し、メッセージの表示を制御します。他に操作を実行する必要はありません。 iOS デバイスの場合、メッセージの表示はデバイスベンダーのシステムによって制御されます。他に操作を実行する必要はありません。
   メッセージコンテンツ作成方法	はい	次のいずれかの方法でメッセージを作成します。 作成：メッセージのタイトル、本文、表示スタイルなど、メッセージコンテンツをカスタマイズします。 テンプレートを使用：事前定義されたテンプレートを使用します。
   テンプレート	はい	メッセージ テンプレート ページにリストされているテンプレートからメッセージテンプレートを選択します。 説明 テンプレートに基づいてメッセージを作成することを選択した場合にのみ必須です。
   テンプレートプレースホルダー	はい	テンプレートに変数値を入力します。システムは、選択したテンプレートのプレースホルダーの設定オプションを提供します。
   プッシュディメンション	はい	メッセージ配信モードを選択します。 ユーザー：ユーザー ID でメッセージをプッシュします。 bind API を呼び出して、ユーザー ID をデバイス ID にバインドする必要があります。バインド API の詳細については、「クライアント API」をご参照ください。 Android：Android デバイス ID でメッセージをプッシュします。 iOS：iOS デバイス ID でメッセージをプッシュします。
   ユーザー ID/デバイス ID	はい	選択したプッシュディメンションに応じて、対応するユーザー ID またはデバイス ID を入力します。 プッシュディメンションが Android の場合は、Ad-token を入力します。 プッシュディメンションが iOS の場合は、デバイストークンを入力します。 プッシュディメンションがユーザーの場合は、実際のユーザー ID、つまりバインド API を呼び出したときに渡された userid の値を入力します。 ログなどのソースから取得したデバイス ID にスペースがある場合は、スペースを削除する必要があります。
   Android メッセージチャネルのプッシュ優先度	はい	Android プッシュプラットフォームでのみ使用可能です。 ベンダーチャネル優先：ベンダーチャネルが優先されます。ベンダーチャネルが統合されている場合、メッセージは対応するベンダーチャネルを介してプッシュされます。アプリケーションにベンダーチャネルが統合されていない場合、メッセージは MPS 自己構築チャネルを介してプッシュされます。 MPS チャネル：MPS は自己構築チャネルを使用してメッセージをプッシュします。 Android デバイスの場合、このパラメーターは、MPS 自己構築チャネルまたはベンダーチャネルのどちらを介してメッセージをプッシュするかを指定します。 iOS デバイスの場合、このパラメーターを設定する必要はありません（iOS プッシュはベンダーチャネルプッシュに属します）。
   表示スタイル	はい	クライアントにメッセージを表示する方法のスタイル。次の 3 つのスタイルのいずれかを選択できます。デフォルト（短いテキスト）、大きなテキスト、リッチテキスト。 デフォルト：このスタイルは、簡潔で明確なコンテンツのメッセージに適しています。このスタイルのメッセージには、タイトルとテキストのみが含まれています。メッセージテキストの長さは、カスタムパラメーターと記号を含め、100 文字以内にすることをお勧めします。 大きなテキスト：このスタイルは、情報やニュースメッセージなど、長いテキストのメッセージに適しており、ユーザーはアプリケーションを開かずに情報をすばやく取得できます。このスタイルのメッセージには、タイトルとテキストのみが含まれています。メッセージテキストの長さは、カスタムパラメーターと記号を含め、256 文字以内にすることをお勧めします。 リッチテキスト：このスタイルは、アイコンと画像を含むメッセージをサポートしており、さまざまなコンテンツのメッセージに適しています。メッセージの表示効果を良くするために、テキストは 2 行以内にすることをお勧めします。
   メッセージタイトル	はい	メッセージのタイトルを 200 文字以内で入力します。メッセージの表示効果はプレビューエリアでプレビューできます。
   メッセージコンテンツ	はい	メッセージ本文を 200 文字以内で入力します。メッセージの表示効果はプレビューエリアでプレビューできます。
   アイコン	いいえ	メッセージの右側に表示されるアイコン。 JPG、JPEG、または PNG 画像を使用できます。アイコンの公開アクセス可能な URL をここに入力します。 対応するベンダーチャネルに素材がアップロードされていない状態でデフォルトのアイコン URL のみを指定した場合、デフォルトのアイコンが自動的にプルされ、ベンダーチャネルを介してプッシュされるメッセージに使用されます。ベンダーチャネルごとにアイコン素材の要件が異なるため、各ベンダーチャネルの要件に従って素材を個別にアップロードすることをお勧めします。 デフォルトアイコン：推奨サイズは 140 * 140px で、50 KB を超えないようにしてください。 OPPO アイコン：推奨サイズは 140 * 140px で、50 KB を超えないようにしてください。 Xiaomi アイコン：推奨サイズは 120 * 120px で、50 KB を超えないようにしてください。 Huawei アイコン：推奨サイズは 40 * 40dp で、512 KB を超えないようにしてください。 FCM アイコン：特別な要件がない場合は、デフォルトのアイコンが自動的に使用されます。
   大きな画像	いいえ	メッセージの下部に表示される画像。 JPG、JPEG、または PNG 画像を使用できます。画像の公開アクセス可能な URL をここに入力します。 対応するベンダーチャネルに素材がアップロードされていない状態でデフォルトの画像 URL のみを指定した場合、デフォルトの大きな画像が自動的にプルされ、ベンダーチャネルを介してプッシュされるメッセージに使用されます。ベンダーチャネルごとに画像の要件が異なるため、各ベンダーチャネルの要件に従って素材を個別にアップロードすることをお勧めします。 デフォルトの大きな画像：推奨サイズは 876 * 324px で、1 MB を超えないようにしてください。 OPPO の大きな画像：推奨サイズは 876 * 324px で、1 MB を超えないようにしてください。 Xiaomi の大きな画像：推奨サイズは 876 * 324px で、1 MB を超えないようにしてください。 iOS の大きな画像：カスタム画像をサポートしており、画像サイズに制限はありません。 FCM の大きな画像：特別な要件がない場合は、デフォルトの画像が自動的に使用されます。
   プッシュモード	はい	メッセージをプッシュする時間を選択します。 今すぐ：メッセージプッシュタスクが作成されるとすぐにメッセージをプッシュします。 スケジュール済み：メッセージをプッシュする時間を指定します。たとえば、6 月 19 日の午前 8 時にメッセージをプッシュします。 循環：一定期間内、特定の時間にメッセージを循環的にプッシュします。たとえば、6 月 1 日から 9 月 30 日までの毎週金曜日の午前 8 時にメッセージをプッシュします。

   プレビューエリアは、メッセージ作成ウィンドウの右側にあります。プラットフォームごとのメッセージ表示効果をプレビューするには、通知iOS メッセージ本文Android メッセージ本文、、 をクリックします。

4. (オプション) 必要に応じて詳細情報を設定します。詳細情報 領域で、次の設定を行います。

   • クリック時にリダイレクト：ユーザーが携帯電話でメッセージをタップした後に実行される操作を指定します。このパラメーターは参照フィールドとしてクライアントに送信されます。フィールドを参照して後続の操作を実装する必要があります。

     • 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 携帯電話と iPhone でのみ有効です。
       badge	バッジ番号。その値は特定の番号です。この拡張パラメーターは、メッセージ本文とともにクライアントに渡されます。 Android デバイスの場合、バッジロジックを自分で実装する必要があります。 iOS デバイスの場合、iOS システムはバッジロジックを自動的に実装します。メッセージがターゲットの携帯電話にプッシュされると、値で指定した番号がアプリケーションアイコンのバッジに表示されます。
       mutable-content	APNs カスタムプッシュ識別子。プッシュされたメッセージにこのパラメーターが含まれている場合、iOS10 の UNNotificationServiceExtension がサポートされていることを示し、そうでない場合は通常のプッシュです。値は 1 に設定されています。
       badge_add_num	累積バッジ番号。Huawei チャネルでのみ使用可能です。
       badge_class	Huawei チャネルのデスクトップアプリケーションアイコンに対応するアクティビティクラス。
       big_text	大きなテキストスタイル。値は 1 に固定されており、他の値は無効です。このパラメーターは、Xiaomi 携帯電話と Huawei 携帯電話でのみ有効です。

     • ユーザー定義の拡張パラメーター

       システム拡張パラメーターと、ある程度の重要性を持つシステム拡張パラメーター以外のパラメーターはすべて、ユーザー定義の拡張パラメーターです。ユーザー定義の拡張パラメーターは、メッセージ本文とともにクライアントに渡されて使用されます。

5. [送信] をクリックして、メッセージの作成を完了します。新しいメッセージはシンプルなプッシュレコードに表示されます。

コンソール操作に加えて、関連 API を呼び出すことによってもメッセージをプッシュできます。詳細については、「サーバー API」をご参照ください。

関連操作

• メッセージの作成 – 複数プッシュ

• API を呼び出してメッセージをプッシュする

• メッセージの管理