Lifecycle Trackingモジュール

インストール

Lifecycle TrackingモジュールをMavenによって、または手動でインストールします。

Maven

Lifecycle TrackingモジュールをMavenによってインストールするには：

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

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

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

   dependencies {
    // only add if not already present
    implementation 'com.tealium:library:5.7.2'
    // add lifecycle to list of dependencies
    implementation 'com.tealium:lifecycle:1.1.4'
   }

手動

Lifecycle Trackingモジュールを手動でインストールするには、以下の手順に従います。

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

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

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

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

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

このモジュールは、lifecycle_type変数によって設定される以下のライフサイクルイベントをトラッキングします。

Tealiumのライフサイクルトラッキングでは、もっぱら使用状況をアクティビティのライフサイクルに関連付けます。

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

以下のコードを使用して有効化されます。

Tealium.Config config = Tealium.Config.create(application, "ACCOUNT", "PROFILE", "ENVIRONMENT");
boolean isAutoTracking = true;

// Additional instance for Lifecycle Tracking
LifeCycle.setupInstance("INSTANCE_NAME", config, isAutoTracking);
// Standard Tealium instance
Tealium.createInstance("INSTANCE_NAME", config);

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

特定のライフサイクルパラダイムおよび通常とは異なるライフサイクルトラッキングに使用できます。ほとんどの実装には、この方法は推奨しません。手動のライフサイクルトラッキングを許可するには、ライフサイクル初期化コードを更新し、isAutoTrackingをfalseに設定します。

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

LifeCycle lifeCycle = LifeCycle.getInstance(TEALIUM_INSTANCE_ID);

if(lifeCycle != null) {

    // OPTIONAL
    Map<String, String> data = new HashMap<>();
    data.put("boot_time", "5ms");

    lifeCycle.trackLaunchEvent(data);
}

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

LifeCycle lifeCycle = LifeCycle.getInstance(TEALIUM_INSTANCE_ID);

if(lifeCycle != null) {

    // OPTIONAL
    Map<String, String> data = new HashMap<>();
    data.put("foreground_time", "4000ms");

    lifeCycle.trackSleepEvent(data);
}

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

LifeCycle lifeCycle = LifeCycle.getInstance(TEALIUM_INSTANCE_ID);

if(lifeCycle != null) {

    // OPTIONAL
    Map<String, String> data = new HashMap<>();
    data.put("background_time", "600000ms");

    lifeCycle.trackWakeEvent(data);
}

Tealiumおよび付随するLifeCycle Multitonは、Tealium iQの公開設定からリモートで終了できます。インスタンスでメソッドを呼び出す場合は、Nullチェックを実行してください。

クラッシュ検知

wakeイベントに続いてlaunchイベントが発生する場合、またはその逆の場合も、アプリケーションが正常にsleepしなかったためクラッシュが発生したことを示します。Tealiumライブラリのシャットダウンにより上記のような連続イベントが発生した場合は、クラッシュイベントとは見なされません。

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

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

データ層

Lifecycle Trackingモジュールにより、リストに記載されたライフサイクルイベントのタイプ（launch、wake、sleep）に合わせて、以下の変数が追加されます。

APIリファレンス

Lifecycle Trackingモジュールのメソッドの完全なリファレンスについては、Tealium SDK for Android APIのLifeCycleクラスを参照してください。