ライフサイクル追跡モジュール

インストール

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

Maven

Mavenを使用してライフサイクル追跡モジュールをインストールするには：

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

   // すべてのサブプロジェクト/モジュールに共通の構成オプションを追加するトップレベルのビルドファイル。
   allprojects {
   repositories {
         mavenCentral()
         // Tealium Mavenリポジトリディレクティブ
         maven {
         url "https://maven.tealiumiq.com/android/releases/"
         }
   }
   }
   

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

   dependencies {
   // まだ追加されていない場合のみ追加
   implementation 'com.tealium:library:5.8.0'
   // ライフサイクルを依存関係リストに追加
   implementation 'com.tealium:lifecycle:1.1.4'
   }
   

手動

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

1. Tealiumの ライフサイクル追跡モジュール モジュールをダウンロードします。

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

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

   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;

// ライフサイクル追跡のための追加インスタンス
LifeCycle.setupInstance("INSTANCE_NAME", config, isAutoTracking);
// 標準のTealiumインスタンス
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マルチトンは、Tealium iQの公開構成によりリモートで停止可能です。インスタンスを取得してそのメソッドを呼び出すときにNullチェックを実行してください。

クラッシュ検出

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

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

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

データレイヤー

ライフサイクル追跡モジュールは、リストされたライフサイクルイベントタイプ（launch、wake、sleep）に対して以下の追加変数を追加します：

API リファレンス

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