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

Experience PlatformMobile SDK とJourney Optimizerを使用して、モバイルアプリ用のアプリ内メッセージを作成する方法について説明します。

Journey Optimizerでは、ターゲットを絞ったオーディエンスにアプリ内メッセージを送信するキャンペーンを作成できます。 Journey Optimizerのキャンペーンは、様々なチャネルを使用して、特定のオーディエンスに 1 回限りのコンテンツを配信する場合に使用します。 キャンペーンでは、アクションは即座に、または指定したスケジュールに基づいて、同時に実行されます。 ジャーニーを使用する場合 ( Journey Optimizerプッシュ通知 レッスン ) では、アクションが順に実行されます。

アーキテクチャ

Journey Optimizerでアプリ内メッセージを送信する前に、適切な設定と統合がおこなわれていることを確認する必要があります。 Journey Optimizerのアプリ内メッセージデータフローについては、 ドキュメント.

NOTE
このレッスンはオプションで、アプリ内メッセージの送信を希望するJourney Optimizerユーザーにのみ適用されます。

前提条件

  • SDK が正常に構築され、インストールされ、設定された状態でアプリが実行されました。
  • アプリをAdobe Experience Platform用に設定します。
  • Journey Optimizerへのアクセスと十分な権限(説明を参照) ここ. また、次のJourney Optimizer機能に対する十分な権限が必要です。
    • キャンペーンを管理します。
  • 物理iOSデバイスまたはテスト用のシミュレーター。

学習内容

このレッスンでは、次の操作を行います

  • AJO でアプリサーフェスを作成します。
  • Journey Optimizerタグ拡張機能をインストールして設定します。
  • アプリを更新して、Journey Optimizerタグ拡張を登録します。
  • アシュランスで設定を検証します。
  • Journey Optimizerで独自のキャンペーンとアプリ内メッセージエクスペリエンスを定義する。
  • アプリ内から独自のアプリ内メッセージを送信します。

セットアップ

TIP
環境を既に Journey Optimizerプッシュメッセージ レッスンでは、このセットアップセクションの手順の一部を既に実行している可能性があります。

データ収集にアプリケーションサーフェスを追加する

  1. 次から: データ収集インターフェイスを選択します。 アプリのサーフェス をクリックします。

  2. 設定を作成するには、「 」を選択します。 アプリサーフェスを作成.
    アプリのサーフェスホーム

  3. を入力します。 名前 設定の場合、例: Luma App Tutorial .

  4. 送信者 モバイルアプリケーション設定 ​を選択します。 Apple iOS.

  5. にモバイルアプリのバンドル ID を入力します。 アプリ ID (iOS Bundle ID) フィールドに入力します。 例: com.adobe.luma.tutorial.swiftui.

  6. 保存」を選択します。

    アプリのサーフェス設定

データストリーム設定を更新

モバイルアプリから Edge ネットワークにデータが確実に送信されるようにするには、Experience Edge の設定を更新します。

  1. データ収集 UI で、「 」を選択します。 データストリーム ​を選択し、例えば、データストリームを選択します。 Luma Mobile App.

  2. 選択 その他 対象: Experience Platform を選択し、 編集 編集 を選択します。

  3. Adobe Analytics の データストリーム > フォルダー > Adobe Experience Platform スクリーン、確認する Adobe Journey Optimizer が選択されている。 詳しくは、 Adobe Experience Platform設定 を参照してください。

  4. データストリーム設定を保存するには、 保存.

    AEP データストリーム設定

Journey Optimizer Tags 拡張機能のインストール

アプリがJourney Optimizerで動作するようにするには、タグプロパティを更新する必要があります。

  1. に移動します。 タグ > 拡張機能 > カタログ.
  2. プロパティを開きます(例: )。 Luma Mobile App Tutorial.
  3. 選択 カタログ.
  4. を検索します。 Adobe Journey Optimizer 拡張子。
  5. 拡張機能をインストールします。

条件 のみ アプリ内でのアプリ内メッセージの使用、 拡張機能のインストール または 拡張機能の設定 ​に値を指定する場合、何も設定する必要はありません。 ただし、既に プッシュ通知 このチュートリアルでは、 開発 環境、 AJO プッシュトラッキングエクスペリエンスイベントデータセット データセットが次から選択されました: イベントデータセット リスト。

アプリでのJourney Optimizerの実装

前のレッスンで説明したように、モバイルタグ拡張機能のインストールでは設定のみが提供されます。 次に、メッセージング SDK をインストールして登録する必要があります。 これらの手順が明確でない場合は、 SDK のインストール 」セクションに入力します。

NOTE
以下を完了した場合、 SDK のインストール 」セクションに移動した場合は、SDK が既にインストールされているので、この手順をスキップできます。
  1. Xcode で、 AEP メッセージ は、パッケージの依存関係にパッケージのリストに追加されます。 詳しくは、 Swift Package Manager.

  2. に移動します。 Luma > Luma > AppDelegate 」をクリックします。

  3. 確認 AEPMessaging は、インポートのリストの一部です。

    import AEPMessaging

  4. 確認 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
    ]
    

アシュランスを使用して設定を検証

  1. 以下を確認します。 設定手順 シミュレーターまたはデバイスを Assurance に接続するには、「 」セクションを参照してください。

  2. Assurance UI で、 設定.
    クリックを設定

  3. を選択します。 プラス 隣のボタン アプリ内メッセージ.

  4. 保存」を選択します。
    保存

  5. 選択 アプリ内メッセージ をクリックします。

  6. を選択します。 検証 タブをクリックします。 エラーが表示されていないことを確認します。

    アプリ内検証

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

独自のアプリ内メッセージを作成するには、発生したイベントに基づいてアプリ内メッセージをトリガーするキャンペーンを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 オファーエンジンとのすべてのリクエストとインタラクションは、イベントハブによって処理されます。

  1. Journey Optimizer UI で、 キャンペーン をクリックします。

  2. 選択 キャンペーンを作成.

  3. Adobe Analytics の キャンペーンを作成 画面:

    1. 選択 アプリ内メッセージ をクリックし、 アプリサーフェス 例えば、リスト Luma Mobile App.

    2. 選択 作成

      キャンペーンのプロパティ

  4. キャンペーンの定義画面で、 プロパティ名前 (例:キャンペーン) Luma - In-App Messaging Campaign、および 説明 ​例: In-app messaging campaign for Luma app.
    キャンペーン名

  5. 下にスクロールして アクション ​をクリックし、次を選択します。 コンテンツを編集.

  6. Adobe Analytics の アプリ内メッセージ 画面:

    1. 選択 モーダル として メッセージのレイアウト.

    2. 入力 https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png (の) メディア URL.

    3. を入力します。 ヘッダー ​例: Welcome to this Luma In-App Message を入力し、 本文 ​例: Triggered by pushing that button in the app....

    4. 入力 解除 として ボタン#1テキスト(プライマリ).

    5. プレビューの更新方法を確認します。

    6. 選択 有効化するレビュー.

      アプリ内エディター

  7. Adobe Analytics の 有効化のレビュー(Luma — アプリ内メッセージキャンペーン) 画面、選択 編集 (内) スケジュール タイル。
    スケジュールを確認し、「スケジュール」を選択します。

  8. 戻る Luma - In-App Messaging Campaign 画面、選択 編集 編集トリガー.

  9. Adobe Analytics の アプリ内メッセージトリガー ダイアログで、アプリ内メッセージをトリガーにするトラックアクションの詳細を設定します。

    1. 削除するには アプリケーション起動イベント ​を選択します。 閉じる .

    2. 用途 追加 条件を追加 次の論理を繰り返し構築する 次の場合にメッセージを表示.

    3. 完了」をクリックします。

      トリガー論理

    トラックアクションを定義し、 アクション 次と等しい in-app そして コンテキストデータ がのキーと値のペア "showMessage" : "true".

  10. 戻る Luma - In-App Messaging Campaign 画面、選択 有効化するレビュー.

  11. Adobe Analytics の 有効化のレビュー(Luma — アプリ内メッセージキャンペーン) 画面、選択 有効化.

  12. 表示される Luma - In-App Messaging Campaign ステータス別 ライブ (内) キャンペーン リスト。
    キャンペーンリスト

アプリ内メッセージのトリガー

アプリ内メッセージを送信するためのすべての材料が揃っています。 残りの点は、アプリでこのアプリ内メッセージにトリガーを設定する方法です。

  1. に移動します。 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)
    
  2. に移動します。 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"])
    }
    

アプリを使用した検証

  1. を使用して、シミュレーターまたは Xcode の物理デバイスでアプリを再構築し、実行します。 再生 .

  2. 次に移動: 設定 タブをクリックします。

  3. タップ アプリ内メッセージ. アプリ内メッセージがアプリに表示されます。

    img-md
    w-300

アシュランスでの実装の検証

Assurance UI でアプリ内メッセージを検証できます。

  1. 以下を確認します。 設定手順 シミュレーターまたはデバイスを Assurance に接続するには、「 」セクションを参照してください。
  2. 選択 アプリ内メッセージ.
  3. 選択 イベントリスト.
  4. を選択します。 メッセージを表示 エントリ。
  5. Inspect未加工のイベント、特に html:アプリ内メッセージの完全なレイアウトとコンテンツを含む。
    アプリ内メッセージのアシュランス

次の手順

これで、関連する適用可能なアプリ内メッセージの追加を開始するためのすべてのツールが用意されました。 例えば、アプリ内で追跡している特定のインタラクションに基づいて製品をプロモーションする場合などです。

SUCCESS
アプリでアプリ内メッセージを有効にし、Experience PlatformMobile SDK 用のJourney OptimizerとJourney Optimizer拡張機能を使用して、アプリ内メッセージキャンペーンを追加しました。
Adobe Experience Platform Mobile SDK の学習に時間を割いていただき、ありがとうございます。 ご質問がある場合、一般的なフィードバックを共有する場合、または今後のコンテンツに関する提案がある場合は、このドキュメントで共有します Experience Leagueコミュニティディスカッション投稿.

次へ: オファーの作成と表示

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b