# モバイルプッシュキャンペーン

## 概要

Engage Studioのモバイルプッシュ通知機能を使用すると、Firebase Cloud Messaging（FCM）を介してAndroidおよびiOSアプリユーザーに通知を送信できます。
このガイドでは、以下の手順でAndroidプッシュ通知を設定、送信、検証する方法を説明します：

1. 配信ターゲットと目的を定義する
2. キャンペーンを作成して設定する
3. テストメッセージを送信してデバイスで確認する
4. 配信、開封、クリックトラッキングを確認する（モバイルアプリ開発が必要です。）


## 前提条件

AndroidおよびiOSアプリは、FCM Integrationとイベント配信がTreasure Dataに設定されている必要があります。
実装の詳細については、Developer Guideを参照してください。

- Firebase Cloud Messagingアカウント
- Apple Developerアカウント


div
iframe
script
## キャンペーンの作成方法

Engage Studioでは、Campaigns画面から新しいMobile Pushキャンペーンを作成できます。このセクションでは、最初のプッシュキャンペーンを設定するプロセスを説明します。

### キャンペーンの作成

- 左側のナビゲーションバーから**Messaging -> Campaigns**に移動します。
- 右上隅の**+ New Campaign**をクリックします。
- **Create Campaign**ダイアログで：
  - 配信チャネルとして**Mobile Push Notification**を選択します。
  - **Campaign Name**を入力します（例：「Android Promo Push」）。
- Createをクリックして、Mobile Push Campaignを開きます。


![](/assets/screenshot-2025-11-08-at-22.47.41.f4157888dcca595640ada8b8343b062d3b8f48d3fc940cf0a7df283ac6ccb78b.5be018a0.png)

### ターゲットオーディエンスの選択

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設定は、ユーザーが通知をタップしたときに何が起こるかを定義します。 | - Open App（デフォルト）
- Open Deep Link
- Open Web URL

 |
| **ヒント** | - **絵文字サポート：** Unicode絵文字を直接挿入できます（例：🎉）。プラットフォーム依存のアイコンは避けてください。
- Liquidサポート：出力マッピングで定義した属性をコンテンツに挿入できます。

 | "{{profile.first_name}}" |


アプリ実装が必要
ディープリンクやカスタムアクションの場合、モバイルアプリにリンク処理ロジックを実装する必要があります。
Androidでは、URIスキームがAndroidManifest.xml（`<intent-filter>`）で宣言されていることを確認してください。
iOSでは、スキームまたはユニバーサルリンクがXcodeのAssociated Domainsに登録されていることを確認してください。

![Campaign-Details](/assets/campaign-details.02895a37a2490614734f68ca72ed148baef72af0d5d90e9cecbd65d8086dd9a9.5be018a0.png)

![Mobile Push Notification Editor](/assets/mobile-push-notification-editor.dc73797ed02946998ca0ba4119e95c368b8ea555d2767415eeee47d3b17f6f07.5be018a0.png)

### 配信スケジュールの選択

**Delivery Schedule**タブの**Schedule**で、2つの配信タイミングオプションがあります：

| オプション | 説明 | 一般的なユースケース |
|  --- | --- | --- |
| **As soon as the campaign is launched** | **Publish**をクリックした後、またはアクティベーションがトリガーされた後、すぐに送信されます。 | リアルタイムアナウンス、フラッシュセール、アラート |
| **At a designated time** | 特定の将来の日時にキャンペーンを送信します。 | 計画されたプロモーションまたは時間ベースの通知 |


💡 ヒント
大規模なキャンペーンの場合、キュー準備とFCMトークン検証を可能にするため、少なくとも数分前に配信をスケジュールしてください。

キャンペーンが送信または完了したら、オプションでメール通知を受け取ることができます。

| フィールド | 説明 |
|  --- | --- |
| **Email notifications to** | 配信更新を受け取る1つ以上の受信者メールアドレスを追加します。 |


![](/assets/notification-settings.311abd9eb0fd7503d7c246c15fccc5f4f9525e7df737fa5d1cd6f89f49eba789.5be018a0.png)

### アクティベーションの選択

#### 詳細

**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（最大） |


![Activation Details](/assets/activation-details.488324a0b6cedad08fa715659fba1b6d21d60f305d34c4c499ad3b26a4697433.5be018a0.png)

#### 出力カラムマッピング

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は、各ターゲットデバイスを一意に識別するためにこのフィールドを必要とします。

![Output Mapping](/assets/output-mapping.a683a1d5ee64f249ea76b77728a2db3aec171867c9ddd4a605ef6827031f8d28.5be018a0.png)

#### アクション

### UTMトラッキングの選択

- キャンペーンエディターで、**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 | マーケティング目標のオプションタグ | （空） | ✅ |


![UTM Tracking](/assets/utm-tracking.572ab9cdd39fc5d2269a47b523b0006d8af21254cd7bf797711fa7b05e6fa8f9.5be018a0.png)

## 起動動作（キャンペーン配信フロー）

**Save and Launch**をクリックすると、Engage Studioは設定した構成に基づいてMobile Pushキャンペーンを自動的に準備して送信します。
以下の手順は、バックグラウンドで何が起こるか、そしてマーケターとしてコンソールで何を見ることができるかを説明しています。

### キャンペーン配信フロー

| ステップ | 何が起こるか | 確認できること/実行できること |
|  --- | --- | --- |
| 1.検証 | Engage Studioは、起動前にすべてのキャンペーン設定（オーディエンス、デバイストークン、認証、コンテンツ、スケジュール）を自動的にチェックします。 | エラーが見つかった場合、システムは修正をガイドする明確なメッセージを表示します。 |
| 2.オーディエンス準備 | プラットフォームはターゲットオーディエンスデータを読み込み、メッセージ配信のために各受信者の情報を準備します。 | キャンペーンステータスが**Launching**に変わります。 |
| 3.メッセージ生成 | Engage Studioは、静的コンテンツとオーディエンス属性またはJSONカラムデータ（製品レコメンデーションなど）を組み合わせて、各受信者にパーソナライズされたプッシュ通知を構築します。 | **Preview**機能を使用してパーソナライズされた例をプレビューできます。 |
| 4.配信実行 | 通知は定義されたスケジュールに従って送信されます（即時または選択した日時）。 | キャンペーンステータスが**Running**に更新されます。 |
| 5.完了 | すべての通知が送信されると、Engage Studioはキャンペーンを完了としてマークします。 | ステータスが**Completed**に変わります。 |
| 7.メール通知（オプション） | メール通知が有効になっている場合、配信サマリーがチームメンバーに自動的に送信されます。 | 配信結果を内部で共有するのに便利です。 |