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

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

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

前提条件

  • SDK がインストールおよび設定された状態で、アプリケーションが正常に構築および実行されました。 このレッスンでは、すでにライフサイクルの監視を開始しています。 確認するには、SDK のインストール - AppDelegate の更新を参照してください。
  • 前のレッスンの説明に従って、Assurance拡張機能を登録しました。

学習目標

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

  • アプリがフォアグラウンドとバックグラウンドの間を移動するときに正しく開始/一時停止することで、正確なライフサイクル指標を有効にします。
  • アプリから 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 モバイルSDKにディスパッチしました。 これらのイベントを Platform Edge Networkに転送するには:

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

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

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

  4. ルールの作成 画面で、「Application Status 名前 」に と入力します。

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

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

    1. 拡張機能 として Mobile Core を選択します。

    2. イベントタイプ として フォアグラウンド を選択します。

    3. 変更を保持」を選択します。

      ルールイベントの設定 {modal="regular"}

  7. ルールを作成 画面に戻り、 モバイルコア – 前景 の横にある 追加 追加 を選択します。
    次のイベントの設定 {modal="regular"}

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

    1. 拡張機能 として Mobile Core を選択します。

    2. イベントタイプ として 背景 を選択します。

    3. 変更を保持」を選択します。

      ルールイベントの設定 {modal="regular"}

  9. ルールを作成 画面に戻り、「 ACTIONS の下の 追加追加 を選択します。

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

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

    1. 拡張機能 として 0}Adobe Experience Edge Network} を選択します。

    2. アクションタイプ として 「Edge Networkにイベントを転送」を選択します。

    3. 変更を保持」を選択します。

      ルールアクションの設定 {modal="regular"}

  11. ライブラリに保存 を選択します。
    ルール – ライブラリに保存 {modal="regular"}

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

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

Assuranceに XDM データを含む Application Close (バックグラウンド) および Application Launch (フォアグラウンド) イベントが表示されます。

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

SUCCESS
これで、アプリケーションステート(フォアグラウンド、バックグラウンド)イベントをAdobe Experience Platform Edge Networkと、データストリームで定義したすべてのサービスに送信するようにアプリを設定しました。
Adobe Experience Platform Mobile SDKの学習にご協力いただき、ありがとうございます。 ご不明な点がある場合や、一般的なフィードバックをお寄せになる場合、または今後のコンテンツに関するご提案がある場合は、この Experience League Community Discussion の投稿でお知らせください

次のトピック:イベント・データの追跡

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