mPaaS Message Push は現在、新しいコンソールを使用しています。[メッセージプッシュタスクの作成] ウィンドウのプッシュメソッドが合理化されました。以前の 4 つのメソッド (シンプルプッシュ、テンプレートプッシュ、マルチプッシュ、ブロードキャストプッシュ) は、シンプルプッシュとマルチプッシュの 2 つに統合されました。新しいシンプルプッシュメソッドには、元のシンプルプッシュとテンプレートプッシュの機能が含まれています。新しいマルチプッシュメソッドには、元のマルチプッシュとブロードキャストプッシュの機能が含まれています。
マルチプッシュは、複数のターゲットにメッセージを送信するためのメソッドです。主に運用上のニーズに使用されます。
マルチプッシュには 2 種類あります:
ブロードキャストプッシュ: アプリケーションのすべての Android または iOS デバイスに同じテンプレートメッセージを送信します。このメソッドは、デバイス単位でのメッセージのプッシュのみをサポートします。メッセージをブロードキャストすると、メッセージの有効期間内に次の条件を満たすすべてのデバイスで受信されます。接続を確立する Android デバイス、およびアタッチされた iOS デバイス。
ターゲットプッシュ:特定のオーディエンスグループに同じテンプレートメッセージを送信します。オーディエンスファイルを手動でアップロードしたり、カスタムオーディエンスを定義したり、Mobile Analysis のオーディエンスグループを直接使用したりできます。
これらの操作は手動で行われるため、コンソールはシステム検証、運用サポート、緊急の一時的なニーズなど、低頻度のシナリオでのメッセージプッシュに最適です。
メッセージが作成されると、すぐにプッシュされます。削除または変更することはできません。
このトピックでは、コンソールでマルチプッシュメッセージを作成する方法について説明します。
前提条件
iOS デバイスにメッセージをプッシュする前に、Message Push の iOS SDK を統合していることを確認してください。また、コンソールの [チャンネル設定] ページで Apple デバイスのプッシュ証明書を構成する必要もあります。詳細については、「iOS プッシュチャンネルの構成」をご参照ください。
Android ベンダーチャンネルを使用してメッセージをプッシュする前に、Message Push の Android SDK と対応するベンダーチャンネルを統合していることを確認してください。また、コンソールの [チャンネル設定] ページでプッシュチャンネルの構成を完了する必要もあります。詳細については、「Android プッシュチャンネルの構成」をご参照ください。
マルチプッシュメッセージを作成する前に、テンプレートを作成する必要があります。詳細については、「テンプレートの作成」をご参照ください。
マルチプッシュメッセージを作成し、Mobile Analysis のオーディエンスグループをターゲットにする場合は、まずオーディエンスグループを作成する必要があります。詳細については、「オーディエンスグループの作成」をご参照ください。ユーザータググループをターゲットにする場合は、まずユーザータググループを作成する必要があります。詳細については、「ユーザータグの作成」をご参照ください。
操作手順
mPaaS コンソールにログインし、対象のアプリケーションを選択します。左側のナビゲーションウィンドウで、[Message Push Service] > [メッセージ管理] を選択します。
[メッセージプッシュタスクの作成] をクリックします。表示されるダイアログボックスで、[マルチプッシュ] タブを選択します。
[マルチプッシュ] タブで、プッシュメッセージの基本情報を構成します。構成項目は次のとおりです:
パラメーター
必須
説明
メッセージタイプ:サイレントメッセージ
はい
メッセージを表示するかどうかを指定します:
はい:メッセージはサイレントです。ユーザーはメッセージに気づかず、ターゲットデバイスには表示されません。
いいえ:メッセージは通知バーに表示されます。
Android プラットフォームの場合、プッシュチャンネルに基づいて異なるフォローアップ操作を実行する必要があります:
MPS チャンネル:このパラメーターは参照フィールドとしてクライアントに送信されます。メッセージ本文を解析し、このフィールドを使用してメッセージの表示を制御する必要があります。
ベンダーチャンネル: このパラメーターはターゲットデバイスに送信されます。ベンダーのシステムがフィールドを解析し、メッセージの表示をコントロールします。他の操作は必要ありません。
iOS プラットフォームでは、メッセージの表示はベンダーのシステムによって処理されます。他の操作は不要です。
プッシュディメンション
はい
メッセージ配信モードを選択します。オプションは次のとおりです:
ユーザー:ユーザー ID に基づいてメッセージをプッシュします。アタッチ API を呼び出して、ユーザー ID をデバイス ID にアタッチする必要があります。アタッチ API の詳細については、「クライアント API」をご参照ください。
デバイス:デバイス ID に基づいてメッセージをプッシュします。
プッシュプラットフォーム
はい
デバイスごとにメッセージをプッシュする場合、デバイスタイプを指定するためにプッシュプラットフォームを選択する必要があります。
Android:Android ベンダーチャンネルと MPS 自己構築チャンネルを提供します。ネットワーク上のすべてのオンライン Android デバイス (メッセージの有効期間内) または指定された Android デバイスにメッセージをプッシュします。各デバイスはメッセージを 1 回だけ受信します。
iOS:ベンダーチャンネルを使用して、すべてのまたは指定された iOS クライアントユーザーにメッセージをプッシュします。各ユーザーはメッセージを 1 回だけ受信します。
プッシュターゲットの選択
はい
ユーザーにディメンションをプッシュする場合、次のオプションが利用可能です:
グループのアップロード:ターゲットユーザーのファイルを手動でアップロードします。ファイルには、選択したテンプレートに基づいて各ターゲットのターゲット ID とパーソナライズされた構成が含まれている必要があります。ファイルの各行は 1 つのメッセージを表し、各メッセージはビジネスメッセージ ID によって識別されます。ファイルの形式要件は次のとおりです:
各行は
ユーザー ID,ビジネスメッセージ ID,placeholder1=XXX;placeholder2=XXX...の形式である必要があります。ビジネスメッセージ ID はユーザー定義です。ファイルは UTF-8 でエンコードされている必要があります。最大ファイルサイズは 200 MB です。複数のデータエントリを区切るには改行を使用します。各エントリは 250 文字を超えることはできません。プッシュタスクごとに最大 1 つのファイルをアップロードできます。
ファイルがアップロードされると、[アップロード] ボタンの下にアップロードされたファイルのアイコンが表示されます。アイコンをクリックしてファイルの内容をプレビューします。最大 10 件のデータエントリをプレビューできます。
MAS グループ:Mobile Analysis のオーディエンスグループを使用して、すべてのメンバーに同じメッセージを送信します。まず、Mobile Analysis のオーディエンスグループを作成する必要があります。詳細については、「オーディエンスグループの作成」をご参照ください。選択したプッシュテンプレートにプレースホルダーが含まれている場合、このオプションは利用できません。
ユーザータグ:ユーザータグに基づいてオーディエンスグループを選択します。タグ付けされたオーディエンスを選択する前に、まずユーザータグを作成する必要があります。
デバイスごとにプッシュする場合は、次を選択できます:
すべてのデバイス:選択したプラットフォームのすべてのデバイスにメッセージをプッシュします。
一部のデバイス:ターゲットデバイスのファイルを手動でアップロードします。ファイルには、選択したテンプレートに基づいて各ターゲットのターゲット ID とパーソナライズされた構成が含まれている必要があります。ファイルの各行は 1 つのメッセージを表し、各メッセージはビジネスメッセージ ID によって識別されます。ファイルの形式要件は次のとおりです:
各行は
デバイス ID,ビジネスメッセージ ID,placeholder1=XXX,placeholder2=XXX...の形式である必要があります。ビジネスメッセージ ID はユーザー定義です。ファイルは UTF-8 でエンコードされている必要があります。最大ファイルサイズは 200 MB です。複数のデータエントリを区切るには改行を使用します。各エントリは 250 文字を超えることはできません。プッシュタスクごとに最大 1 つのファイルをアップロードできます。
例:mpaas_push_demo,123456,title=111,content=222。
ファイルがアップロードされると、[アップロード] ボタンの下にアップロードされたファイルのアイコンが表示されます。アイコンをクリックしてファイルの内容をプレビューします。最大 10 件のデータエントリをプレビューできます。
MAS グループ:Mobile Analysis のオーディエンスグループを使用して、すべてのメンバーに同じメッセージを送信します。まず、Mobile Analysis のオーディエンスグループを作成する必要があります。詳細については、「オーディエンスグループの作成」をご参照ください。選択したプッシュテンプレートにプレースホルダーが含まれている場合、このオプションは利用できません。
プッシュテンプレート
はい
メッセージテンプレートを選択します。現在のアプリケーションの [メッセージテンプレート] ページから任意のテンプレートを選択できます。
テンプレートプレースホルダー
はい
テンプレート内の変数の値を入力します。システムは、選択したテンプレートのプレースホルダーに基づいて構成フィールドを提供します。
Android メッセージチャンネルのプッシュ優先度
はい
これは Android プラットフォームにのみ適用されます。オプションは次のとおりです:
ベンダーチャンネル優先:最初にベンダーチャンネルを通じてメッセージをプッシュします。統合されたベンダーチャンネルの場合、メッセージは対応するベンダーチャンネルサービスを通じて送信されます。統合されていないベンダーチャンネルの場合、メッセージは MPS 自己構築チャンネルを通じて送信されます。
MPS チャンネル:MPS 自己構築チャンネルを通じてメッセージをプッシュします。
Android プラットフォームの場合、このパラメーターを使用すると、自己構築チャンネルとベンダーチャンネルのどちらかを選択できます。iOS のプッシュはベンダーチャンネルを使用するため、iOS プラットフォームではこのパラメーターを構成する必要はありません。
プッシュモード
はい
メッセージをプッシュするタイミングを選択します:
今すぐ:プッシュタスクが作成されるとすぐにメッセージがプッシュされます。
スケジュール済み:指定した時間にメッセージをプッシュします。たとえば、6 月 19 日午前 8 時にメッセージをプッシュするようにスケジュールできます。
循環:指定した時間範囲内でメッセージを繰り返しプッシュします。たとえば、6 月 1 日から 9 月 30 日まで毎週金曜日の午前 8 時にメッセージをプッシュするようにスケジュールできます。
重要プッシュターゲットが Mobile Analysis のオーディエンスまたはカスタムタグオーディエンスの場合、スケジュール済みおよび定期的なプッシュはサポートされていません。
ダイアログボックスの右側には、[プッシュプレビュー] エリアがあります。[通知]、[Apple メッセージ本文]、および [Android メッセージ本文] をクリックして、各プラットフォームのメッセージ表示とメッセージ本文をプレビューできます。
(オプション) 以下の詳細設定を構成します:
クリック時のリダイレクト:ユーザーが携帯電話でメッセージをタップした後に実行される操作を指定します。このパラメーターは参照フィールドとしてクライアントに送信されます。このフィールドを参照して後続の操作を実装する必要があります。
Web ページ:ユーザーは Web ページにリダイレクトされます。
カスタムページ:ユーザーはネイティブページにリダイレクトされます。
リダイレクトアドレス:ユーザーが携帯電話でメッセージをタップした後にアクセスするページ。選択したオプションに従ってアドレスを入力します。
Web ページの場合は、アクセスする Web ページの URL を入力します。
カスタムページの場合は、アクセスするネイティブページのアドレスを入力します (Android:ActivityName、iOS:VCName)。
ログインステータス:ログインステータスに応じてターゲットユーザーを指定します。ログイン/ログアウト期間を選択する場合、[永続] は時間制限なしを意味し、すべてのログイン/ログアウトユーザーにメッセージをプッシュします。
- 重要
ログインステータスによるプッシュは、デバイスごとにプッシュする場合にのみ構成できます。
[ログインユーザー] を選択すると、MPS は指定された期間内にアプリにログインしたユーザーにメッセージをプッシュします。たとえば、ログイン期間が 15 日の場合、最近 15 日間にアプリにログインしたユーザーにメッセージをプッシュすることを意味します。
[ログアウトユーザー] を選択すると、MPS は指定された期間内にアプリからログアウトしたユーザーにメッセージをプッシュします。たとえば、ログアウト期間が 15 日の場合、最近 15 日間にログアウトしたユーザーにメッセージをプッシュすることを意味します。
[ログインユーザー] と [ログアウトユーザー] の両方を選択すると、MPS は指定された期間内にアプリにログインし、ログアウトしたユーザーにメッセージをプッシュします。たとえば、ログイン期間が永続でログアウト期間が 7 日の場合、すべてのログインユーザーと最近 7 日間にログアウトしたユーザーにメッセージをプッシュすることを意味します。
カスタムメッセージ ID:システムは、ビジネスロジックのためにメッセージを一意に識別する ID を自動的に生成します。この ID は最大 64 文字でカスタマイズできます。
有効期間:メッセージの有効期間 (秒単位)。デバイスがオフラインであるか、ユーザーがログオフしているためにメッセージの配信に失敗した場合、MPS はこの期間内にデバイスが接続するか、ユーザーのアタッチリクエストが開始された後にメッセージを再送信します。これにより、メッセージの配信率が向上します。このパラメーターを設定しない場合、デフォルトの有効期間は 180 秒です。
説明メッセージの有効期間は 180 秒以上 72 時間以内でなければなりません。
拡張パラメーター:拡張パラメーターを追加するには、[拡張パラメーター] スイッチをオンにし、[パラメーターの追加] をクリックして、キーと値のペアを構成します。ページ上の任意の場所をクリックして構成を完了します。拡張パラメーターは、カスタム処理のためにメッセージ本文とともにクライアントに送信されます。拡張パラメーターには 3 種類あります:
システム拡張パラメーター
これらのパラメーターはシステムによって予約されており、その値を変更することはできません。これらには、notifyType、action、silent、pushType、templateCode、channel、および taskId が含まれます。
特別な意味を持つシステム拡張パラメーター
これらのパラメーターはシステムによって予約されており、特別な意味を持ちます。これらのパラメーターの値を構成できます。次の表に、これらのパラメーターを示します。
パラメーター
説明
sound
カスタム着信音。値を着信音ファイルのパスに設定します。このパラメーターは、Xiaomi および Apple の携帯電話でのみ有効です。
badge
アプリケーションアイコンのバッジ番号。値を特定の数値に設定します。このパラメーターは、メッセージ本文とともにクライアントに送信されます。
Android 携帯電話の場合、バッジのロジックを実装する必要があります。
Apple 携帯電話の場合、システムが自動的にバッジを処理します。メッセージがターゲットの携帯電話にプッシュされると、アプリケーションアイコンのバッジに構成された値が表示されます。
mutable-content
APNs のカスタムプッシュ識別子。このパラメーターを含めると、iOS10 の
UNNotificationServiceExtensionがサポートされることを示します。このパラメーターが含まれていない場合は、通常のプッシュです。値を 1 に設定します。badge_add_num
Huawei チャンネル経由のプッシュでバッジに追加する番号。
badge_class
Huawei チャンネルのデスクトップアイコンに対応するアプリケーションのエントリ Activity クラス。
big_text
ビッグテキストスタイル。値は 1 である必要があります。他の値は無効です。このパラメーターは、Xiaomi および Huawei の携帯電話でのみ有効です。
ユーザー定義の拡張パラメーター
システム拡張パラメーターまたは特別な意味を持つシステム拡張パラメーターではないパラメーター (キー) は、ユーザー定義の拡張パラメーターです。ユーザー定義の拡張パラメーターは、カスタム処理のためにメッセージ本文とともにクライアントに送信されます。
[送信] をクリックします。作成されたメッセージは、バッチメッセージのレコードリストに表示されます。
コンソールからのメッセージプッシュに加えて、API を呼び出してメッセージをプッシュすることもできます。詳細については、「サーバーサイド API リファレンス」をご参照ください。