イベントユーザーログ
イベントユーザーログは、Braze統合の問題を分析、デバッグ、またはトラブルシューティングするのに役立ちます。このタブには、エラーの種類、関連するアプリ、発生時刻、および多くの場合、関連する生データを表示する機会を含むエラーログが表示されます。
この記事に加えて、品質保証とデバッグツールのBrazeラーニングコースもご確認ください。このコースでは、イベントユーザーログを使用して独自のトラブルシューティングとデバッグを行う方法について説明しています。
ログにアクセスするには、設定 > イベントユーザーログに移動します。
ログを簡単に見つけるために、以下の条件でフィルタリングできます。
- SDKまたはAPI
- アプリ名
- 期間
- ユーザー
各ログは複数のセクションに分かれており、以下が含まれる場合があります。
- デバイス属性
- ユーザー属性
- イベント
- キャンペーンイベント
- 応答データ
データを展開アイコンを選択すると、その特定のログの生のJSONデータが表示されます。
イベントユーザーログは、記録されてから30日間ダッシュボードに保持されます。
トラブルシューティング
テストユーザーのSDKログが表示されない
ユーザーを内部グループに追加したにもかかわらず、イベントユーザーログにSDKログが表示されない場合、設定オプションが不足している可能性があります。SDKログをキャプチャするには、その内部グループの内部グループ設定でグループメンバーのユーザーイベントを記録を選択してください。
ログ更新の遅延
これはAPIの通常の遅延である可能性があります。
SDKメソッドを呼び出すと、通常SDKはそれらのイベントをローカルにキャッシュし、10秒ごとにサーバーにフラッシュします。その時点での全体的な負荷に応じて、ジョブ処理キューがイベントを取り込むまでに数秒から数分かかる場合があります。
イベントをできるだけ早く到着させたい場合は、requestImmediateDataFlush() 関数を呼び出してみてください。
アプリ内メッセージのインプレッション失敗
アプリ内メッセージの表示に失敗した場合、イベントユーザーログで関連するSDKリクエストの生のJSONデータを展開し、応答内の error_code フィールドを確認することで原因を見つけることができます。error_code はインプレッションが失敗した具体的な理由（例えば、無効な色の値やレンダリングの問題）を示します。さらなる調査が必要な場合は、このエラーコードをBrazeサポートに共有してください。
セッション終了とセッション開始のタイムスタンプが近い（iOS）
イベントユーザーログには、Brazeがセッション終了の通知を受けたタイムスタンプが表示されます。これは次のセッション開始のミリ秒前になります。iOSはアプリがバックグラウンドにあるときにスレッドの実行を積極的に停止するため、アプリが再度開かれるまでBrazeにデータをフラッシュできません。そのため、Brazeはアプリが再度開かれるまでセッションが終了したことを認識できません。
セッション終了時刻はセッション開始の数秒前として記録されますが、イベントがフラッシュされる際にセッション時間は別途フラッシュされ、アプリが開いていた時間を正確に反映します。そのため、この動作は Median Session Duration フィルターに影響しません。
ユーザーセッションに関連して、Brazeを使用して以下のようなデータを監視できます。
- ユーザーのセッション数
- ユーザーが最後にセッションを開始した時刻
- キャンペーンを受信した後にユーザーがセッションを開始したかどうか
- ユーザーのセッション時間の中央値
これらの動作は、セッション終了イベントが次のセッションでフラッシュされることによる影響を受けません。