ライフサイクルデータの収集

モバイルアプリでライフサイクルデータを収集する方法を説明します。

Adobe Experience Platform Mobile SDK Lifecycle拡張機能を使用すると、モバイルアプリからライフサイクルデータを収集できます。 Adobe Experience Platform Edge Network拡張機能は、このライフサイクルデータをPlatform Edge Networkに送信し、データストリーム設定に従って他のアプリケーションやサービスに転送します。 ​ ライフサイクル拡張機能について詳しくは、製品ドキュメントを参照してください。

前提条件

学習目標

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

  • アプリが前景と背景の間を移動する際に正しく開始/一時停止することで、正確なライフサイクル指標を実現します。
  • アプリからPlatform Edge Networkにデータを送信します。
  • Assuranceでの検証:

実装の変更

これで、ライフサイクルイベントを登録するようにプロジェクトを更新できます。

iOS
  1. Xcode プロジェクトナビゲーターで​Luma > Luma > SceneDelegate​に移動します。

  2. アプリがバックグラウンド ステートから再開する場合、iOSはsceneWillEnterForeground: デリゲート メソッドを呼び出す可能性があり、このメソッドはライフサイクル開始イベントをトリガーする場所です。 このコードをfunc sceneWillEnterForeground(_ scene: UIScene)に追加します:

    code language-swift
    // When in foreground start lifecycle data collection
    MobileCore.lifecycleStart(additionalContextData: nil)
    
  3. アプリがバックグラウンドに入ると、アプリのsceneDidEnterBackground: デリゲート メソッドからのライフサイクルデータ収集を一時停止します。 このコードをfunc sceneDidEnterBackground(_ scene: UIScene)に追加します:

    code language-swift
    // When in background pause lifecycle data collection
    MobileCore.lifecyclePause()
    
Android
  1. Android Studio ナビゲーターで、app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication​に移動します。

  2. アプリがバックグラウンド ステートから再開されている場合、Androidはオーバーライド fun onActivityResumed functionを呼び出す可能性があり、この関数はライフサイクル開始イベントをトリガーする場所です。 このコードをoverride fun onActivityResumed(activity: Activity)に追加します:

    code language-kotlin
    // When in foreground start lifecycle data collection
    MobileCore.lifecycleStart(null)
    
  3. アプリがバックグラウンドに入ると、アプリのoverride fun onActivityPaused関数からのライフサイクルデータ収集を一時停止します。 このコードをoverride fun onActivityPaused(activity: Activity)に追加します:

    code language-kotlin
    // When in background pause lifecycle data collection
    MobileCore.lifecyclePause()
    

Assurance での検証

  1. シミュレーターまたはデバイスをAssuranceに接続するには、設定の手順 セクションを確認してください。
  2. アプリをバックグラウンドに送信します。 Assurance UIで​LifecyclePause イベントを確認します。
  3. アプリを前面へ。 Assurance UIで​LifecycleResume イベントを確認します。
    ​ ライフサイクルの検証 {modal="regular"}

データをPlatform Edge Networkに転送

前の演習では、前景イベントと背景イベントをAdobe Experience Platform Mobile SDKにディスパッチしました。 これらのイベントをPlatform Edge Networkに転送するには:

  1. タグプロパティで「ルール」を選択します。
    ​ ルールを作成 {modal="regular"}

  2. 使用するライブラリとして「初期ビルド」を選択します。

  3. 新しいルールを作成​を選択します。
    新しいルールを作成 {modal="regular"}

  4. ルールを作成​画面で、Application Status名前​ ​と入力します。

  5. イベント の下の​追加 追加​を選択します。
    ​ ルールを作成ダイアログ ​ {modal="regular"}

  6. イベント設定​手順では、次の操作を行います。

    1. Mobile Core​を​ 拡張機能 ​として選択します。
    2. 描画領域​を​ イベントタイプ ​として選択します。
    3. 変更を保持」を選択します。
      ​ ルールイベント設定 {modal="regular"}
  7. ルールを作成​画面に戻り、 Mobile Core - Foreground の横にある​Add Add​を選択します。
    次のイベント設定 {modal="regular"}

  8. イベント設定​手順では、次の操作を行います。

    1. Mobile Core​を​ 拡張機能 ​として選択します。
    2. 背景​を​ イベントタイプ ​として選択します。
    3. 変更を保持」を選択します。
      ​ ルールイベント設定 {modal="regular"}
  9. ルールを作成​画面に戻り、 アクション の下の​追加 追加​を選択します。

    ​ ルール追加アクション ​ {modal="regular"}

  10. アクション設定​手順では、次の操作を行います。

    1. Adobe Experience Edge Network​を​ 拡張機能 ​として選択します。
    2. イベントをEdge Network​に転送」を「アクションタイプ」として選択します。
    3. 変更を保持」を選択します。
      ​ ルールアクション設定 {modal="regular"}
  11. ライブラリに保存」を選択します。
    ​ ルール – ライブラリに保存 {modal="regular"}

  12. ライブラリを再構築するには、ビルド​を選択します。
    ​ ルール – ビルド ​ {modal="regular"}

プロパティを正常に構築すると、イベントはPlatform Edge Networkに送信され、イベントはデータストリーム設定に従って他のアプリケーションやサービスに転送されます。

AssuranceでXDM データを含む​ Application Close (Background) ​および​Application Launch (Foreground) イベントが表示されます。

Platform Edgeに送信されたライフサイクルの検証 {modal="regular"}

SUCCESS
これで、アプリケーションのステート(前景、背景)イベントをAdobe Experience Platform Edge Networkおよびデータストリームで定義したすべてのサービスに送信するようにアプリを設定しました。
Adobe Experience Platform Mobile SDKについて学ぶために時間を割いていただきありがとうございます。 ご質問がある場合、一般的なフィードバックを共有したい場合、または今後のコンテンツに関する提案がある場合は、このExperience League コミュニティ ディスカッション投稿で共有してください

次:イベントデータの追跡

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