トレース | モバイル用の開始ガイド

トレースは、Tealium EventStreamおよびTealium AudienceStreamの構成をテストおよび検査するためのツールです。トレースを使用して訪問のワークフローをキャプチャし、イベントと顧客データがリアルタイムでどのように処理されるかを確認します。

モバイルトレースツール

対応プラットフォーム

以下のプラットフォームがモバイルトレースツールをサポートしています：

大量のイベントにトレースを追加しないでください。
本番データを監視するためにトレースを永続的なパラメータとして追加しないでください。

使い方

モバイルトレースツールは、デバイスでスキャン可能なQRコードを提供することでトレース機能をエンリッチメントします。

ツールでトレース開始をクリックした後、Tealiumプラットフォームのセッションごとに一度、新しいトレースを開始するたびにメインブラウザウィンドウに自動的にQRコードが挿入されます。

QRコードは各プラットフォーム（AndroidまたはiOS）ごとに生成されます。適切なQRコードをモバイルデバイスのカメラでスキャンした後、QRコードからのリンクをクリックしてアプリを起動し、トレースパラメータをTealium SDKに渡します。Tealium SDKはトレースID（その他のパラメータと共に）を受け取り、現在のセッションのデータレイヤーにトレースIDを挿入します。

その後のすべてのイベントは、セッションを終了するかトレースを離れるまでトレースセッションに記録されます。

次の図は、その動作を示しています：

インストール

このツールを使用するには：

ブラウザ用のTealium Toolsブラウザ拡張機能をインストールします。
インストールが完了したら、Tealium Tools拡張機能を開きます。
ツールカタログタブをクリックします。
モバイルトレースツールをクリックします。

URLスキーム

モバイルトレースツールを使用するには、モバイルアプリが処理するURLを特定して、URLスキームを構成します。

QRコードトレース機能は、URLからアプリを起動し、特定のクエリパラメータをリッスンします。URLから直接アプリを起動するには、アプリが特定のドメインを処理するように登録されている必要があります。

通常、ほとんどのアプリはすでに特定のURLを処理しています。たとえば、ウェブサイトのドメインがhttps://mycompany.comである場合、アプリはこのドメインのハンドラとして自身を登録し、ユーザーのデバイスにアプリがインストールされている場合、ユーザーはブラウザではなくアプリでリンクを起動するように促されます。

一部のアプリはmycompanyapp://のようなカスタムURLスキームを登録している場合がありますが、これらもモバイルトレースツールで機能します。

アプリを起動するURLスキームを確立したら、モバイルトレースツールの入力フィールドにこれらを入力します。ツールは必要に応じてAndroidとiOSで異なるスキームをサポートしますが、通常は両プラットフォームで同じです。

各URLスキームの横にある保存をクリックして、構成をブラウザのlocalStorageに保存します。URLスキームを必要に応じて編集するには、青い鉛筆アイコンをクリックします。

トレースを開始する

トレースを開始する前に、Tealiumのサーバーサイドプラットフォームにいることを確認します。モバイルトレースツールでトレース開始をクリックして新しいトレースを開始し、トレースウィンドウにモバイルトレースQRコードを追加します。

トレースを開始した後、Tealium ToolsのUIを閉じます。それ以降のセッションでは必要ありません。

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

トレースを離れる

トレースセッションを終了せずに離れる場合、別のデバイスから同じトレースに再参加することができ、そのトレースセッションの履歴を失うことはありません。

トレースを離れるには：

トレースUIでトレースを離れるチェックボックスを選択します。
QRコードを再度デバイスのカメラでスキャンします。
デバイスがトレースセッションに参加しないようにするためのリンクをクリックします。

訪問の終了（AudienceStream）

Tealium AudienceStreamで「訪問の終了」アクションをテストするには、訪問のセッションを即座に終了するシグナルが必要です。そうでなければ、通常のセッションの有効期限が切れるのを待つ必要があります。

モバイルトレースツールでは、訪問セッションの終了チェックボックスを選択することで、SDKがkill_visitor_sessionイベントを送信するようにQRコードにパラメータを追加し、セッションを即座に終了します。

Charles Proxy

Charles Webデバッグプロキシを使用して、モバイルSDKとTealium Collectタグを使用するアプリケーションからトレースを開始します。

必要条件

構成

Charlesをコンピューターを介してトラフィックをプロキシするようにモバイルデバイスを構成するには、AndroidまたはiOSデバイスの指示に従ってください。

リライトを使用する

Charlesをプロキシとして使用してアプリケーションを実行し、tealのネットワークトラフィックをフィルタリングします。リクエストを右クリックしてURLをコピーを選択します。

Charlesメニューからツール > リライトを選択してリライト構成ダイアログを開きます。

ロケーションを追加するには：

リライトを有効にするチェックボックスを選択し、ロケーションリストの下にある追加をクリックします。
名前フィールドにトレースIDを追加と入力し、追加をクリックしてロケーションを追加します。
ロケーションフィールドに必要な情報を入力し、ホストにCollectタグのURLを入力します。

編集ロケーションダイアログボックスの外をクリックすると、Charlesが追加のURLコンポーネントを自動的に決定します。
クエリフィールドを空のままにしてOKをクリックします。

アクションを追加するには：

アクションリストの下にある追加をクリックし、リストからタイプをBodyに構成します。
どこでセクションでリクエストチェックボックスを選択します。
一致セクションで値を"data":{に構成し、値全体を一致チェックボックスを選択します。
置換セクションで値を"data":{"cp.trace_id":"TRACE_ID",に構成し、最初のものを置換チェックボックスを選択します。
OKをクリックして変更を適用します。

手順を完了した後、アプリケーションを参照し、AudienceStreamまたはEventStreamのトレースセッションでリクエストを表示します。別のトレースを実行するには、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"])