イベントユーザーログ

イベントユーザーログは、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を使用して以下のようなデータを監視できます。

• ユーザーのセッション数
• ユーザーが最後にセッションを開始した時刻
• キャンペーンを受信した後にユーザーがセッションを開始したかどうか
• ユーザーのセッション時間の中央値

これらの動作は、セッション終了イベントが次のセッションでフラッシュされることによる影響を受けません。