ライフサイクルトラッキングモジュール

インストール

Mavenまたは手動でライフサイクルトラッキングモジュールをインストールします。

Maven

Mavenを使用してライフサイクルトラッキングモジュールをインストールするには、次の手順を実行します。

1. プロジェクトのトップレベルの build.gradle ファイルに、次のMavenリポジトリを追加します:

   // Top-level build file where you add configuration options common to all sub-projects/modules.
   allprojects {
       repositories {
         mavenCentral()
         // Tealium Maven repo directive
         maven {
             url "https://maven.tealiumiq.com/android/releases/"
         }
       }
   }
   

2. プロジェクトモジュールの build.gradle ファイルに、次のMaven依存関係を追加します:

   dependencies {
       // 既に存在しない場合のみ追加
       implementation 'com.tealium:kotlin-core:1.5.5'
       // ライフサイクルを依存関係のリストに追加
       implementation 'com.tealium:kotlin-lifecycle:1.2.0'
   }
   

手動

ライフサイクルトラッキングモジュールを手動でインストールするには、次の手順を実行します。

1. Tealiumの Lifecycle Tracking Module モジュールをダウンロードします。

2. tealium-kotlin.lifecycle-1.2.0.aar ファイルをプロジェクトの <PROJECT_ROOT>/<MODULE>/libs ディレクトリにコピーします。

3. プロジェクトモジュールの build.gradle ファイルにTealiumライブラリの依存関係を追加します:

   dependencies {
         implementation(name:'tealium-kotlin.lifecycle-1.2.0', ext:'aar')
   }
   

自動トラッキングされるイベント

モジュールは、lifecycle_type 変数で構成される以下のライフサイクルイベントをトラッキングします:

Tealiumのライフサイクルトラッキングは、アクティビティのライフサイクルとの関連付けのみを行います。

このライブラリは、Application.ActivityLifecycleCallbacks APIを利用し、onActivityResumed および onActivityPaused で条件を評価します。

以下のコードで有効になります:

val config = TealiumConfig(
                applicaiton,
                "accountName",
                "profileName",
                Environment.DEV,
                modules = mutableSetOf(Modules.Lifecycle)
                )

手動トラッキングされるイベント

特定のライフサイクルパラダイムや非標準的なライフサイクルトラッキングに使用できます。ほとんどの実装にはおすすめしません。手動ライフサイクルトラッキングを許可するには、ライフサイクルの初期化コードで isAutoTrackingEnabled を false に構成します。

構成オプション

val config = TealiumConfig(...)

config.isAutoTrackingEnabled = false

launch イベントを手動でトラッキングするには、trackLaunchEvent() メソッドを呼び出します:

tealium.lifecycle?.trackLaunchEvent()

sleep イベントを手動でトラッキングするには、trackSleepEvent() メソッドを呼び出します:

tealium.lifecycle?.trackSleepEvent()

wake イベントを手動でトラッキングするには、trackWakeEvent() メソッドを呼び出します:

tealium.lifecycle?.trackWakeEvent()

クラッシュ検出

launch イベントが wake イベントの後に続くか、その逆の場合、これはアプリが正常に sleep しなかったことを示し、クラッシュが発生したことを示します。前述のシーケンスがTealiumライブラリのシャットダウンによるものである場合、これはクラッシュイベントとは見なされません。

クラッシュイベントが検出されると、launch または wake イベントのデータに lifecycle_diddetectcrash 変数が追加されます。

{
    "lifecycle_type" : "launch",
    "lifecycle_diddetectcrash" : "true",
    //...
}

データレイヤー

ライフサイクルトラッキングモジュールは、次の追加変数をリストされたライフサイクルイベントタイプ（launch、wake、sleep）に追加します:

APIリファレンス

ライフサイクルトラッキングモジュールで使用されるメソッドのリファレンスについては、Tealium SDK for Android APIの LifeCycle クラスを参照してください。