デバッグにトレースを使用する方法について説明します。
トレースは、イベントストリーミングおよび顧客データプラットフォーム(CDP)の構成をテスト、検査するためのツールです。トレースを使用すると、訪問のワークフローをキャプチャし、イベントと顧客データがリアルタイムで処理される様子を確認できます。
モバイルトレースツール
サポートされるプラットフォーム
モバイルトレースツールでは、次のプラットフォームがサポートされています。
一括イベントにトレースを追加しないでください。
本番データを監視するための永続的なパラメータとしてトレースを追加しないでください。
仕組み
モバイルトレースツールでは、デバイスでスキャン可能なQRコードを提供することでトレース機能をエンリッチメントし、Tealium Mobile SDKから送信されるイベントをすばやく確認できるようにします。
ツールでトレースを開始をクリックすると、Tealiumプラットフォームのセッションごとに1回、新しいトレースを開始するたびにQRコードがメインブラウザーウィンドウへ自動的に挿入されます。
QRコードは、プラットフォーム(AndroidまたはiOS)ごとに生成されます。モバイルデバイスのカメラで該当するQRコードをスキャンした後、QRコードのリンクをクリックしてアプリを起動し、トレースパラメータをTealium SDKに渡します。Tealium SDKはトレースIDを(その他のパラメータとともに)受信し、現在のセッションのデータレイヤーに挿入します。
その後のすべてのイベントは、セッションを終了するかトレースから退出するまで、トレースセッションに記録されます。
次の図は、この仕組みを示しています。

インストール
このツールを使用するには、次の手順を実行します。
- 使用するブラウザーにTealium Toolsブラウザー拡張機能をインストールします。
- インストールが完了したら、Tealium Tools拡張機能を開きます。
- ツールカタログタブをクリックします。
- モバイルトレースツールをクリックします。

URLスキーム
モバイルトレースツールを使用するには、モバイルアプリで処理されるURLを確認し、URLスキームを構成します。
QRコードによるトレース機能は、URLからアプリを起動し、特定のクエリパラメータをリッスンします。URLからアプリを直接起動するには、特定のドメインを処理するようにアプリが登録されている必要があります。
通常、ほとんどのアプリはすでに特定のURLを処理するように構成されています。たとえば、Webサイトのドメインがhttps://mycompany.comの場合、アプリはこのドメインのハンドラーとして登録されます。アプリがユーザーのデバイスにインストールされている場合、ブラウザー内ではなくアプリでリンクを開くようユーザーに求めるメッセージが表示されます。
一部のアプリでは、httpやhttpsの代わりにmycompanyapp://などのカスタムURLスキームが登録されています。これらもモバイルトレースツールで使用できます。
アプリを起動するURLスキームを確認したら、モバイルトレースツールの入力フィールドに入力します。必要に応じてAndroidとiOSで異なるスキームを使用できますが、通常は両方のプラットフォームで同じスキームを使用します。

各URLスキームの横にある保存をクリックし、ブラウザーのlocalStorageに構成を保存します。必要に応じて青い鉛筆アイコンをクリックし、URLスキームを編集します。
トレースの開始
トレースを開始する前に、Tealiumのサーバーサイドプラットフォームを使用していることを確認してください。モバイルトレースツールでトレースを開始をクリックして新しいトレースを開始し、モバイルトレース用QRコードをトレースウィンドウに追加します。

トレースを開始した後、以降のセッションでは必要ないため、Tealium ToolsのUIを閉じます。
以降のトレースはTealiumから直接開始します。新しいトレースを開始するたびに、QRコードが自動的に更新されます。デバイスのカメラでQRコードをスキャンし、リンクをクリックしてアプリを起動すると、トレースが自動的に開始されます。トレースへの参加後にアプリで生成されたTealiumイベントは、すべてトレースセッションに記録されます。

Trace QR Code
トレースからの退出
トレースセッションを終了せずに退出した場合、そのトレースセッションの履歴を失うことなく、別のデバイスから同じトレースに再参加できます。
トレースから退出するには、次の手順を実行します。
- トレースUIでトレースから退出チェックボックスを選択します。
- デバイスのカメラでもう一度QRコードをスキャンします。
- リンクをクリックし、デバイスをトレースセッションから退出させます。
訪問の終了(顧客データプラットフォーム(CDP))
CDPで「訪問の終了」アクションをテストするには、訪問のセッションを即座に終了するシグナルが必要です。そうしない場合、セッションが通常どおり期限切れになるまで待つ必要があります。
モバイルトレースツールで訪問セッションを終了チェックボックスを選択すると、SDKにkill_visitor_sessionイベントを送信させるパラメータがQRコードに追加され、セッションが即座に終了します。

Trace End Visit
Charles Proxy
Charles Web Debugging Proxyを使用して、Mobile SDKおよびTealium Collectタグを使用するアプリケーションからトレースを開始します。
要件
セットアップ
コンピューター上のCharlesを経由してトラフィックをプロキシするようモバイルデバイスを構成するには、AndroidまたはiOSデバイス向けの手順に従ってください。
リライトの使用
Charlesをプロキシとして使用してアプリケーションを実行し、ネットワークトラフィックをtealでフィルタリングします。リクエストを右クリックし、URLをコピーを選択します。
Charlesのメニューからツール > リライトを選択し、リライト構成ダイアログを開きます。
ロケーションを追加するには、次の手順を実行します。
リライトを有効化チェックボックスを選択し、ロケーションリストの下にある追加をクリックします。
名前フィールドに
Add Trace IDと入力し、追加をクリックしてロケーションを追加します。ロケーションの各フィールドに必要な情報を入力し、ホストにCollectタグのURLを入力します。
ロケーションを編集ダイアログボックスの外側をクリックすると、Charlesが追加のURLコンポーネントを自動的に判別します。
クエリフィールドは空のままにし、OKをクリックします。
アクションを追加するには、次の手順を実行します。
- アクションリストの下にある追加をクリックし、リストからタイプを
Bodyに構成します。 - 対象セクションで、リクエストチェックボックスを選択します。
- 一致セクションで、値を
"data":{に構成し、値全体に一致チェックボックスを選択します。 - 置換セクションで、値を
"data":{"cp.trace_id":"TRACE_ID",に構成し、最初のみ置換チェックボックスを選択します。 - OKをクリックし、変更を適用します。
手順の完了後、アプリケーションを操作し、CDPまたはイベントストリーミングのトレースセッションでリクエストを確認します。別のトレースを実行するには、Charlesを起動して既存のリライトルールを編集し、TRACE_IDプレースホルダーを新しいトレースID値に変更します。
手動
エミュレーターを使用した開発モードの場合、またはCharlesを使用しない場合は、ネイティブコードを使用して手動でトレースに参加したり、トレースから退出したりできます。
トレースを開始する(手動)
トレースを手動で開始して実行するには、ネイティブコード内の揮発性データにトレースIDを追加します。
instance.getDataSources().getVolatileDataSources().put("tealium_trace_id", "TRACE_ID");
Swift
tealium?.volatileData()?.add(data: ["tealium_trace_id": "TRACE_ID"])
Objective-C
NSDictionary *tealiumTrace = @{@"tealium_trace_id":@"TRACE_ID"};
[[Tealium instanceForKey:TEALIUM_INSTANCE_ID] addVolatileDataSources: tealiumTrace];
トレースを終了する(手動)
トレースを手動で終了し、「訪問の終了」エンリッチメントをシミュレートするには、アプリ内の任意の場所で、次のトラックをオプションデータに追加します。
Map<String, Object> data = new HashMap<>(1);
data.put("event", "kill_visitor_session");
data.put("cp.trace_id", "TRACE_ID");
tealium?.trackViewWithTitle("SCREEN_NAME", dataSources: ["event":"kill_visitor_session", "cp.trace_id":"XXXXX"])
最終更新日 :: 2026年November月18日