2022年 3月 18日より、mPaaS MPS コンソールがアップグレードされました。新しいコンソールでは、プッシュタイプが以前の 4タイプ（シンプルプッシュ、テンプレートプッシュ、一括プッシュ、ブロードキャストプッシュ）から 2タイプ（シンプルプッシュと一括プッシュ）に統合および最適化されました。アップグレードされたシンプルプッシュは、元のシンプルプッシュとテンプレートプッシュの機能を網羅しています。アップグレードされた一括プッシュは、元の一括プッシュとブロードキャストプッシュの機能を網羅しています。
一括プッシュは、主に運用上のニーズに合わせて多数のユーザーにメッセージをプッシュするために使用されます。
一括プッシュは、ネットワーク全体プッシュとネットワーク全体以外プッシュに分類されます。
ネットワーク全体プッシュとは、同じテンプレートベースのメッセージをすべての Android および iOS ネットワーキングデバイスにプッシュすることで、デバイスごとのプッシュのみをサポートします。
Android デバイスにメッセージをプッシュすると、メッセージの有効期間中に接続されているすべての Android デバイスがメッセージを受信できます。iOS デバイスにメッセージをプッシュすると、メッセージの有効期間中にバインドされているすべての iOS デバイスがメッセージを受信できます。
ネットワーク全体以外プッシュとは、同じテンプレートベースのメッセージを指定されたユーザーグループにプッシュすることです。
メッセージ受信者のグループを手動でアップロードしたり、タグ付きユーザーグループをカスタマイズしたり、MAS グループを使用したりできます。
メッセージは作成後すぐにプッシュされます。削除または変更することはできません。
手動操作が必要となるため、システム検証、運用サポート、一時的な緊急要件など、低頻度のメッセージプッシュが必要なシナリオでは、コンソールからメッセージをプッシュすることをお勧めします。
以下のセクションでは、コンソールで一括プッシュメッセージを作成する方法について説明します。
前提条件
iOS デバイスにメッセージをプッシュするには、MPS iOS SDK を統合し（iOS SDK の統合を参照）、mPaaS コンソールの チャネル構成iOS プッシュチャンネルを構成する ページで iOS プッシュ証明書を設定する必要があります。詳細については、「」をご参照ください。
Android ベンダーチャネル（サードパーティチャネルとも呼ばれます）を介してメッセージをプッシュするには、MPS Android SDK を統合し（Android SDK の統合を参照）、関連するベンダーチャネルにアクセスし（ベンダープッシュチャネルの統合を参照）、mPaaS コンソールの チャネル構成チャネル構成 ページで対応するプッシュチャネル設定を完了する必要があります。詳細については、「」をご参照ください。
一括プッシュタスクを作成する前に、テンプレートを準備する必要があります。テンプレートの作成方法については、「メッセージテンプレートの作成」をご参照ください。
一括プッシュタスクを作成するときに、ターゲットオーディエンスとして MAS グループを呼び出すことを選択した場合は、事前に MAS グループを作成する必要があります。詳細については、「ユーザーグループの作成」をご参照ください。タグ付きユーザーグループをターゲットオーディエンスとして選択した場合は、事前にタグ付きユーザーグループを作成する必要があります。詳細については、「ユーザタグの作成」をご参照ください。
手順
mPaaS コンソールにログインし、ターゲット アプリを選択して、メッセージ プッシュ サービスメッセージ管理 > ページに移動します。
メッセージプッシュタスクを作成する複数プッシュ ボタンをクリックし、ポップアップ [ダイアログボックス] で、 タブを選択します。
一括プッシュタブページで、メッセージの基本情報を設定します。設定項目は次のとおりです。
パラメーター
必須
説明
メッセージタイプ：サイレントメッセージ
はい
メッセージを表示するかどうか：
はい：メッセージはターゲットデバイスに表示されず、ユーザーはメッセージに気づきません。
いいえ：メッセージは通知バーに表示されます。
Android デバイスの場合、選択したプッシュチャネルに応じて異なる操作を実行する必要があります。
MPS チャネル：このパラメーターは参照フィールドとしてクライアントに送信されます。メッセージ本文を解析してこのフィールドのコンテンツを取得し、メッセージの表示を制御する必要があります。
ベンダーチャネル：このパラメーターはフィールドとしてターゲットデバイスに送信されます。デバイスベンダーのシステムはこのフィールドのコンテンツを解析し、メッセージの表示を制御します。他に操作を実行する必要はありません。
iOS デバイスの場合、メッセージの表示はデバイスベンダーのシステムによって制御されます。他に操作を実行する必要はありません。
プッシュディメンション
はい
メッセージ配信モードを選択します。
ユーザー：ユーザー ID でメッセージをプッシュします。bind API を呼び出して、ユーザー ID とデバイス ID をバインドする必要があります。バインド API の詳細については、「クライアント API」をご参照ください。
デバイス：デバイス ID でメッセージをプッシュします。
プッシュプラットフォーム
はい
[デバイス] をプッシュ ディメンションとして選択すると、プッシュ プラットフォームを選択してターゲット デバイスのタイプを指定する必要があります。
Android：MPS は、ベンダーチャネルと MPS 自己構築チャネルを提供して、ネットワーク全体のオンライン Android デバイス（有効期間内）または指定された Android デバイスにメッセージをプッシュします。メッセージはデバイスごとに 1回だけプッシュされます。
iOS：ベンダーチャネルを使用して、ネットワーク全体または指定された iOS デバイスにメッセージをプッシュします。メッセージはデバイスごとに 1回だけプッシュされます。
プッシュターゲットの選択
はい
ユーザー をプッシュディメンションとして選択した場合、次のオプションがあります。
グループをアップロードする: 選択したテンプレートに基づいて、ターゲット ID と各ターゲット ID のパーソナライズされた構成を含むファイルをアップロードします。ファイル内の各データレコードは 1 つのメッセージを表し、顧客メッセージ ID によって識別されます。ファイル形式の要件は次のとおりです。
各データレコードの形式：
target ID,customer message ID,placeholder 1=XXX;placeholder 2=XXX…。顧客メッセージ ID はユーザーがカスタマイズできます。ファイルのエンコードタイプは UTF-8 でなければならず、最大ファイルサイズは 200 MB です。複数のデータレコードは改行で区切ります。各データレコードの長さは 1～250 文字でなければなりません。1 つのプッシュタスクでアップロードできるファイルは 1つだけです。
ファイルが正常にアップロードされると、そのアイコンが アップロード ボタンの下に表示されます。アイコンをクリックすると、ファイルの最大 10 個のデータレコードをプレビューできます。
MAS グループ: MAS グループを呼び出し、指定されたグループユーザーに同じメッセージをプッシュします。最初に MAS グループを作成する必要があります。詳細については、「ユーザーグループを作成する」をご参照ください。メッセージテンプレートにプレースホルダーが含まれている場合、このオプションは使用できません。
ユーザー タグ: タグでターゲット グループを選択します。最初にタグ付きユーザー グループを作成する必要があります。詳細については、「ユーザー タグを作成する」をご参照ください。
デバイス をプッシュ ディメンションとして選択した場合、次のオプションを使用できます。
すべてのデバイス: 選択したプラットフォームのすべてのデバイスにメッセージをプッシュします。
一部のデバイス: 選択したテンプレートに基づいて、ターゲット ID と各ターゲット ID のパーソナライズされた構成を含むファイルをアップロードします。ファイル内のすべてのデータレコードはメッセージを表し、顧客メッセージ ID によって識別されます。ファイル形式の要件は次のとおりです。
各データレコードの形式：
target ID,customer message ID,placeholder 1=XXX;placeholder 2=XXX…。顧客メッセージ ID はユーザーがカスタマイズできます。ファイルのエンコードタイプは UTF-8 でなければならず、最大ファイルサイズは 200 MB です。複数のデータレコードは改行で区切ります。各データレコードの長さは 1～250 文字でなければなりません。1 つのプッシュタスクでアップロードできるファイルは 1つだけです。
ファイルが正常にアップロードされると、そのアイコンが アップロード ボタンの下に表示されます。アイコンをクリックすると、ファイルの最大 10 個のデータレコードをプレビューできます。
MAS グループ: MAS グループを呼び出し、同じメッセージを指定されたグループユーザーにプッシュします。最初に MAS グループを作成する必要があります。詳細については、「ユーザーグループを作成する」をご参照ください。メッセージテンプレートにプレースホルダーが含まれている場合、このオプションは使用できません。
テンプレート
はい
メッセージ テンプレート ページにリストされているテンプレートからメッセージ テンプレートを選択します。
テンプレートプレースホルダー
はい
テンプレートに変数値を入力します。システムは、選択したテンプレートのプレースホルダーの設定オプションを提供します。
Android メッセージチャネルのプッシュ優先度
はい
Android プッシュプラットフォームでのみ使用可能です。
ベンダーチャンネル優先: ベンダーチャンネルが優先されます。ベンダーチャンネルが統合されている場合、メッセージは対応するベンダーチャンネルを介してプッシュされます。アプリにベンダーチャンネルが統合されていない場合、メッセージは MPS 自己構築チャンネルを介してプッシュされます。
MPS チャンネル: MPS は独自のチャンネルを使用してメッセージをプッシュします。
Android デバイスの場合、このパラメーターは、MPS 自己構築チャネルまたはベンダーチャネルのどちらを介してメッセージをプッシュするかを指定します。iOS デバイスの場合、このパラメーターを設定する必要はありません（iOS プッシュはベンダーチャネルプッシュに属します）。
プッシュモード
はい
メッセージをプッシュする時刻を選択します。
今すぐ: メッセージプッシュタスクが作成されると、すぐにメッセージをプッシュします。
スケジュール: メッセージをプッシュする時間を指定します。たとえば、6 月 19 日の午前 8 時 00 分にメッセージをプッシュします。
繰り返し: 一定期間内に特定の時間にメッセージを繰り返しプッシュします。たとえば、6 月 1 日から 9 月 30 日までの毎週金曜日の午前 8 時 00 分にメッセージをプッシュします。
プレビューエリアは、メッセージ作成 [ウィンドウ] の右側にあります。異なるプラットフォームのメッセージ表示効果をそれぞれプレビューするには、通知iOS メッセージ本文Android メッセージ本文、、 をクリックします。
（オプション）必要に応じて詳細情報を設定します。詳細情報 エリアで、次の設定を行います。
クリック時のリダイレクト: ユーザーが電話でメッセージをタップした後に実行される操作を指定します。このパラメーターは、参照フィールドとしてクライアントに送信されます。フィールドを参照して後続の操作を実装する必要があります。
Web ページ: ユーザーは Web ページにリダイレクトされます。
カスタム ページ: ユーザーはネイティブ ページにリダイレクトされます。
リダイレクトアドレス: ユーザーがモバイルフォンでメッセージをタップした後にアクセスするページ。選択したオプションに応じてアドレスを入力します。
Web ページの場合は、アクセスする Web ページの URL を入力します。
カスタムページの場合は、アクセスするネイティブページのアドレスを入力します（Android：ActivityName、iOS：VCName）。
ログイン ステータス: ログイン ステータスに基づいてターゲット ユーザーを指定します。ログイン/ログアウト期間を選択する場合、永続的とは時間制限がないことを意味し、すべてのログイン/ログアウト ユーザーにメッセージをプッシュします。
重要Android プッシュプラットフォームを使用して MPS 自己構築チャネルを介してメッセージをプッシュする場合、ログインステータスは設定できません。
[ログイン ユーザー] を選択した場合、MPS は指定された期間にアプリにログインしたユーザーにメッセージをプッシュします。たとえば、ログイン期間が 15 日の場合、過去 15 日間にアプリにログインしたユーザーにメッセージをプッシュすることを意味します。
[ユーザーのログアウト] を選択すると、MPS は指定された期間にアプリからログアウトしたユーザーにメッセージをプッシュします。たとえば、ログアウト期間が 15 日の場合、過去 15 日間にログアウトしたユーザーにメッセージをプッシュすることを意味します。
ログインユーザー と ログアウトユーザー の両方を選択した場合、MPS は指定された期間にアプリにログインしたユーザーとログアウトしたユーザーにメッセージをプッシュします。たとえば、ログイン期間が永続的でログアウト期間が 7 日の場合、すべてのログインユーザーと最近 7 日間にログアウトしたユーザーにメッセージをプッシュすることを意味します。
カスタム メッセージ ID: カスタム メッセージ ID は、クライアント システム内のメッセージを一意に識別するために、システムによって自動的に生成されます。カスタマイズが可能で、最大 64 文字まで使用できます。
有効期間: メッセージの有効期間を秒単位で指定します。デフォルトは 180 秒です。メッセージの到達率を確保するために、デバイスがオフラインであるかユーザーがログアウトしているためにメッセージの送信に失敗した場合、MPS はデバイスが接続された後、またはメッセージの有効期間内にユーザーバインディングリクエストが開始された後にメッセージを再送信します。
拡張パラメーターパラメーターを追加：スイッチをオンにし、 をクリックし、キーと値を設定し、ページの任意の領域を左クリックして設定を完了します。拡張パラメーターは、メッセージ本文とともにクライアントに渡されて使用されます。
拡張パラメーターには、次の 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 電話でのみ有効です。
ユーザー定義の拡張パラメーター
システム拡張パラメーターと、ある程度の重要性を持つシステム拡張パラメーター以外のパラメーターはすべて、ユーザー定義の拡張パラメーターです。ユーザー定義の拡張パラメーターは、メッセージ本文とともにクライアントに渡されて使用されます。
[送信] をクリックして、メッセージの作成を完了します。新しいメッセージは複数のプッシュレコードに表示されます。
コンソール操作に加えて、関連 API を呼び出すことによってもメッセージをプッシュできます。詳細については、「サーバー API」をご参照ください。