イベントユーザーログ
イベントユーザーログは、Braze統合の問題を分析、デバッグ、またはトラブルシューティングするのに役立ちます。このタブには、エラーの種類、関連するアプリ、発生時刻、および多くの場合、関連する生データを表示する機会を含むエラーログが表示されます。
この記事に加えて、品質保証とデバッグツール Braze Learningコースもご確認ください。このコースでは、イベントユーザーログを使用して独自のトラブルシューティングとデバッグを行う方法について説明しています。
ログにアクセスするには、設定 > セットアップとテスト > イベントユーザーログに移動します。
ログを簡単に見つけるために、以下の条件でフィルタリングできます。
- 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を使用して以下のようなデータを監視できます：
- ユーザーのセッション数
- ユーザーが最後にセッションを開始した時刻
- キャンペーンを受け取った後にユーザーがセッションを開始したかどうか
- ユーザーのセッション持続時間の中央値
これらの動作は、セッション終了イベントが次のセッション時にフラッシュされることによる影響を受けません。