プッシュの作成

本記事では、Engagelab コンソールで通知メッセージを作成する方法をご案内します。

通知メッセージの作成

【プッシュ】-【プッシュ作成】-【通知メッセージ】ページからプッシュタスクを作成します。パラメータの設定説明は以下の通りです：

基本設定

• 対象プラットフォーム：SDK を統合したプラットフォームに基づき、プッシュ対象のプラットフォームを選択します。
  • プラットフォーム選択前に【プッシュ設定】で対応プラットフォームの設定が必要です。
  • サブアカウントはメインアカウントが許可したプラットフォームのみ選択可能です。
• 通知タイトル：プッシュメッセージのタイトルです。「test、テスト、純数字」などの無意味な内容は避けてください。メーカーにブロックされ、通知が届かない場合があります。
• 通知内容：プッシュメッセージの本文です。「test、テスト、純数字」などの無意味な内容は避けてください。メーカーにブロックされ、通知が届かない場合があります。
  • 多言語のプッシュタイトルとプッシュ内容の追加に対応：エンドユーザーのデバイス言語を自動検出し、他言語が未設定の場合は[デフォルト]言語設定の内容が全対象ユーザーに送信されます。
  • AI ワンクリック翻訳に対応。

• 送信時間：送信タイミングを選択します。
  • 即時：すぐにメッセージを配信します。
  • 定時：現在時刻の 3 分後以降のみ設定可能で、定時タスクは 1 年を超えて設定できません。
• 定速プッシュ：設定した時間内にプッシュを完了し、サーバー負荷を軽減します。
• 通知クリック時の動作：通知をタップした後のアクションです。
  • アプリを直接起動。
  • intent（推奨）、フォーマット：intent:#Intent;action=action path;component=packagename/ Activity path;end
  • deeplink：フォーマット：scheme://test？key1=val1&key2=val2

高度な設定

• プッシュ計画識別子の紐付け：プッシュ計画識別子を使用して同類のプッシュメッセージを管理でき、計画単位で総メッセージ到達数やユーザークリック数などを確認できます。
• メッセージタイプの選択：
  • システムメッセージ：各メーカーチャネルのサービス通知に対応します（Huawei/Honor：サービス・通信カテゴリ、Xiaomi/OPPO：プライベートメッセージ、vivo：システムメッセージ）。通常メーカーは送信数を制限しません。
  • 運営メッセージ：各メーカーチャネルのマーケティング運営メッセージに対応します（Huawei/Honor：マーケティング相談カテゴリ、Xiaomi/OPPO：パブリックメッセージ、vivo：運営メッセージ）。通常メーカーは送信数を厳しく制限します。
  • デフォルトで運営メッセージが選択されています。

指定したメッセージタイプに基づき、各メーカーチャネルのメッセージ分類フィールドを自動的に適用し、メッセージの送信制限やメーカーのメッセージ配額の浪費を防止します。

• オフラインメッセージ保存期間：この値でオフラインメッセージの有効期間を指定します。ユーザーが現在オフラインの場合、オフラインメッセージとして保存され、次回オンライン時に配信されます。この期間内にユーザーがオンラインになればプッシュを受信し、期間を過ぎると失効します。
  • デフォルト期間は 1 日です。
  • 0 に設定するとオフラインメッセージは保存されず、現在オンラインのユーザーのみ受信可能です。
• 追加フィールド：クライアントが追加フィールドの内容を取得し、カスタムイベント処理に使用します。追加パラメータの追加・削除に対応しています。

• メーカー特殊設定：ここで設定したフィールドが上記「通知リマインダーテンプレート」のフィールドと重複する場合、ここの設定が優先されます。ここに記載されていないメーカーは特殊な個別設定の対象外です。

• Xiaomi channel_id：Xiaomi 通知カテゴリ識別子。Push API の options.third_party_channel.xiaomi.channel_id フィールドに対応します。
• Huawei：importance、category、target_user_type の使用詳細は REST API ドキュメントを参照してください。
  • Huawei channel_id：Huawei カスタム通知チャネル識別子。Push API の options.third_party_channel.huawei.channel_id フィールドに対応します。
  • Huawei importance：Huawei メーカーメッセージリマインダーレベル。Push API の options.third_party_channel.huawei.importance フィールドに対応します。
  • Huawei category：Huawei メーカーのメッセージタイプ識別子。Huawei 自動分類権限の申請が必要です。Push API の options.third_party_channel.huawei.category フィールドに対応します。
  • Huawei target_user_type：Huawei メーカーの通常メッセージ / テストメッセージ識別子。Push API の options.third_party_channel.huawei.target_user_type フィールドに対応します。
• Honor importance：Honor メーカーメッセージ分類。Push API の options.third_party_channel.honor.importance フィールドに対応します。
• OPPO channel_id：OPPO 通知バーチャネル識別子。Push API の options.third_party_channel.oppo.channel_id フィールドに対応します。
• vivo：
  • vivo pushMode：vivo メーカープッシュモード。Push API の options.third_party_channel.vivo.push_mode フィールドに対応します。
  • vivo category：vivo メーカーのメッセージ二次分類識別子。Push API の options.third_party_channel.vivo.category フィールドに対応します。

Android 設定

• メーカーチャネル状態：対応するメーカーチャネルの統合と設定が完了すると、該当チャネルのステータスがハイライト表示されます。
• 通知配信ストラテジー：メーカーチャネルと Engagelab チャネルの優先配信ストラテジーを指定できます。メーカーストラテジーを選択する場合は、メーカーチャネルの設定が完了していることを確認してください。
• メーカー配額ストラテジー：このストラテジーは Engagelab システム側の配額判定・控除ロジックをスキップするかどうかのみを示し、実際にはメーカーの配額メカニズムに依然として従います。現在 Xiaomi、OPPO メーカーのみ有効です。Xiaomi 通知メッセージ、OPPO プライベートメッセージは「無視」を選択可能で、その他のプッシュメッセージは「無視しない」を推奨します。
• 通知バースタイル：MTPush SDK 内蔵の通知バースタイルとは異なり、ここではシステム API で構築した 3 種類の一般的なスタイルを提供します。詳細は「？」をクリックして確認してください。MTPush Android SDK 3.0.1 以降で対応しています。
  • カスタム通知バースタイル：クライアント側で複数のスタイルを異なる番号で設定し、サーバー側からプッシュ時に番号を指定して使用できます。デフォルト値は 0（デフォルトスタイル）です。
• 通知バーアイコン：通知バー右側のアイコンです。
  • デフォルト logo：アプリのデフォルトアイコンを表示します。
  • アイコンパス指定：指定パスのアイコンを表示します。http または https で始まるネットワークリソース、または drawable リソースフォルダパスが使用可能です。
  • アイコンアップロード：アップロードしたアイコンを表示します。

• 通知メッセージテンプレート：通知のリマインダー優先度を設定し、顧客への頻繁な打擾を避けます。デフォルトで「標準リマインダーテンプレート」が選択されています。テンプレートにはテンプレート名、チャネル名、チャネル ID、通知優先度、通知カテゴリ、通知リマインダータイプ、着信音設定が含まれます。
  • 標準リマインダーテンプレート：通知優先度は "PRIORITY_DEFAULT"、通知リマインダータイプは「着信音 | バイブレーション | LED」。
  • 無感知リマインダーテンプレート：通知優先度は "PRIORITY_LOW"、通知リマインダータイプは「LED」。
  • 強リマインダーテンプレート：通知優先度は "PRIORITY_HIGH"、通知リマインダータイプは「着信音 | バイブレーション | LED」。
  • 「新規メッセージリマインダーテンプレート作成」でカスタムテンプレートを作成できます。
    • channel_id：Android 8.0 以降の通知チャネル機能に対応し、プッシュ時に通知チャネル ID の指定が必要です。
    • 通知優先度：Engagelab チャネルのみ有効です。デフォルトの priority 属性は PRIORITY_DEFAULT に設定されています。公式説明はデベロッパードキュメントを参照してください。MTPush Android SDK 3.0.1 以降で有効です。
    • 通知カテゴリ：システムが通知の category 属性で通知バーのソートやフィルタリングを行う場合があります。MTPush Android SDK 3.0.1 以降で有効です。公式説明はデベロッパードキュメントを参照してください。
    • 通知リマインダータイプ：対応する項目にチェックを入れて、通知到達時のデバイスのリマインダータイプを指定できますが、システムの制限を超えることはできません（デバイスの着信音が ON、バイブレーションが許可、LED が有効な状態である必要があります）。MTPush Android SDK 3.0.3 以降で有効です。
• バッジ数：アプリアイコン右上のバッジです。
  • この属性は現在 Huawei EMUI 8.0 以上、Xiaomi MIUI 6 以上のデバイスでのみ有効で、MTPush Android SDK 3.3.6 以降で対応しています。
  • このフィールドを未入力の場合、バッジ数は変更されません（Xiaomi デバイスはシステム制御により、Engagelab チャネル経由でもメーカーチャネル経由でも、未送信でもデフォルトで +1 の効果があります）。入力時は、次の通知バーメッセージで設定した badge_add_num の値が以前のバッジ数に加算されます。badge_add_num は 1 に設定することを推奨します。例：badge_add_num を 1 に設定し、アプリの以前のバッジ数が 2 の場合、このバッジメッセージ送信後はバッジ数が 3 と表示されます。

iOS 設定

• silent_push：content-available: 1 で、badge、sound、メッセージ内容などのパラメータを含まず、ユーザーに通知せずにコンテンツ更新などの操作が可能です。「Silent Remote Notifications」を参照してください。
• 通知サブタイトル：このフィールドは iOS 10 以上のシステムバージョンのみ対象です。Android プラットフォームおよびその他の iOS バージョンはこのフィールドの影響を受けません。
• content-available（プッシュウェイクアップ）：iOS 7 から追加された新機能です。ここで有効にすると Background Remote Notification として動作し、無効の場合は通常の Remote Notification です。詳細は「Background Remote Notification」を参照してください。
• mutable-content：iOS 10 から追加された新機能です。ここで有効にすると iOS 10 の UNNotificationServiceExtension 機能に対応し、無効の場合は通常の Remote Notification です。詳細は「UNNotificationServiceExtension」を参照してください。
• apns-collapse-id：collapse id パラメータを持つ通知は、通知センター内の同じ collapse id を持つ通知を上書きします。collapse id の値は 64 バイトを超えてはなりません。このフィールドの詳細は APNs Guide を参照してください。

• 通知メッセージテンプレート：通知のリマインダー優先度を設定し、顧客への頻繁な打擾を避けます。デフォルトで「標準リマインダーテンプレート」が選択されています。テンプレートにはテンプレート名、通知タイプ、sound、volume、critical、category、thread-id、interruption-level が含まれます。
  • 標準リマインダーテンプレート：通知タイプは「通知タイプ」、sound は「デフォルト通知」、interruption-level は "active"。
  • 無感知リマインダーテンプレート：通知タイプは「通知タイプ」、sound は「無音」、interruption-level は "passive"。
  • 「新規メッセージリマインダーテンプレート作成」でカスタムテンプレートを作成できます。
    • 普通通知：sound フィールドで着信音を指定します。デフォルトは default（システムデフォルト音）です。空値に設定すると無音になります。特殊な名前を設定する場合は、アプリ側でその着信音を設定している必要があります。
    • アラート通知：アラート通知のプッシュが必要なアプリは Apple Developer 公式サイト で権限を申請する必要があります。
    • category：iOS カテゴリ。iOS 8 以上のシステムバージョンのみこのパラメータのプッシュに対応しています。
    • thread-id：通知をグループ化するためのアプリ固有の識別子です。同じ thread-id の通知は 1 つのグループにまとめられます。
    • interruption-level：通知の優先度と配信タイミングを定義する割り込みレベルです。
• badge：APNs プッシュ通知の badge を指定でき、デスクトップのアプリアイコン右上に直接表示されます。アプリの未読メッセージ数を意味し、バッジ +N/-N にも対応しています。例：受信者 A、B のバッジがそれぞれ 1 と 2 の場合、+2 をプッシュすると A のバッジは 3、B のバッジは 4 になります。システムデフォルト値は 1 です。

HarmonyOS 設定

• 通知バースタイル：システムデフォルトスタイルと複数行テキストスタイルに対応しています。
• 通知バーアイコン：アプリデフォルトアイコンとパス指定アイコンの表示のみ対応しています。
• バッジ数：デフォルトで +1 の効果です。
• メーカー特殊設定：
  • category：HarmonyOS メーカーのメッセージタイプ識別子。HarmonyOS 自動分類権限の申請が必要です。Push API の notification.hmos.category フィールドに対応します。
  • test_message：HarmonyOS メーカーの通常メッセージ / テストメッセージ識別子。Push API の notification.hmos.test_message フィールドに対応します。
  • receipt_id：HarmonyOS メーカーのプッシュデータ受領アドレス識別子。Push API の notification.hmos.receipt_id フィールドに対応します。

ターゲットユーザー

ターゲット選択：プッシュ対象のターゲットユーザーです。テスト時は登録ログから取得した registrationID を使用してプッシュすることを推奨します。

• All/全員ブロードキャスト：アプリの現在登録済みおよび今後登録される全オンラインユーザーにプッシュします。
• ユーザーセグメント：ルールに基づいてカスタムユーザーセグメントを作成し、セグメント単位でプッシュできます。
• registrationID：1 回のプッシュで最大 1000 件です。

送信タイミング

• 即時送信：メッセージはすぐに配信されます。
• 組織時間で定時送信：現在の組織で設定されたタイムゾーンに基づいて送信します。定時タスクは 1 年を超えて設定できません。
• エンドユーザー時間で定時送信：各端末デバイスの設定タイムゾーンに基づいて送信します。異なるタイムゾーンの全ユーザーに翌日午前 10 時に通知を送信したい場合、翌日午前 10 時に設定するだけで構いません。注意：送信時に特定のタイムゾーンの時間が既に過ぎている場合、メッセージは破棄されます。重要なメッセージがエンドユーザーに届かないことを避けるため、少なくとも 24 時間前から送信を開始してください。
• 循環定時送信：一定期間内に定期的に自動送信する循環定時プッシュを設定できます。月次定期繰り返しを選択し 2 月に 30 日を選択した場合、30 日の選択は無視されます。

送信プレビュー

プッシュパラメータの設定後、送信プレビューをクリックして設定内容を確認できます。 送信パラメータを確認し、確認をクリックするとプッシュタスクの作成が完了します。

カスタムメッセージの作成

【プッシュ】-【カスタムメッセージ】ページからプッシュタスクを作成します。パラメータ設定の説明は通知メッセージの作成を参照してください。

アプリ内メッセージの作成

アプリ内メッセージは、アプリ内で表示されるメッセージで、情報伝達、プロモーション活動、またはユーザーへの特定操作のリマインドに使用されます。本ドキュメントでは、対応しているアプリ内メッセージの種類と作成手順をご案内します。

• アプリ内メッセージは極光チャネル経由のみで配信され、Android、iOS プラットフォームのみ対応しています。
• アプリ内メッセージは webPortal 経由でのみ送信可能で、API 送信インターフェースは現在提供していません。
• この機能は SDK バージョン v4.5.0 以上が必要です。

基本設定

1、メッセージ名：最大 20 文字以内です。

2、対象プラットフォーム：SDK を統合したプラットフォームに基づき、プッシュ対象のプラットフォームを選択します。

• プラットフォーム選択前に【プッシュ設定】で対応プラットフォームの設定が必要です。
• サブアカウントはメインアカウントが許可したプラットフォームのみ選択可能です。

プラットフォーム選択後、メッセージのポップアップページ方式も選択できます：

• ページ制限なし：このアプリ内メッセージは任意のページで表示可能です（1 つのメッセージは 1 回のみポップアップ）。
• 特定ページパス指定：このアプリ内メッセージはアプリの指定ページでのみポップアップします（1 つのメッセージは 1 回のみポップアップ）。

3、対象ユーザー：プッシュ対象のターゲットユーザーです。テスト時は登録ログから取得した registrationID を使用してプッシュすることを推奨します。

• All/全員ブロードキャスト：アプリの現在登録済みおよび今後登録される全オンラインユーザーにプッシュします。
• ユーザーセグメント：ルールに基づいてカスタムユーザーセグメントを作成し、セグメント単位でプッシュできます。
• registrationID：1 回のプッシュで最大 1000 件です。

メッセージ内容

アプリ内メッセージシステムはインタースティシャル、バナー、フルスクリーンの 3 種類の固定モデルに対応しており、ボタンで切り替えできます。また、独自の HTML コードでテンプレートを作成することも可能です。

• メッセージ内容：
  • メッセージ画像：
    • 画像アドレス：ネットワーク画像に対応しています。
    • 画像操作：ネットワークリンクまたはディープリンクを使用して、ユーザーを外部ページまたはアプリ内の特定ページに誘導します。URL 遷移、Deeplink を開く、プッシュ有効化プロンプト、アクションなしから選択できます。
      • URL 遷移
      • Deeplink を開く
      • プッシュ有効化プロンプト：ユーザーが以前にネイティブプロンプトで権限を拒否した場合、クリックアクションでアプリのデバイス設定が開きます。既に通知権限を有効にしている場合はデバイス設定は開きません。
      • アクションなし：選択時、ユーザーがクリックするとポップアップが消えます。
  • テキストタイトル：
    • メッセージタイトル：太字、フォントサイズ、位置、フォントカラーの設定に対応しています。
  • テキスト内容：
    • メッセージ内容：太字、フォントサイズ、位置、フォントカラーの設定に対応しています。
  • 多言語のプッシュタイトルとプッシュ内容の追加に対応：エンドユーザーのデバイス言語を自動検出し、他言語が未設定の場合は[デフォルト]言語設定の内容が全対象ユーザーに送信されます。
  • 操作ボタン：マーケティングプロモーション情報や広告を送信する場合は、ページに目立つワンクリック閉じる機能を確保してください。
    • メインボタンとサブボタンの設定に対応しています。
    • ボタン名とボタン操作をカスタマイズでき、ボタン操作は上記の画像操作を参照してください。
  • 閉じるボタン：クリックで現在のページを閉じます。下部中央または右上に設置できます。

送信タイミング

• 送信時間：送信タイミングを選択します。
  • 即時：すぐにメッセージを配信します。
  • 定時：現在時刻の 3 分後以降のみ設定可能で、定時タスクは 1 年を超えて設定できません。
  • 定速プッシュ：設定した時間内にプッシュを完了し、サーバー負荷を軽減します。

高度な設定

• 遅延ポップアップ：
  • 即時ポップアップ：アプリ内メッセージが条件を満たすとすぐにページからポップアップします。
  • 遅延ポップアップ：「ページ滞在後 XX 秒後にポップアップ」（デフォルト 3 秒）、「前回のアプリ内メッセージポップアップ後 XX 秒後にポップアップ」（デフォルト 3 秒）に設定できます。
• 消失タイミング：デフォルトは一定時間後に消失ですが、ユーザーが手動でポップアップを閉じる必要があるように切り替えることも可能です。
  • 一定時間後に消失：バナーメッセージはデフォルト 5 秒後に消失、インタースティシャル・HTML メッセージはデフォルト 30 秒後に消失。設定可能範囲は 5〜180 秒です。フルスクリーンメッセージにスキップボタンとスキップ時間が設定されている場合はこの設定の影響を受けません。
  • ユーザー手動閉じ：選択時は閉じるボタンを有効にする必要があります。未有効の場合はシステムが自動で有効にします。
• メッセージ表示有効期間：この期間内にユーザーがオンラインになり表示ページに入った場合のみメッセージが正常に表示され、期間を過ぎると失効します。
  • 特定ユーザー宛てのプッシュで、そのユーザーが現在オフラインの場合、「表示締切時間」前にオフラインメッセージとして保存され、次回オンライン時に配信されます。
  • メッセージがアプリに配信済みでも、エンドユーザーが指定ページに入らないまま「表示締切時間」を過ぎた場合、そのアプリ内メッセージは表示されません。
• 追加パラメータ：クライアントのカスタムイベント処理に使用します。

A/B テスト

【プッシュ作成】-【A/B テスト】ページからプッシュタスクを作成します。パラメータ設定の説明は以下の通りです：

• メッセージ名：今回の A/B テストのメッセージ名をカスタマイズし、後の管理や検索に活用します。
• プラットフォーム選択：現在 Android、iOS プラットフォームに対応しており、iOS プラットフォームでは開発環境または本番環境を選択できます。プラットフォーム未選択時、A/B グループのメッセージ内容はデフォルトで両プラットフォームのプレビューが表示されます。プラットフォーム選択後、高度な設定に対応プラットフォームの設定が追加されます。

A/B グループメッセージ内容設定

A/B グループのメッセージ内容設定は「通知メッセージ」と一致しており、多言語、通知タイトル、サブタイトル、内容、追加フィールド、クリック動作、高度なスタイルなどの設定に対応しています。 B グループは A グループの全設定をワンクリックでコピーでき、対照グループの内容を素早く構築できます。

B グループは A グループの設定をワンクリックでコピーでき、コピー後に A グループをベースに変更を加えることができます。

ターゲットユーザー

EngageLab プッシュプラットフォームは複数のターゲットユーザー選択方式に対応しており、開発者や運営が異なるビジネスニーズに応じて精確にユーザーにリーチできます。テスト時は登録ログから取得した registrationID を使用してプッシュすることを推奨します。具体的な設定は「通知メッセージ」を参照してください。

A/B Test 設定

ターゲットユーザー条件とプラットフォーム条件（MacOS/Android）を同時に満たすユーザーの中から、A/B テストに参加するユーザーのパーセンテージを設定します。 A、B 両グループのテスト参加ユーザー比率は同等です。例えばユーザー比率が 40% の場合、A、B 両グループのユーザー比率はそれぞれ 20% になります。

計算人数の最終結果は整数に切り捨てられます。A/B Test の対象人数が 2 人未満の場合、プッシュは失敗します。

送信時間と高度な設定

A/B グループプッシュの送信時間と高度な設定は「通知メッセージ」と一致しています。詳細な設定説明は「通知メッセージ」を参照してください。

Android 設定

• 通知配信ストラテジー：メーカーチャネルと Engagelab チャネルの優先配信ストラテジーを指定できます。メーカーストラテジーを選択する場合は、メーカーチャネルの設定が完了していることを確認してください。

  • FCM とスマートフォンメーカーチャネルが併存する場合の優先度を設定する必要があります。

• 高度な属性設定：標準リマインダーテンプレートまたはカスタムテンプレートを選択でき、異なるビジネスシナリオの通知スタイル要件を満たします。バッジ数（badge_add_num）の設定は Huawei EMUI 8.0 以上、Xiaomi MIUI 6 以上のデバイスでのみ有効です。

異なる Android メーカーに対して、EngageLab はプッシュパラメータの個別設定に対応しています。具体的なフィールドは各メーカーのプッシュ仕様とページヒントの詳細説明に従って入力してください。

iOS 設定

EngageLab はプッシュパラメータの個別設定に対応しています。具体的なフィールドは各メーカーのプッシュ仕様とページヒントの詳細説明に従って入力してください。

通知リマインダーテンプレート：標準リマインダーテンプレートまたは無感知メッセージテンプレートを選択できます。新規メッセージテンプレート作成をクリックしてカスタムテンプレートを追加できます。

バッジ数：アプリアイコンのバッジ数を設定でき、「システムデフォルト」またはカスタム数値に対応しています。未読メッセージ数などのシナリオに適しています。

送信プレビュー

全ての設定が完了したら、ページ下部の「送信プレビュー」ボタンをクリックして、現在の通知テンプレートの実際の表示効果を確認できます。問題がないことを確認後、「送信確認」をクリックするとプッシュメッセージがテストユーザーに送信されます。 メッセージの送信完了後、「プッシュ記録」ページで今回の A/B テストの詳細な効果分析を確認できます。