このトピックでは、モバイル分析サービス (Mobile Analysis Service) で発生する代表的な課題とそのトラブルシューティング方法について説明します。
クライアントの正しく統合されているかを確認する
クライアントが正しく統合されているかを確認するには、ローカルログ（Android／iOS）を参照するか、または コンソールでのログクエリ を実行してください。
クライアントの正しく統合された後もコンソールにデータが表示されない
クライアントログは、ローカルログ数が特定のしきい値に達した場合や、アプリケーションが一定期間バックグラウンドで実行された場合など、特定の条件を満たしたときにのみ、自動的にログサーバーにアップロードされます。テスト中にデータを早期に確認したい場合は、クライアントから手動でログをアップロードすることで、即時アップロードを強制できます。
詳細については、「Android ログの手動アップロード」または「iOS ログの手動アップロード」をご参照ください。
コンソールでイベントを作成した後も、イベントの PV／UV データが表示されない
イベントの PV／UV データを表示するには、以下の点を確認してください。
クライアントが正しく統合されていること。詳細については、「クライアントの正しく統合されているかを確認する」をご参照ください。
ログがログサーバーにアップロード済みであること。詳細については、「クライアントの正しく統合された後もコンソールにデータが表示されない」をご参照ください。
イベントはコンソールで作成され、その後ユーザーによってトリガーされました。
コンソールでイベントを作成した後も、イベントの UV が常に 0 のままになる
クライアント側でユーザー ID が設定されていることを確認してください。ユーザー ID の設定方法については、「ユーザー ID」をご参照ください。
カスタムダッシュボードにデータが表示されない
以下の手順でトラブルシューティングを行ってください。
ログアップロードスイッチが有効になっているかを確認します。[コンソールにログイン] し、左側のナビゲーションウィンドウから モバイル分析サービス > ログ管理 > アップロードスイッチの構成 > イベントトラッキング構成 を選択して、ログスイッチ一覧ページに移動します。対応するタグのアップロードスイッチが有効になっているかを確認し、ログアップロードスイッチが有効であることを保証してください。詳細については、「ログアップロードスイッチの構成」をご参照ください。
ダッシュボード用のログがサーバーにアップロードされているかを確認します。コンソールの [ログ管理] > [ログ再生] 機能を使用して、履歴ログをクエリします。
ログが見つかった場合、それは既にアップロード済みです。詳細については、「履歴ログのクエリ」をご参照ください。
ログが見つからない場合、アプリケーションがログをトリガーしているかを確認します。以下の手順を実行してください。
ログをトリガーする前に、スマートフォンのネットワーク接続を切断し、その後ログをトリガーします。
アプリケーションをバックグラウンドに移動した後、クエリ対象のログがローカルログディレクトリに存在するかを確認します。
iOS クライアント：ログはサンドボックスディレクトリ
Library > atrack > logsに保存されます。Android クライアント：ログは
/data/data/[PackageName]/files/mdapまたは/sdcard/Android/data/[PackageName]/files/mdapに保存されます。ログ保存パスは、assets/channel.config内のrelease_typeフィールドの値によって異なります。詳細については、「ローカルログの表示」をご参照ください。
クライアントがログを生成した後、再度ログ再生を実行して、ログがサーバーにアップロードされたかを確認します。
クライアントがログを生成した後、ローカルにキャッシュされたログ数がしきい値に達した場合にのみ、自動ログアップロードがトリガーされます。しきい値はログの種別によって異なる場合があります。デバッグを容易にするため、mPaaS コンソールの モバイル分析サービス > ログ管理 > アップロードスイッチの構成 > イベントトラッキング構成 ページにアクセスし、[アップロード数量]（現在のログ種別においてローカルファイル内のログ数がログレポートをトリガーするしきい値）を一時的に 1 に変更してログレポートを強制的にトリガーできます。デバッグ完了後は、元の値に戻してください。ログアップロードのトリガーに関する詳細については、ログアップロードのドキュメント（「Android ログアップロード」／「iOS ログアップロード」）をご参照ください。
ログ再生の結果、ログが依然としてサーバーにアップロードされていない場合は、ログの種別に応じて、「Android イベントトラッキング」または「iOS イベントトラッキング」のドキュメントを参照し、イベントトラッキングの構成プロセスにエラーがないかを確認してください。ドキュメントに従ってイベントトラッキングを正しく統合した後、ステップ 2 を再度実行して、ログが正常にアップロードされることを確認してください。
ログがサーバーにアップロード済みであるにもかかわらずダッシュボードにデータが表示されない場合は、ログデータの形式が正しいかを確認してください。
[ログ再生] で表示される生ログを、イベントトラッキングログモデル と比較し、ログ形式が正しいかを確認してください。ログ形式が正しくない場合は、該当するイベントトラッキング種別のログモデルを参照して、ログ形式を修正してください。
上記の手順をすべて実施し、ログがサーバーにアップロード済みであり、データ形式も正しいことが確認できたにもかかわらず、ダッシュボードに依然としてデータが表示されない場合は、グループ番号 145930007362 を検索して DingTalk グループに参加し、サポートを受けてください。
モバイル分析サービスコンソールで iOS クライアントのクラッシュログがシンボリケーションされていない
iOS クライアントのクラッシュログをシンボリケーションするには、パッケージング時に生成される dSYM シンボルテーブルファイルが必要です。
iOS クラッシュ分析機能は、クラッシュログのシンボリケーションをサポートしています。この機能を利用するアプリケーションの場合、mPaaS コンソールの モバイル分析サービス > パフォーマンス分析 > iOS シンボルテーブル管理 ページから dSYM シンボルテーブルファイルをアップロードしてください。詳細については、「iOS シンボルテーブル管理」をご参照ください。