トレース | モバイル用ティーリウム・プリズム

Traceモジュールは、Tealium Prism SDKのデバッグおよびテスト機能を提供します。トレースセッションを使用してイベントをリアルタイムで監視し、イベントが正しくトラッキングおよびディスパッチされていることを確認します。トレースがアクティブな場合、サーバー側でのフィルタリングと分析のために、すべてのトラッキングイベントへトレースIDが自動的に追加されます。

トレースツールの詳細については、トレースによるデバッグを参照してください。

収集されるデータポイント

トレースセッションがアクティブな場合、Traceモジュールは次のデータを収集します。

データポイント	キー	説明
トレースID	`cp.trace_id`	アクティブなトレースセッションの一意の識別子（レガシー互換性用）
トレースID	`tealium_trace_id`	アクティブなトレースセッションの一意の識別子

インストール

Traceモジュールは、プログラムによる構成、リモートJSON構成、またはローカルJSON構成を使用して構成できます。

トレースIDを含めるイベントを制限するには、モバイルプロファイルにTraceモジュールを追加し、ルールを割り当てます。詳細については、ルールを参照してください。

React Nativeでは、Tealium構成JSONを通じてTraceモジュールを有効にします。プログラムによるセットアップは必要ありません。

Tealium構成にTraceモジュールを追加します。

val config = TealiumConfig.Builder(
    application = application,
    accountName = "tealiummobile",
    profileName = "your-profile",
    environment = "dev",
    modules = listOf(Modules.trace())
).build()

強制構成を使用して構成するには、次のようにします。

val config = TealiumConfig.Builder(
    application = application,
    accountName = "tealiummobile",
    profileName = "your-profile",
    environment = "dev",
    modules = listOf(Modules.trace {
        it.setEnabled(true)
            .setTrackErrors(true)
    })
).build()

Tealium構成にTraceモジュールを追加します。

let config = TealiumConfig(account: "tealiummobile",
                          profile: "your-profile",
                          environment: "dev",
                          modules: [
                              Modules.trace(),
                              // other modules...
                          ])

強制構成を使用して構成するには、次のようにします。

let config = TealiumConfig(account: "tealiummobile",
                          profile: "your-profile",
                          environment: "dev",
                          modules: [
                              Modules.trace(forcingSettings: { builder in
                                  builder.setEnabled(true)
                                         .setTrackErrors(true)
                              }),
                              // other modules...
                          ])

JSON構成

ローカルまたはリモートの構成JSONファイルでTraceモジュールを構成します。

{
    "modules": {
        "Trace": {
            "module_type": "Trace",
            "enabled": true,
            "configuration": {
                "track_errors": true
            }
        }
    }
}

トレースセッションへの参加

トレースセッションを開始するには、トレースIDを指定してtrace.join()を呼び出します。leave()を呼び出すかセッションが期限切れになるまで、以降のすべてのイベントにトレースIDが追加されます。

tealium.trace.join("your-trace-id")
    .subscribe { result ->
        // Optionally handle result here
    }

tealium.trace.join(id: "your-trace-id").subscribe { result in
    // Optionally handle result here
}

await tealium.trace.join("your-trace-id");

トレースセッションからの退出

トレースセッションを停止するには、trace.leave()を呼び出します。これにより、以降のイベントからトレースIDが削除されます。

tealium.trace.leave()
    .subscribe { result ->
        // Optionally handle result here
    }

tealium.trace.leave().subscribe { result in
    // Optionally handle result here
}

await tealium.trace.leave();

訪問の強制終了

Customer Data Platform（CDP）で「End of Visit」アクションをテストするには、セッションが期限切れになるのを待たずに、セッションを直ちに強制終了します。

tealium.trace.forceEndOfVisit()
    .subscribe { result ->
        // Handle the track result
    }

tealium.trace.forceEndOfVisit().subscribe { result in
    // Handle the track result
}

await tealium.trace.forceEndOfVisit();

leave()が呼び出されるまで、トレースはアクティブなままです。forceEndOfVisit()メソッドは、標準のデキュー処理フローに従って、セッションの終了を通知するトラッキング呼び出しをディスパッチします。

エラートラッキング

エラートラッキングが有効な場合（track_errors: true）、Traceモジュールは、アクティブなトレースセッション中に発生したSDKエラーを自動的にトラッキングします。重複するエラーレポートを防ぐため、モジュールはカテゴリごとにエラーを重複排除します。

トレースセッションごとに、各カテゴリの最初のエラーのみがトラッキングされます
同じカテゴリで後続のエラーが発生しても、新しいトレースセッションが開始されるまでは無視されます
新しいトレースセッションへの参加または現在のセッションからの退出によって、重複排除キャッシュがリセットされます

QRトレース

ディープリンクから直接トレースを開始することもできます。開いたURLに適切なクエリパラメータが含まれている場合、トレースは自動的に開始されます。通常、これはTealiumプラットフォームのQRトレースツールを使用して行います。詳細については、トレースによるデバッグを参照してください。

APIリファレンス

クラスおよびメソッドの詳細なシグネチャについては、APIリファレンスドキュメントを参照してください。