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

Experience Platform Mobile 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 タグ拡張機能を登録します。
  • Assuranceの設定を検証します。
  • Journey Optimizerで独自のキャンペーンおよびアプリ内メッセージエクスペリエンスを定義します。
  • アプリ内から独自のアプリ内メッセージを送信します。

セットアップ

TIP
Journey Optimizer プッシュメッセージレッスンの一部として既に環境を設定している場合は、この設定の節の手順のいくつかが既に実行されている可能性があります。

Journey Optimizerでのチャネル設定の作成

まず、Journey Optimizerからアプリのメッセージ通知を送信できるように、チャネル設定を作成する必要があります。

  1. Journey Optimizer インターフェイスで、チャンネル/一般設定/チャンネル設定 メニューを開き、「チャンネル設定を作成」を選択します。

    チャネル設定の作成

  2. 設定の名前と説明(オプション)を入力します。

    note note
    NOTE
    名前は、文字(A ~ Z)で始める必要があります。使用できるのは英数字のみです。アンダースコア(_)、ドット(.)、ハイフン(-)も使用できます。
  3. 設定にカスタムまたはコアのデータ使用ラベルを割り当てるには、「アクセスを管理」を選択します。詳しくは、オブジェクトレベルのアクセス制御(OLAC)を参照してください

  4. アプリ内メッセージ チャネルを選択します。

  5. この設定を使用してメッセージに同意ポリシーを関連付けるには、マーケティングアクション ​を選択します。顧客の環境設定に従うために、そのマーケティングアクションに関連付けられているすべての同意ポリシーが活用されます。 マーケティングアクションの詳細情報

  6. 設定を定義するプラットフォームを選択します。 これにより、各プラットフォームに対してターゲットアプリを指定し、複数のプラットフォームをまたいで一貫したコンテンツ配信を確保できます。

    note note
    NOTE
    iOS および Android プラットフォームの場合、配信はアプリ ID のみに基づきます。両方のアプリが同じアプリ ID を共有している場合、チャネル設定 ​で選択したプラットフォームに関係なく、コンテンツは両方に配信されます。
  7. 送信」を選択して変更を保存します。

    アプリ内チャネルの設定

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

モバイルアプリから Experience Edgeにデータが転送されるようにするには、Edge NetworkJourney Optimizerの設定を更新する必要があります。

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

  2. 2Experience Platform の「詳細 編集 ​​ 編集 ​​ を選択します。

  3. データストリーム/ フォルダー /Adobe Experience Platform 画面で、「Adobe Journey Optimizer」が選択されていることを確認します。 詳しくは、Adobe Experience Platform 設定を参照してください。

  4. データストリーム設定を保存するには、「保存」を選択します。

    AEP データストリーム設定

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

アプリがJourney Optimizerと連携するには、タグプロパティを更新する必要があります。

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

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

アプリへのJourney Optimizerの実装

前のレッスンで説明したように、モバイルタグ拡張機能をインストールしても、設定のみが提供されます。 次に、Messaging SDKをインストールして登録します。 これらの手順が明確でない場合は、「SDK のインストール の節を参照しください。

NOTE
SDK のインストールの節を完了した場合、SDKは既にインストールされているので、この手順をスキップできます。
  1. Xcode で、AEP Messaging がパッケージの依存関係のパッケージの一覧に追加されていることを確認します。 Swift パッケージマネージャーを参照してください。

  2. Xcode プロジェクトナビゲーターで 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
    ]
    

Assuranceでの設定の検証

  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やサードパーティソリューションとの統合を容易にするために、登録された拡張機能からイベントデータを公開および受け取ります。 例えば、「最適化」拡張機能がインストールされている場合、Journey Optimizer - Decision Management オファーエンジンに対するすべてのリクエストとインタラクションは、イベントハブで処理されます。

  1. Journey Optimizer UI の左パネルで「キャンペーン」をクリックします。

  2. キャンペーンを作成 を選択します。

  3. キャンペーンを作成 画面で、次の操作を行います。

    1. アプリ内メッセージ」を選択し、「アプリサーフェス」リストからアプリサーフェス(例:Luma Mobile App)を選択します。

    2. 作成」を選択します。

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

  4. キャンペーン定義画面の プロパティ で、キャンペーンの 名前 (例:Luma - In-App Messaging Campaign)と 説明 (例:In-app messaging campaign for Luma app)を入力します。
    キャンペーン名

  5. アクション までスクロールし、「コンテンツを編集」を選択します。

  6. アプリ内メッセージ 画面で、次の操作を行います。

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

    2. メディア URLhttps://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png を入力します。

    3. Header (例:Welcome to this Luma In-App Message)を入力し、Body (例:Triggered by pushing that button in the app...)を入力します。

    4. ボタンの#1 のテキスト プライマリ) ​として「解除」と入力します。

    5. プレビューの更新方法に注意してください。

    6. アクティブ化するレビュー」を選択します。

      アプリ内エディター

  7. アクティブ化するレビュー(Luma - アプリ内メッセージキャンペーン)画面 スケジュール を選択します。
    レビューのスケジュールで「スケジュール」を選択

  8. Luma - In-App Messaging Campaign 画面に戻り、「 編集 トリガーを編集 を選択します。

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

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

    2. Add Add 条件 を繰り返し使用して、「次の場合にメッセージを表示 のロジックを作成し す。

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

      トリガー ロジック

    Actionin-app に等しく、コンテキストデータ"showMessage" : "true" のキー値ペアである追跡アクションを定義しました。

  10. Luma - In-App Messaging Campaign の画面に戻り、「アクティブ化するレビュー を選択し す。

  11. アクティブ化するレビュー(Luma - アプリ内メッセージキャンペーン)画面でアクティブ化」を選択します。

  12. ステータスが ライブLuma - In-App Messaging Campaignキャンペーン リストに表示されます。
    キャンペーンリスト

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

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

  1. Xcode プロジェクトナビゲーターで Luma/Luma/Utils/MobileSDK に移動します。 func sendTrackAction(action: String, data: [String: Any]?) 関数を検索し、パラメーター action および data に基づいて MobileCore.track 関数を呼び出す次のコードを追加します。

    code language-swift
    // Send trackAction event
    MobileCore.track(action: action, data: data)
    
  2. Xcode プロジェクトナビゲーターで 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. アプリ内メッセージ をタップします。 アプリ内メッセージがアプリに表示されます。

    {width="300"}

Assuranceでの実装の検証

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

  1. 設定手順の節を参照して、シミュレーターまたはデバイスをAssuranceに接続します。
  2. アプリ内メッセージ」を選択します。
  3. イベントリスト を選択します。
  4. メッセージを表示 エントリを選択します。
  5. 生のイベント(特に、アプリ内メッセージの完全なレイアウトとコンテンツを含む html)を検査します。
    Assuranceのアプリ内メッセージ

次の手順

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

SUCCESS
アプリ内メッセージ用にアプリを有効にし、Journey Optimizerと、Experience Platform Mobile SDK用のJourney Optimizer拡張機能を使用して、アプリ内メッセージキャンペーンを追加しました。
Adobe Experience Platform Mobile SDKの学習にご協力いただき、ありがとうございます。 ご不明な点がある場合や、一般的なフィードバックをお寄せになる場合、または今後のコンテンツに関するご提案がある場合は、この Experience League Community Discussion の投稿でお知らせください。

次のトピック:オファーの作成および表示

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