Tealiumツール モバイルQRトレース

仕組み

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

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

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

次の図はその仕組みを示しています:

インストール

このツールを使用するには、まずTealium Tools拡張機能を使用してChromeブラウザに追加する必要があります。この拡張機能をインストールするには、Tealium Tools Browser Extensionを参照してください。

URLで追加テキストフィールドに、URLを貼り付けます：https://solutions.tealium.net/hosted/tealiumTools/mobile-trace/tool.json

インストールが完了したら、Tealium Tools拡張機能からMobile Trace Toolアイコンを起動します。

URLスキーム

モバイルトレースツールを使用するためには、AndroidとiOSのアプリがどのURLを処理するかを判断し、URLスキームを構成する必要があります。

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

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

一部のアプリはhttpやhttpsの代わりにカスタムURLスキームを登録します。例えばmycompanyapp://など。これらもモバイルトレースツールと一緒に動作します。

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

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

トレース

以下では、モバイルトレースツールを使用してトレースを開始し、トレースを離れる方法について説明します。

トレースの開始

トレースを開始する前に、サーバーサイドのCustomer Data Hubにいることを確認します。モバイルトレースツールでトレースを開始をクリックすると、新しいトレースが開始され、モバイルトレースQRコードがトレースウィンドウに追加されます。

Tealium Tools UIから一度トレースを開始した後は、Tealium Tools UIを閉じて、そのセッションの残りの時間は使用する必要はありません。

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

トレースを離れる

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

トレースを離れるには：

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

訪問の終了（AudienceStream）

Tealium AudienceStreamで"訪問の終了"アクションをテストするには、訪問のセッションを即座に終了する信号が必要です。それ以外の場合は、セッションが通常通りに期限切れになるのを待つ必要があります。

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