Engage Studioのモバイルプッシュ通知機能を使用すると、Firebase Cloud Messaging（FCM）を介してAndroidおよびiOSアプリユーザーに通知を送信できます。 このガイドでは、以下の手順でAndroidプッシュ通知を設定、送信、検証する方法を説明します：
配信ターゲットと目的を定義する
キャンペーンを作成して設定する
テストメッセージを送信してデバイスで確認する
配信、開封、クリックトラッキングを確認する（モバイルアプリ開発が必要です。）
AndroidおよびiOSアプリは、FCM Integrationとイベント配信がTreasure Dataに設定されている必要があります。 実装の詳細については、Developer Guideを参照してください。
Firebase Cloud Messagingアカウント
Apple Developerアカウント
Engage Studioでは、Campaigns画面から新しいMobile Pushキャンペーンを作成できます。このセクションでは、最初のプッシュキャンペーンを設定するプロセスを説明します。
左側のナビゲーションバーからMessaging -> Campaignsに移動します。
右上隅の**+ New Campaign**をクリックします。
Create Campaignダイアログで：
- 配信チャネルとしてMobile Push Notificationを選択します。
- Campaign Nameを入力します（例：「Android Promo Push」）。
Createをクリックして、Mobile Push Campaignを開きます。
Target Audienceタブで、Audience Segmentを選択します。
リストから既存のParent Segmentを選択し、Target Segmentを選択します
ターゲットデバイスの合計数を確認し、Applyをクリックします。
キャンペーンが作成されると、Mobile Push Editor画面に移動します。 ここで、通知の外観、コンテンツ、タップ時の動作を定義できます。
| フィールド | 説明 | 例 |
|---|---|---|
| Title | 通知バーに表示されるタイトル。簡潔で明確にしてください。 | "Exclusive Offer for You!" |
| Message | タイトルの下に表示されるメインメッセージテキスト（1〜2行推奨）。 | "Tap to get 20% off your next order." |
| Image（オプション） | 通知に表示されるサムネイルまたはリッチ画像。有効なHTTPS URLである必要があります。 | https://cdn.example.com/banner.png |
| On-Click Behavior | On-Click Behavior設定は、ユーザーが通知をタップしたときに何が起こるかを定義します。 |
|
| ヒント |
| "{{profile.first_name}}" |
ディープリンクやカスタムアクションの場合、モバイルアプリにリンク処理ロジックを実装する必要があります。 Androidでは、URIスキームがAndroidManifest.xml（<intent-filter>）で宣言されていることを確認してください。 iOSでは、スキームまたはユニバーサルリンクがXcodeのAssociated Domainsに登録されていることを確認してください。
Delivery ScheduleタブのScheduleで、2つの配信タイミングオプションがあります：
| オプション | 説明 | 一般的なユースケース |
|---|---|---|
| As soon as the campaign is launched | Publishをクリックした後、またはアクティベーションがトリガーされた後、すぐに送信されます。 | リアルタイムアナウンス、フラッシュセール、アラート |
| At a designated time | 特定の将来の日時にキャンペーンを送信します。 | 計画されたプロモーションまたは時間ベースの通知 |
大規模なキャンペーンの場合、キュー準備とFCMトークン検証を可能にするため、少なくとも数分前に配信をスケジュールしてください。
キャンペーンが送信または完了したら、オプションでメール通知を受け取ることができます。
| フィールド | 説明 |
|---|---|
| Email notifications to | 配信更新を受け取る1つ以上の受信者メールアドレスを追加します。 |
Activation Detailsセクションでは、Engage StudioがMobile Pushキャンペーンを配信パイプラインに接続する方法を定義します。 ここで、認証、データ構造、並列処理設定を含むメッセージ配信の技術的な設定を指定します。
| フィールド | 説明 | 例/注記 |
|---|---|---|
| Activation name | アクティベーションのシステム生成された一意の識別子。ログ、イベントトラッキング、API呼び出しで内部的に使用されます。 | engage_campaign_019a63d178bd748584588f368563db8d |
| Enable activation actions | このアクティベーションが配信を実行できるかどうかを切り替えます。無効にすると、公開してもキャンペーンはドラフトのままです。 | |
| Authentication | 配信ログに使用される認証（Engageコネクタ）を指定します。 | |
| Event ID | delivery-apiやPlazmaなどのシステム間でログと配信イベントをトレースするための一意のイベント識別子。 | 019a63d1-78bd-7485-8458-8f368563db8d |
| JSON columns | Engage Studioでパーソナライズされたコンテンツレンダリングに使用されるJSON形式のデータを含む1つ以上のオーディエンスカラムを定義します。これらのカラムにより、動的オブジェクト（配列、マップ）をメッセージテンプレートに直接渡すことができます。 | product_items |
| Batch size | 通知送信時にバッチごとに処理されるレコード数。大きなバッチはスループットを向上させますが、信頼性に影響する場合があります。 | 1000（デフォルトおよび最大）、1（最小） |
| Thread count | 同時メッセージ送信に使用される並列スレッド数。大量キャンペーンの場合は増やしてください。 | 1（デフォルト）、10（最大） |
Mobile Pushキャンペーンを送信する前に、Engage Studioはどのオーディエンス属性をFirebase Cloud Messaging（FCM）またはApple Push Notification Service（APNs）に渡すかを知る必要があります。これはキャンペーンエディターのOutput Column Mappingセクションで設定されます。出力マッピングは、オーディエンスデータカラム（セグメントまたはワークフローから）が配信ペイロードフィールドにどのように対応するかを定義します。キャンペーン実行中、Engage StudioはLiquid構文（{{profile.attribute_name}}）を通じて、各受信者レコードのユーザー固有の値でこれらのフィールドを動的に置き換えます。
出力カラム名のtokenカラムは配信に必須です。 FCMとAPNsは、各ターゲットデバイスを一意に識別するためにこのフィールドを必要とします。
キャンペーンエディターで、UTM Trackingタブを開きます。
Enable Auto UTM TrackingをONに切り替えます。有効にすると、コンテンツ内のすべてのURLリンクとWeb URLリンクに、これらのUTMパラメータを持つURLパラメータが追加されます。
利用可能なフィールドを確認またはカスタマイズします：
| フィールド | 説明 | デフォルト値 | 編集可能 |
|---|---|---|---|
| utm_id | 内部キャンペーン識別子 | campaign_id | ❌ |
| utm_medium | 固定チャネルタイプ | push | ❌ |
| utm_source_platform | Treasure Dataをオリジンシステムとして識別 | treasuredata | ❌ |
| utm_source | カスタムソース記述子（例：「app」、「android」） | treasuredata | ❌ |
| utm_campaign | 分析グループ化のための論理キャンペーン名 | （空） | ✅ |
| utm_marketing_tactic | マーケティング目標のオプションタグ | （空） | ✅ |
Save and Launchをクリックすると、Engage Studioは設定した構成に基づいてMobile Pushキャンペーンを自動的に準備して送信します。 以下の手順は、バックグラウンドで何が起こるか、そしてマーケターとしてコンソールで何を見ることができるかを説明しています。
| ステップ | 何が起こるか | 確認できること/実行できること |
|---|---|---|
| 1.検証 | Engage Studioは、起動前にすべてのキャンペーン設定（オーディエンス、デバイストークン、認証、コンテンツ、スケジュール）を自動的にチェックします。 | エラーが見つかった場合、システムは修正をガイドする明確なメッセージを表示します。 |
| 2.オーディエンス準備 | プラットフォームはターゲットオーディエンスデータを読み込み、メッセージ配信のために各受信者の情報を準備します。 | キャンペーンステータスがLaunchingに変わります。 |
| 3.メッセージ生成 | Engage Studioは、静的コンテンツとオーディエンス属性またはJSONカラムデータ（製品レコメンデーションなど）を組み合わせて、各受信者にパーソナライズされたプッシュ通知を構築します。 | Preview機能を使用してパーソナライズされた例をプレビューできます。 |
| 4.配信実行 | 通知は定義されたスケジュールに従って送信されます（即時または選択した日時）。 | キャンペーンステータスがRunningに更新されます。 |
| 5.完了 | すべての通知が送信されると、Engage Studioはキャンペーンを完了としてマークします。 | ステータスがCompletedに変わります。 |
| 7.メール通知（オプション） | メール通知が有効になっている場合、配信サマリーがチームメンバーに自動的に送信されます。 | 配信結果を内部で共有するのに便利です。 |