トラブルシューティング

基本

モバイルアプリをテストする場合は、Tealiumの"dev"環境でのみテストし、"prod"ではテストしないことをお勧めします。また、テスト用に特別に設計されたアプリのビルドを使用してください。本番ビルド（App Store/Playストア）を使用する必要がある場合は、環境の切り替えに関する以下のセクションを参照して、ライブアプリケーションに変更を加えないようにしてください。

デバッグ中に変更を公開する場合は、TealiumのCDNキャッシュの5分の有効期限が適用されます。この期間中、utag.jsファイルは公開後にCDNで更新されます。

アプリをコールドスタートから起動するたびに（以前はアプリをアプリトレイからスワイプしていました）、Tealium SDKは新しいファイルの有無をチェックし、その後はデフォルトで15分ごとにチェックします（モバイル公開設定で制御）。ただし、公開から5分未満の場合は、アプリを再起動しても、5分の有効期限が切れるまでは新しいファイルが使用可能にならないことがあります。テスト中に"dev"環境と"qa"環境を切り替えると、環境のキャッシュが過去5分以内に使用されていない場合に期限切れになり、新しいファイルがすぐに使用可能になるため、この問題が多少緩和されます。

Tealium EventStream Live Events

Tealium EventStreamのLive Events機能は、モバイルインストールのデバッグを目的として、すべてのTealiumユーザーに提供されています。

この機能を本番環境で有効にすると、ボリュームの使用量に応じた料金を請求される場合があります。アプリの本番運用を開始する前に、この機能を無効にしておいてください。

イベント収集機能は次のいずれかの方法で有効にします。

オプション1 - Tealium Collectタグ

Tealium Collectタグをタグマーケットプレイスから追加します。タグが本番環境に公開されて、使用料金が発生するのを防ぐため、タグの詳細設定でQAおよび本番環境をオフに切り替えます。リクエストはPOSTリクエストのエンコード済みJSONデータとしてアプリから送信されるため、Charles Proxyと組み合わせて使用​​するのは困難です。ただし、Cookieデータや拡張機能によって変更された変数など、すべてのデータをWebViewから表示できるという利点があります。タグ構成で特定のプロファイルを入力しない場合、データはアプリのターゲットと同じプロファイルに送信されます。データを特定のプロファイルに送信する必要がある場合は、Tealium Collectタグのセットアップガイドを参照してください。

オプション2 - Tealium Collectモジュール

iQアカウントでモバイル公開設定に移動して、”Tealium Collect”を有効にします。この方法の利点は、データがGETリクエストとして送信され、各データ変数が判読しやすいクエリパラメータの形式でクエリ文字列に追加されることです。この方法は、Charles Proxyを使用してデータを検査する場合に最適です。予期しない使用料金が請求されるのを防ぐため、アプリを本番環境にプッシュする前にこの設定をオフにしておいてください。アプリ開発者によってTealiumに渡されたデータのみが表示され、Cookieデータや拡張機能によって生成されたデータなど、このリクエストのWebViewからのデータは表示されません。

デフォルトで、この機能を使用して送信されるデータは、アプリで現在選択されているプロファイルではなく、アカウントの「メイン」プロファイルに送信されます。これを調整するには、次のコードスニペットをアプリで使用してディスパッチURLをオーバーライドし、適切なアカウント/プロファイルの組み合わせを代入します。

Tealium.Config config = Tealium.Config.create(application, "[ACCOUNT]", "[PROFILE]", "ENVIRONMENT");config.setOverrideCollectDispatchUrl("https://collect.tealiumiq.com/vdata/i.gif?tealium_account=[ACCOUNT]&tealium_profile=[PROFILE]");

TEALConfiguration *configuration = [TEALConfiguration configurationWithAccount:@"[account]"profile:@"[profile]" environment:@"dev"];[configuration setOverrideCollectDispatchURL:@"https://collect.tealiumiq.com/vdata/i.gif?tealium_account=[account]&tealium_profile=[profile]"];

上記のいずれかの収集方法を設定し終えたら、EventStreamにログインし、Live Eventsに移動して受信イベント確認します。

Live Eventsの使用の詳細については、こちらを参照してください。

Charles Proxy

Charlesウェブデバッグプロキシを使用すると、Tealium iQを介して設定したサードパーティサービスとデバイスとの間のすべてのHTTPおよびSSL/HTTPSトラフィックを検査できます。

お使いのAndroidまたはiOSデバイスをプロキシするようCharlesを設定します。

Tealium環境の切り替え

変更を表示するために、アプリがターゲットとしているデフォルト環境（「本番」など）から別の環境に切り替える必要が生じる場合があります。環境を切り替えるには、Charles Proxy（またはFiddlerなどの他のプロキシツール）にカスタムマッピングを追加します。これにより、アプリに提供されているファイルが透過的に切り替えられます。たとえば、アプリが「本番」用のutag.jsをリクエストしても、Charlesプロキシからは「開発」用のutag.jsが提供されます。

以下の構成手順により、別のTealium環境に切り替えることができます。

1. Charles Proxyを開いて、[Tools] > [Map Remote]に移動します。[Map Remote Settings]画面で、[Enable Map Remote]チェックボックスをオンにして、[Add]をクリックします。
2. [Host]ボックスに、「https://tags.tiqcdn.com/utag///prod/*」を貼り付けて、お使いのアカウントとプロファイルをURLに代入します。貼り付けた後で、カーソルを動かして[Map From]セクションの[Port]または[Path]フィールドをクリックします。URLがコンポーネントパーツに自動的に分離されます。
3. [Map To]セクションで、同じプロセスをもう一度実行します。今回は、ターゲットにする環境に応じて、URLで環境を「prod」から「dev」（または「qa」）に変更します。URLの末尾からアスタリスク文字を削除します。たとえば、「https://tags.tiqcdn.com/utag///dev/」のようにします。
4. [OK]をクリックしてセットアップを完了します。

すべてのリクエストが「本番」環境から「開発」環境に切り替えられました。アプリのデフォルトの環境に戻すには、マップリモートルールを無効化または削除するか、デバイスでプロキシをオフにします。

この設定を有効にするには、アプリを強制終了して再起動してください。

トラフィックの検査

以下は、Charles Proxyを使用して検査する一般的なリクエストの例です。

トレース

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

要件

• Charles Proxy
• Tealium Customer Data Hubアカウント

Charles Proxyでの書き換えの使用

この手順では、モバイルSDKとCollectタグを使用してアプリケーションからのトレースを開始するために、Charlesウェブデバッグプロキシを使用します。

コンピュータのトラフィックをコンピュータ上のCharlesにプロキシするようにモバイルデバイスを設定するには、iOSまたはAndroid向けの手順に従います。

Charlesをプロキシとして使用してアプリケーションを実行し、Charlesのネットワークトラフィックを「teal」でフィルター処理します。リクエストを右クリックして、[Copy URL]を選択します。

Charlesのメニューから[Tools] > [Rewrite]をクリックし、[Enable Rewrite]をクリックします。

• [Name]フィールドに「Add Trace ID」と入力します。
• [Add]をクリックして位置を追加します。
• *[Host]*フィールドに、CollectタグのURLを入力するか貼り付けます。
• *[Edit Location]*ダイアログボックスの外部をクリックします。URLの追加のコンポーネントが自動的に決定されます。
• クエリパラメータが空であることを確認し、*[Query]*フィールド内の既存のテキストを削除します。
• [OK]をクリックして、[Rewrite Settings]ダイアログの[Actions]リストで[Add]をクリックします。

*[Rewrite Settings]*ダイアログで、設定を指定します。

• *[Type]*フィールドで、ドロップダウンリストから[Body]を選択します。
• *[Where]*で[Request]チェックボックスをオンにします。
• *[Value]フィールドで、[Match]*に「"data":{」と入力します。
• [Match whole value]チェックボックスをオンにします。
• *[Value]フィールドで、[Replace]*に「"data":{"cp.trace_id":"TRACE_ID",」と入力します。
• [Replace first]チェックボックスをオンにします。

これで手順は完了です。アプリケーションをブラウズして、AudienceStream/EventStreamトレースセッションでリクエストを表示します。

前回のセットアップの設定は保存されており、トレースのたびにこれらの手順を実行する必要はありません。別のトレースを実行するには、Charlesを起動し、既存の書き換えルールを編集してトレースIDの*12345*値を変更します。

ネイティブコードを使用したトレースIDの追加

Charles Proxyを使用しない場合、または開発モードのままでシミュレータを使用している場合、トレースを実行するよりも迅速な方法は、ネイティブコード内の揮発性データにトレースIDを追加することです。以下は、最もよく使われるデバイスライブラリの例です。

instance.getDataSources().getVolatileDataSources().put("tealium_trace_id", TRACE_ID");

tealium.addVolatileDataSources(["tealium_trace_id" : "TRACE_ID"])

NSDictionary *tealiumTrace = @{@"tealium_trace_id":@"TRACE_ID"};
[[Tealium instanceForKey:TEALIUM_INSTANCE_ID] addVolatileDataSources: tealiumTrace];

tealium?.volatileData()?.add(data: ["tealium_trace_id": "TRACE_ID"])

ネイティブコードを使用したトレースの終了

トレースを手動で終了し、次のキーと値のペアを含んだトラックコールをアプリ内の任意の場所にあるオプションデータに追加して、「訪問終了」エンリッチメントをシミュレートします。

"event":"kill_visitor_session", "cp.trace_id":"TRACE_ID"

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"])

Tealium iQでのトレースIDの追加

この方法では、iQ構成にTealium Collectタグが必要です。まず、EventStreamのLive Eventsを使用して、デバイスのUniversally Unique Identifier（UUID）を決定してから、iQの「データ値を設定」拡張機能でその値を使用して、テストデバイスからのトラッキング用トレースIDを設定します。この方法は、ネイティブコードを編集する必要がないという点で、開発の後期段階で行うと効果的です。

トレースを開始するには、EventStreamにログインして[Live Events]に移動します。

デバイスでアプリケーションを開いて、トラッキングアクティビティをトリガーします。その後で[Live Events]画面に戻り、グラフのアクティビティを観察します。いずれかのイベントをクリックして詳細を開きます。

app_uuidパラメータ（または、お使いのTealium SDKのバージョンに応じてuuid）を見つけて、値をコピーします。このイベントがテスト対象デバイスからの者であることを確認します。トレースIDの生成と新規トレースの開始については、こちらの手順に従ってください。

新しいトレースIDが作成されたら、新しいブラウザタブを開いて、モバイルアプリのTealium iQプロファイルに移動します。[Data Layer]タブで、[Add a New Variable]をクリックしてソースをtrace_idに設定し、タイプを「First Party Cookie」に設定します。

[Extensions]画面から、データ値を設定拡張機能を次の設定とともに追加します。

• Scope：Tealium Collect
• Set：trace_id (cp) To：（テキスト）TRACE_ID
• Condition：app_uuid equals UUID

保存してテスト対象の環境に公開します。アプリを開いて、目的のスクリーンとイベントに移動してから、[Trace]タブに戻ってトレースの動作を確認します。

アナリティクスツール

テスト用のGoogle Analyticsアカウントをセットアップして、プロパティID（UA-12345678-1など）を書き留めます。

Tealium IQを介してGoogle Analyticsタグを追加し、新しいプロパティIDを該当する構成フィールドに入力します。

スクリーンビューをGAタグで有効にし、データ変数のうちの1つをscreenNameに設定します。

（オプション）任意の2つの変数をEvent ActionとEvent Categoryにそれぞれマッピングして、カスタムイベントをGAで設定します。アプリが正しく機能している場合は、スクリーンビューとカスタムイベントがGoogle Analyticsのアカウントに表示されます。カスタムイベントは、これらの変数にテスト目的で渡すデータに関係なく、Event CategoryとEvent Actionが設定されている限り自動的に生成されます。

デバイスログ

標準のデバイスログ

コンソールを「tealium」でフィルター処理すると、これらのログがより明確に表示される可能性があります。

Tealiumデバッグログ

mobile.htmlのデバッグ

このセクションでは、公開されたファイルmobile.htmlを使用してTealium iQ Tag Managementのモバイル実装をトラブルシューティングする方法を示します。

Tealium iQでモバイルプロファイルをアクティベートすると、mobile.htmlという名前のファイルがCDNの次のパスに公開されます。

http://tags.tiqcdn.com/utag/{アカウント}/{プロファイル}/{環境}/mobile.html

このファイルは、モバイル公開設定の受信とTag Managementモジュールの円滑化のためにネイティブモバイルライブラリによって使用されます。このファイルは、モバイル実装の基本的なトラブルシューティングを実行する上で役立ちます。

mobile.htmlの検査 

mobile.htmlページでのutag.jsの動作は、標準のデスクトップウェブサイトページの動作と似ています。utag.jsファイルが読み込まれ、後続のベンダータグが実行されます。

mobile.htmlページを検査するには：

1. 新しいブラウザウィンドウでiQプロファイルのmobile.html URLを読み込みます。
2. ブラウザのデベロッパーツールまたはウェブコンソールを開いて、ページのソースを検査します。

ここからは、Tealiumのutag.jsがインストールされたウェブサイトで使用されているのと同じトラブルシューティング手法の多くを実行できます。

公開タイムスタンプの検証

最初に確認すべきことは、最近公開された変更がmobile.htmlに読み込まれていることです。これを行うには、HTMLソースからのタイムスタンプをiQバージョン画面からのタイムスタンプと照合します。

公開タイムスタンプを検証するには：

1. mobile.htmlのページソースの最上部で、最初の行の公開タイムスタンプを見つけます。mobile.htmlのタイムスタンプのパターンは「ut.4.0.YYYYMMDDHHMM」です。（時刻は常にGMTで表されます）
2. iQプロファイルで、バージョン画面に移動して、同じ環境の最後に公開されたバージョンを見つけます。この公開タイムスタンプはmobile.htmlに表示されているタイムスタンプと一致します。

モバイル公開設定JavaScriptオブジェクトの検証

mobile.htmlページでは、モバイル公開設定の値を格納するためにmpsという名前のJavaScriptオブジェクトが使用されます。設定を検証するには、このオブジェクトを検査します。

mpsオブジェクトを検査するには：

1. ウェブコンソールに「mps」と入力して、Enterキーを押します。
2. 「4」と「5」のマークが付いたプロパティは、モバイルライブラリのバージョン4.xと5.xにそれぞれ対応します。

トラッキングコールのシミュレーション

このページでのutag.jsの動作は、標準のデスクトップウェブサイトページの動作と似ています。ネットワークアクティビティを監視して、どのutag.\*.jsファイルが読み込まれているかを確認し、ブラウザコンソールからトラッキングコールをトリガーして、タグが期待どおりに機能していることを確認します。

mobile.htmlでトラッキングコールをシミュレートするには：

1. ブラウザコンソールから「utag.view({screen_title : "Test Page"})」と入力して、Enterキーを押します。
2. ネットワークアクティビティ画面に移動して、発信ベンダートラッキングアクティビティを検査します。

リモートデバッグ

上級ユーザーは、ChromeまたはSafariのリモートウェブインスペクタを使用して非表示のWebViewをデバッグできます