モバイルIn-Appメッセージング

Treasure DataのEngage Studioに搭載されたモバイルIn-Appメッセージング機能を使用すると、マーケターはモバイルアプリ内にパーソナライズされた視覚的に豊かなメッセージを直接配信できます。プッシュ通知とは異なり、In-Appメッセージはユーザーがアプリを積極的に操作している間に表示されるため、オンボーディングフロー、プロモーションオファー、コンテキストに応じたお知らせなどに最適です。

In-Appメッセージを作成する前に、以下のセットアップが完了していることを確認してください。

1. RT 2.0が有効化されていること（Treasure アカウント）
2. RTイベントがモバイルアプリに実装され、Treasure Dataにデータが流入していること
3. IDスティッチングが設定され、イベント間でユーザーIDが名寄せされていること
4. Realtime Personalizationエントリーおよびセクションが、関連するペアレントセグメントを使用してAudience Studioで作成済みであること
5. お客様のモバイルアプリにRT 2.0 Personalization APIの呼び出しと、返されたHTMLをポップアップとして表示する実装が済んでいること

Engage Studioで IN-PRODUCT EXPERIENCES > In-App Messages に移動すると、ワークスペース内のすべてのIn-Appメッセージが一覧表示されます。各行には以下の情報が表示されます。

• Status — Draft、Live、または Paused
• Message ID — システムが自動生成する一意の識別子
• Name — キャンペーン名
• Parent Segment — ターゲティングに使用するRT 2.0のペアレントセグメント
• Last Updated — 最終更新日時

右上の + Create in-app message をクリックして新しいキャンペーンを作成します。

In-Appメッセージの作成は2つのステップで行います。

以下を選択してターゲティングを設定します。

• Target Parent Segment — このメッセージを受け取る対象ユーザーを定義するRT 2.0のペアレントセグメント。
• Personalization — Personalizationセクションに定義されたエントリー基準に基づいてリアルタイム配信を制御する、既存のRT 2.0 Personalization。
• Personalization section — 選択したPersonalization内の、このメッセージのコンテンツを格納する特定のセクション。

これらはEngage StudioでIn-Appメッセージを作成する前に、Audience Studioで設定しておく必要があります。

メッセージの詳細とデザインを設定します。

• Message ID — このメッセージの自動生成された一意の識別子。
• Name（必須） — In-Appメッセージ一覧に表示されるメッセージの名前。
• Description（任意） — メッセージに関する社内向けメモ。
• Message Content — ユーザーのアプリ内に表示されるモーダルをデザインします。

新規メッセージ作成時（Draftステータス）は + Create in-app message をクリックするとドラッグアンドドロップエディターが開きます。保存後は Message Content セクションにデザイン済みのモーダルプレビューが表示されます。

エディターの右パネルには3つのタブがあります。

• CONTENT — 画像、テキスト、ボタンなどのコンテンツブロックを追加・設定します。ブロックを選択すると、そのプロパティ（画像URL、alt テキスト、配置、角の丸み、アクションリンクなど）が表示されます。
• ROWS — モーダルの行レイアウトを管理します。
• SETTINGS — 背景色やパディングなど、モーダル全体のグローバル設定を行います。

左上の Preview mode トグルを使用すると、ユーザーに表示されるモーダルの見た目を確認できます。Done をクリックするとデザインを保存してメッセージ設定画面に戻ります。

ページ下部のナビゲーションボタンでステップ間を移動できます。

• Back — Target Audienceステップに戻ります。
• Next — 次に進みます（必須フィールド入力済みの場合に有効）。
• Pause / Launch — この画面から直接キャンペーンのステータスを変更します。

メッセージコンテンツが完成したら、Launch をクリックしてメッセージを配信開始します。Engage Studioは連携しているRT 2.0 PersonalizationセクションのString Builder設定内のIn-Appメッセージ設定を自動的に更新します。なお、配信はRT 2.0の伝播に依存するため、起動直後にアプリへ即時反映されない場合があります。

配信を停止するには Pause をクリックします。これにより、連携しているPersonalizationセクションのString Builder設定からIn-Appメッセージ設定が削除されます。編集後はいつでも再起動できます。

In-Appメッセージは以下のステータスを移行します。

DRAFT ──起動──> LIVE ──一時停止──> PAUSED ──起動──> LIVE

• Draft（下書き）: 作成済みだがまだ配信されていません。すべての設定を自由に編集できます。
• Live（配信中）: 現在ユーザーへの配信中です。設定は編集できません。変更するにはキャンペーンを一時停止してください。
• Paused（一時停止中）: 配信が停止されています。再起動前にすべての設定を編集できます。

モバイルIn-Appメッセージングは、Realtime Personalization 2.0（RT 2.0） を基盤として構築されています。ユーザーがモバイルアプリ内でイベント（ページビューやセッション開始など）をトリガーすると、お客様のアプリがRT 2.0 Personalization APIを呼び出します。対象のIn-Appメッセージが設定されており、ユーザーがターゲットセグメントに属している場合、APIはメッセージのHTMLを返し、アプリがそれをモーダルオーバーレイとして表示します。繰り返し表示時のAPI呼び出しを削減するため、必要に応じてメッセージコンテンツをお客様のアプリ側でキャッシュすることもできます。

Engage StudioでIn-Appメッセージを Launch すると、プラットフォームは連携しているRT 2.0 Personalizationセクションのペイロードを自動的に更新します。セクションには、お客様のアプリが実行時に読み取る3つのString Builderの出力値が格納されます。

• td_in_app.versions — メッセージのバージョンメタデータ。

• td_in_app.messages — メッセージオブジェクトのJSON配列。各オブジェクトには以下のフィールドが含まれます。

  フィールド	型	説明
  id	string（UUID）	メッセージの一意な識別子。
  type	string	メッセージタイプ。現在は常に modal。
  content_html	string	アプリが表示するモーダルのHTML全文。

• td_in_app.created_at_milliseconds — キャッシュの無効化に使用される作成タイムスタンプ。

メッセージを一時停止すると、String Builder設定からIn-Appメッセージ設定が削除され、アプリはそれ以降メッセージを受け取らなくなります。

お客様のアプリは、該当するイベント（例：app_open）でP13N APIを呼び出し、レスポンスの td_in_app.messages フィールドを解析して、HTMLをポップアップとして表示します。現状では、具体的な表示方法はお客様のアプリ実装に依存します。この処理を自動的に行うTreasure Data SDKは、将来のリリースで提供予定です。

1. ユーザーがアプリを開く、または画面を遷移する
        ↓
2. お客様のアプリがRT 2.0 Personalization APIを呼び出す
        ↓
3. Personalization APIがターゲティングを評価する（ペアレントセグメント＋セクション）
        ↓
4. 対象のIn-Appメッセージが存在する場合 → APIがメッセージHTMLを返す
        ↓
5. お客様のアプリがHTMLをモーダルオーバーレイとして表示する
        ↓
6. ユーザーがメッセージを閲覧、操作、または閉じる