トラブルシューティング

基本

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

デバッグ中に変更を公開すると、Tealiumのキャッシュに5分の有効期限があることに注意してください。この期間中、utag.jsファイルは公開後にTealiumのサーバーで更新されます。

アプリを冷たいスタート（アプリが以前にアプリトレイからスワイプされた状態）から起動するたびに、Tealium SDKは新しいファイルをチェックし、デフォルトでは15分ごとにチェックします（モバイルパブリッシュ構成で制御されます）。ただし、公開してから5分未満の場合、アプリを再起動しても常に機能しない場合があります。テスト中に「dev」と「qa」の環境を切り替えると、キャッシュが5分以内に使用されない場合に環境のキャッシュが期限切れになり、新しいファイルがすぐに利用可能になります。

Tealium EventStream ライブイベント

Tealium EventStreamの「ライブイベント」機能は、モバイルインストールのデバッグのためにすべてのTealiumの顧客に利用できます。

本番環境でこれを有効にすると、使用量に応じて料金が発生する場合があります。アプリが公開される前にこの機能を無効にしてください。

イベント収集機能を有効にするための次の方法のいずれかを使用します。

オプション1 - Tealium Collect タグ

タグマーケットプレースからTealium Collectタグを追加します。タグの詳細構成で、QA環境とProd環境をオフにして、タグを本番環境に公開して使用料金が発生しないようにします。リクエストはエンコードされたJSONデータとしてアプリから送信されるため、Charles Proxyとの併用はやや困難ですが、ウェブビューからのすべてのデータ（クッキーデータや拡張機能によって変更された変数など）を表示できる利点があります。タグの構成で特定のプロファイルを入力しない場合、データはアプリがターゲットにしている同じプロファイルに送信されます。特定のプロファイルにデータを送信する場合は、Tealium collect tag setup guideを参照してください。

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

Tealium iQアカウントで「モバイルパブリッシュ構成」に移動し、「Tealium Collect」を有効にします。この方法の利点は、データがGETリクエストとして送信され、各データ変数が簡単に読み取り可能なクエリパラメータの形式でクエリ文字列に追加されることです。この方法は、データを検査するためにCharles Proxyを使用する場合に最適です。予期しない使用料金を避けるために、アプリを本番環境にプッシュする前にこの構成をオフにしてください。このリクエストで表示されるのは、アプリ開発者によってTealiumに渡された正確なデータのみであり、クッキーデータやウェブビューで生成されたデータは含まれません。

この機能を使用して送信されるデータは、アカウントの「main」プロファイルに送信され、現在選択されているプロファイルには送信されません。これを調整するには、アプリ内の次のコードスニペットを使用してディスパッチ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にログインし、ライブイベントに移動して受信イベントを確認します。

ライブイベントの詳細について詳しく学びます。

Charles Proxy

Charlesウェブデバッグプロキシは、Tealium iQタグ管理を介して構成したデバイスとサードパーティサービス間のすべてのHTTPおよびSSL/HTTPSトラフィックを検査します。

AndroidまたはiOSデバイスでCharlesをプロキシとして構成します。

Tealium環境の切り替え

アプリがデフォルトの環境（例：「prod」）から別の環境に切り替える必要がある場合は、Charles Proxy（またはFiddlerなどの他のプロキシツール）でカスタムマッピングを追加し、アプリに提供されるファイルを透過的に切り替えます。たとえば、アプリは「prod」のutag.js (https://tags.tiqcdn.com/utag/tealiummobile/demo/prod/utag.js)を要求しますが、Charlesプロキシは「dev」のutag.js (https://tags.tiqcdn.com/utag/tealiummobile/demo/dev/utag.js)を返します。

次の構成手順で別のTealium環境に切り替えます。

1. Charles Proxyを開き、「Tools > Map Remote」に移動します。Map Remote Settings画面で、「Enable Map Remote」をチェックし、「Add」をクリックします。
2. Hostボックスに、アカウントとプロファイルをURLに挿入して、https://tags.tiqcdn.com/utag/<account>/<profile>/prod/*とします。貼り付けた後、Map FromセクションのPortまたはPathフィールドにカーソルを移動してクリックすると、CharlesがURLを自動的にコンポーネントに分割します。
3. Map Toセクションでも同じプロセスを実行し、この時はURL内の環境を「prod」から「dev」（または「qa」）に変更します。URLの末尾のアスタリスク文字を削除します。たとえば：https://tags.tiqcdn.com/utag/<account>/<profile>/dev/
4. セットアップを完了するために、「OK」をクリックします。

これにより、Charles Proxyはすべての「prod」環境からのリクエストを「dev」環境に切り替えます。アプリのデフォルト環境に戻るには、Map Remoteルールを無効にするか削除するか、デバイスでプロキシをオフにします。

この構成が有効になるには、アプリを終了して再起動する必要があります。

トラフィック検査

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

トレース

トラブルシューティングには、トレースの使用方法について学びます。

アナリティクスツール

自分自身のためにテスト用のGoogle Analyticsアカウントを構成し、プロパティID（例：UA-12345678-1）をメモしてください。

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

GAタグでスクリーンビューを有効にし、1つのデータ変数をscreenNameにマッピングします。

（オプション）GAでカスタムイベントを構成するには、2つの変数をイベントアクションとイベントカテゴリにそれぞれマッピングします。アプリが正常に機能している場合、スクリーンビューとカスタムイベントがGoogle Analyticsアカウントに表示されます。テスト目的でこれらの変数にどのようなデータを渡しても、カスタムイベントは自動的に生成されます。

デバイスログ

標準デバイスログ

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

Tealiumデバッグログ

mobile.htmlのデバッグ

このセクションでは、Tealium iQタグ管理のモバイル実装をトラブルシューティングする方法について説明します。公開されたファイルmobile.htmlを使用して、Tealium iQプロファイルのモバイルアプリケーションの実装に基づいています。

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

http://tags.tiqcdn.com/utag/{ACCOUNT}/{PROFILE}/{ENVIRONMENT}/mobile.html

このファイルは、ネイティブモバイルライブラリがモバイルパブリッシュ構成を受け取り、タグ管理モジュールを実現するために使用されます。このファイルは、モバイル実装の基本的なトラブルシューティングを実行するために役立ちます。

mobile.htmlの検査

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

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

1. 新しいブラウザウィンドウでiQプロファイルのmobile.htmlURLを読み込みます。
2. ブラウザの開発者ツールまたはWebコンソールを開き、ページソースを検査します。

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

公開タイムスタンプの確認

最初に確認することは、最新に公開された変更がmobile.htmlにロードされているかどうかです。これは、HTMLソースのタイムスタンプをiQのバージョン画面のタイムスタンプと一致させることで行われます。

公開タイムスタンプを確認するには：

1. mobile.htmlのページソースの先頭にある公開タイムスタンプを探します。mobile.htmlのタイムスタンプは次のパターンを持ちます：ut.4.0.YYYYMMDDHHMM（時間は常にGMTです）。
2. iQプロファイルで、バージョン画面に移動し、同じ環境の最新に公開されたバージョンを見つけます。この公開のタイムスタンプは、mobile.html内に見つかるタイムスタンプと一致します。

モバイルパブリッシュ構成JavaScriptオブジェクトの検査

mobile.htmlページでは、JavaScriptオブジェクトであるmpsを使用してモバイルパブリッシュ構成の値を格納します。このオブジェクトを検査して構成を確認します。

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

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

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

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

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

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

リモートデバッグ

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