イベントユーザーログ

イベントユーザーログは、Braze 連携における問題の特定、デバッグ、その他のトラブルシューティングに役立ちます。このタブには、エラーの種類、エラーが関連するアプリ、エラーの発生時期を詳細に示すエラーのログが表示され、多くの場合にはエラーに関連する生データを表示することもできます。

ログにアクセスするには、[設定] > [イベントユーザーログ] に移動します。

ログを簡単に見つけるために、以下の基準でフィルターを適用できます。

• SDK または API
• アプリ名
• 期間
• ユーザー

各ログは複数のセクションに分かれており、次の項目が含まれることがあります。

• デバイス属性
• ユーザー属性
• イベント
• キャンペーンイベント
• 応答データ

[データを展開する] アイコンを選択すると、その特定のログの生の JSON データが表示されます。

イベントユーザーログは、記録後 30 日間ダッシュボードに残ります。

トラブルシューティング

テストユーザーの SDK ログの欠落

ユーザーを内部グループに追加したにもかかわらず、イベントユーザーログに SDK ログが表示されない場合、設定オプションが不足していることが原因の可能性があります。SDK ログを収集するには、その内部グループの [内部グループ設定] で [グループメンバーのユーザーイベントを記録] を必ず選択してください。

ログ更新の遅延

これは弊社の API の通常の遅延に起因する可能性があります。

SDK メソッドを呼び出す際、通常 SDK はイベントをローカルにキャッシュし、10 秒ごとにサーバーにフラッシュします。その時点の全体的な負荷に応じて、ジョブ処理キューがイベントを取り込むまでに 1 秒から数分かかることがあります。

イベントをできるだけ早く受信したい場合は、requestImmediateDataFlush() 関数を呼び出してみてください。

アプリ内メッセージのインプレッション失敗

アプリ内メッセージの表示に失敗した場合、イベントユーザーログで該当する SDK リクエストの生の JSON データを展開し、応答内の error_code フィールドを確認することで原因を特定できます。error_code は、インプレッションが失敗した具体的な理由（無効なカラー値やレンダリングの問題など）を示します。さらに調査が必要な場合は、このエラーコードを Braze サポートに共有してください。

セッション終了とセッション開始のタイムスタンプが酷似している (iOS)

イベントユーザーログには、Braze にセッション終了が通知されたときのタイムスタンプが表示されます。これは、次のセッションが開始される数ミリ秒前になります。iOS はアプリがバックグラウンドにあるときにスレッドの実行を積極的に停止するため、Braze はアプリが再度開かれるまでセッションが終了したことを認識できません。そのため、アプリが再度開かれるまでデータを Braze にフラッシュすることはできません。

セッション終了時刻はセッション開始の数秒前として記録されますが、イベントがフラッシュされる際にセッション時間は個別にフラッシュされ、アプリが開いていた時間を正確に反映します。したがって、この動作は Median Session Duration フィルターに影響しません。

ユーザーセッションに関連して、Braze を使用して次のようなデータを監視できます。

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

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