アプリ内メッセージの作成と送信
Experience PlatformMobile SDK とJourney Optimizerを使用して、モバイルアプリ用のアプリ内メッセージを作成する方法について説明します。
Journey Optimizerでは、ターゲットを絞ったオーディエンスにアプリ内メッセージを送信するキャンペーンを作成できます。 Journey Optimizerのキャンペーンは、様々なチャネルを使用して、特定のオーディエンスに 1 回限りのコンテンツを配信する場合に使用します。 キャンペーンでは、アクションは即座に、または指定したスケジュールに基づいて、同時に実行されます。 ジャーニーを使用する場合 ( Journey Optimizerプッシュ通知 レッスン ) では、アクションが順に実行されます。
Journey Optimizerでアプリ内メッセージを送信する前に、適切な設定と統合がおこなわれていることを確認する必要があります。 Journey Optimizerのアプリ内メッセージデータフローについては、 ドキュメント.
前提条件
- SDK が正常に構築され、インストールされ、設定された状態でアプリが実行されました。
- アプリをAdobe Experience Platform用に設定します。
- Journey Optimizerへのアクセスと十分な権限(説明を参照) ここ. また、次のJourney Optimizer機能に対する十分な権限が必要です。
- キャンペーンを管理します。
- 物理iOSデバイスまたはテスト用のシミュレーター。
学習内容
このレッスンでは、次の操作を行います
- AJO でアプリサーフェスを作成します。
- Journey Optimizerタグ拡張機能をインストールして設定します。
- アプリを更新して、Journey Optimizerタグ拡張を登録します。
- アシュランスで設定を検証します。
- Journey Optimizerで独自のキャンペーンとアプリ内メッセージエクスペリエンスを定義する。
- アプリ内から独自のアプリ内メッセージを送信します。
セットアップ
データ収集にアプリケーションサーフェスを追加する
-
次から: データ収集インターフェイスを選択します。 アプリのサーフェス をクリックします。
-
設定を作成するには、「 」を選択します。 アプリサーフェスを作成.
-
を入力します。 名前 設定の場合、例:
Luma App Tutorial
. -
送信者 モバイルアプリケーション設定 を選択します。 Apple iOS.
-
にモバイルアプリのバンドル ID を入力します。 アプリ ID (iOS Bundle ID) フィールドに入力します。 例:
com.adobe.luma.tutorial.swiftui
. -
「保存」を選択します。
データストリーム設定を更新
モバイルアプリから Edge ネットワークにデータが確実に送信されるようにするには、Experience Edge の設定を更新します。
-
データ収集 UI で、「 」を選択します。 データストリーム を選択し、例えば、データストリームを選択します。 Luma Mobile App.
-
選択 対象: Experience Platform を選択し、 編集 を選択します。
-
Adobe Analytics の データストリーム > > Adobe Experience Platform スクリーン、確認する Adobe Journey Optimizer が選択されている。 詳しくは、 Adobe Experience Platform設定 を参照してください。
-
データストリーム設定を保存するには、 保存.
Journey Optimizer Tags 拡張機能のインストール
アプリがJourney Optimizerで動作するようにするには、タグプロパティを更新する必要があります。
- に移動します。 タグ > 拡張機能 > カタログ.
- プロパティを開きます(例: )。 Luma Mobile App Tutorial.
- 選択 カタログ.
- を検索します。 Adobe Journey Optimizer 拡張子。
- 拡張機能をインストールします。
条件 のみ アプリ内でのアプリ内メッセージの使用、 拡張機能のインストール または 拡張機能の設定 に値を指定する場合、何も設定する必要はありません。 ただし、既に プッシュ通知 このチュートリアルでは、 開発 環境、 AJO プッシュトラッキングエクスペリエンスイベントデータセット データセットが次から選択されました: イベントデータセット リスト。
アプリでのJourney Optimizerの実装
前のレッスンで説明したように、モバイルタグ拡張機能のインストールでは設定のみが提供されます。 次に、メッセージング SDK をインストールして登録する必要があります。 これらの手順が明確でない場合は、 SDK のインストール 」セクションに入力します。
-
Xcode で、 AEP メッセージ は、パッケージの依存関係にパッケージのリストに追加されます。 詳しくは、 Swift Package Manager.
-
に移動します。 Luma > Luma > AppDelegate 」をクリックします。
-
確認
AEPMessaging
は、インポートのリストの一部です。import AEPMessaging
-
確認
Messaging.self
は、登録する拡張機能の配列の一部です。code language-swift let extensions = [ AEPIdentity.Identity.self, Lifecycle.self, Signal.self, Edge.self, AEPEdgeIdentity.Identity.self, Consent.self, UserProfile.self, Places.self, Messaging.self, Optimize.self, Assurance.self ]
アシュランスを使用して設定を検証
-
以下を確認します。 設定手順 シミュレーターまたはデバイスを Assurance に接続するには、「 」セクションを参照してください。
-
Assurance UI で、 設定.
-
を選択します。 隣のボタン アプリ内メッセージ.
-
「保存」を選択します。
-
選択 アプリ内メッセージ をクリックします。
-
を選択します。 検証 タブをクリックします。 エラーが表示されていないことを確認します。
独自のアプリ内メッセージの作成
独自のアプリ内メッセージを作成するには、発生したイベントに基づいてアプリ内メッセージをトリガーするキャンペーンをJourney Optimizerで定義する必要があります。 以下のイベントが発生します。
- Adobe Experience Platformに送信されたデータ
- Mobile Core の汎用 API を使用した、PII データのアクション、状態やコレクションなどのコアトラッキングイベント
- アプリケーションのライフサイクルイベント(起動、インストール、アップグレード、閉じる、クラッシュなど)
- 目標地点の入力や終了などの位置情報イベント。
このチュートリアルでは、Mobile Core の汎用 API と拡張機能に依存しない API を使用します ( Mobile Core 汎用 API) を使用して、ユーザー画面、アクションおよび PII データのイベント追跡を容易におこなえます。 これらの API で生成されたイベントは、SDK イベントハブに公開され、拡張機能で使用できます。 SDK イベントハブは、すべての Mobile Platform SDK 拡張機能に関連付けられたコアデータ構造を提供し、登録された拡張機能と内部モジュールのリスト、登録されたイベントリスナーのリスト、共有状態データベースを維持します。
SDK イベントハブは、登録済み拡張機能のイベントデータを公開および受け取り、Adobeやサードパーティソリューションとの統合を簡略化します。 例えば、 Optimize 拡張機能がインストールされている場合、Journey Optimizer - Decision Management オファーエンジンとのすべてのリクエストとインタラクションは、イベントハブによって処理されます。
-
Journey Optimizer UI で、 キャンペーン をクリックします。
-
選択 キャンペーンを作成.
-
Adobe Analytics の キャンペーンを作成 画面:
-
選択 アプリ内メッセージ をクリックし、 アプリサーフェス 例えば、リスト Luma Mobile App.
-
選択 作成
-
-
キャンペーンの定義画面で、 プロパティ、 名前 (例:キャンペーン)
Luma - In-App Messaging Campaign
、および 説明 例:In-app messaging campaign for Luma app
.
-
下にスクロールして アクション をクリックし、次を選択します。 コンテンツを編集.
-
Adobe Analytics の アプリ内メッセージ 画面:
-
選択 モーダル として メッセージのレイアウト.
-
入力
https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png
(の) メディア URL. -
を入力します。 ヘッダー 例:
Welcome to this Luma In-App Message
を入力し、 本文 例:Triggered by pushing that button in the app...
. -
入力 解除 として ボタン#1テキスト(プライマリ).
-
プレビューの更新方法を確認します。
-
選択 有効化するレビュー.
-
-
Adobe Analytics の 有効化のレビュー(Luma — アプリ内メッセージキャンペーン) 画面、選択 (内) スケジュール タイル。
-
戻る Luma - In-App Messaging Campaign 画面、選択 編集トリガー.
-
Adobe Analytics の アプリ内メッセージトリガー ダイアログで、アプリ内メッセージをトリガーにするトラックアクションの詳細を設定します。
-
削除するには アプリケーション起動イベント を選択します。 .
-
用途 条件を追加 次の論理を繰り返し構築する 次の場合にメッセージを表示.
-
「完了」をクリックします。
トラックアクションを定義し、 アクション 次と等しい
in-app
そして コンテキストデータ がのキーと値のペア"showMessage" : "true"
. -
-
戻る Luma - In-App Messaging Campaign 画面、選択 有効化するレビュー.
-
Adobe Analytics の 有効化のレビュー(Luma — アプリ内メッセージキャンペーン) 画面、選択 有効化.
-
表示される Luma - In-App Messaging Campaign ステータス別 ライブ (内) キャンペーン リスト。
アプリ内メッセージのトリガー
アプリ内メッセージを送信するためのすべての材料が揃っています。 残りの点は、アプリでこのアプリ内メッセージにトリガーを設定する方法です。
-
に移動します。 Luma > Luma > Utils > MobileSDK 」をクリックします。 次を検索:
func sendTrackAction(action: String, data: [String: Any]?)
関数を呼び出し、次のコードを追加します。このコードは、MobileCore.track
関数、パラメーターに基づくaction
およびdata
.code language-swift // Send trackAction event MobileCore.track(action: action, data: data)
-
に移動します。 Luma > Luma > Views > General > ConfigView をクリックします。 アプリ内メッセージボタンのコードを探し、次のコードを追加します。
code language-swift // Setting parameters and calling function to send in-app message Task { MobileSDK.shared.sendTrackAction(action: "in-app", data: ["showMessage": "true"]) }
アプリを使用した検証
-
を使用して、シミュレーターまたは Xcode の物理デバイスでアプリを再構築し、実行します。 .
-
次に移動: 設定 タブをクリックします。
-
タップ アプリ内メッセージ. アプリ内メッセージがアプリに表示されます。
img-md w-300
アシュランスでの実装の検証
Assurance UI でアプリ内メッセージを検証できます。
- 以下を確認します。 設定手順 シミュレーターまたはデバイスを Assurance に接続するには、「 」セクションを参照してください。
- 選択 アプリ内メッセージ.
- 選択 イベントリスト.
- を選択します。 メッセージを表示 エントリ。
- Inspect未加工のイベント、特に
html
:アプリ内メッセージの完全なレイアウトとコンテンツを含む。
次の手順
これで、関連する適用可能なアプリ内メッセージの追加を開始するためのすべてのツールが用意されました。 例えば、アプリ内で追跡している特定のインタラクションに基づいて製品をプロモーションする場合などです。
次へ: オファーの作成と表示