メッセージアクティビティログ

メッセージアクティビティログでは、キャンペーンや送信に関連するあらゆるメッセージ（特にエラーメッセージ）を確認できます。

APIキャンペーンのトランザクションの確認、失敗したメッセージの詳細のトラブルシューティング、通知配信の改善方法や既存の技術的問題の解決に関するインサイトの収集が可能です。

ログにアクセスするには、設定 > セットアップとテスト > メッセージアクティビティログに移動します。

ヒント

この記事に加えて、品質保証とデバッグツール Braze Learningコースもご確認ください。メッセージアクティビティログを使用して独自のトラブルシューティングやデバッグを行う方法を解説しています。

メッセージアクティビティログに記録される以下のコンテンツでフィルタリングできます。

• プッシュ通知エラー
• 中止されたテンプレートアプリ内メッセージエラー
• Webhookエラー
• メールエラー
• APIメッセージレコード
• コネクテッドコンテンツエラー
• REST API接続オーディエンスエラー
• ユーザーエイリアスエラー
• ABテストエラー
• SMS/MMSエラー
• WhatsAppエラー
• ライブアクティビティエラー
• 不正なユーザートリガーエラー
• Brazeエージェントの1日あたりの呼び出し制限エラー
• Brazeエージェントの利用不可モデルエラー

これらのメッセージは、Brazeのシステム、お客様のアプリやプラットフォーム、またはサードパーティパートナーから送信される場合があります。そのため、このログに表示されるメッセージの数は無限に存在する可能性があります。

ログメッセージの理解

メッセージの意味を判断するには、各メッセージの表現と、それに対応するカラムに注目してください。コンテキストの手がかりを使ってトラブルシューティングするのに役立ちます。

たとえば、Aborted Message Error のエントリは、Liquid のメッセージ中止だけでなく、多くの理由で発生する可能性があります。具体的な理由については、Message カラムをお読みください。

• 送信が Liquid の abort_message タグによって中止された場合、Message カラムには呼び出された正確な Liquid スニペットが表示されます。たとえば {% abort_message('Module count is less than or equal to 1') %} called のように表示されます。
• その他の中止理由の場合、Message カラムに送信が中止された理由が説明されます。

API キャンペーンのペイロード

メッセージアクティビティログは、API キャンペーンの種類に応じて異なる情報を記録します。/messages/send エンドポイントは API メッセージレコードにメッセージ本文（messages）を記録しますが、/campaigns/trigger/send エンドポイントはリクエストペイロードや api_trigger_properties をメッセージアクティビティログに記録しません。

一般的なメッセージ

よく見かけるメッセージタイプがいくつかあり、問題の診断と修正に役立つトラブルシューティングリンクが提供される場合もあります。

以下に記載されているメッセージは例示目的であり、ログの Message カラムに表示される内容と完全に一致しない場合があります。

なぜここにメッセージが記載されていないのですか？

メッセージアクティビティログに表示されるメッセージは、Braze、お使いのアプリやプラットフォーム、またはサードパーティパートナーなど、さまざまなソースから発信されます。つまり、このログに表示される可能性のあるメッセージの数は無限であり、すべてをリストすることはできません。

たとえば、前述の表に記載されているものに加えて、「ブロック」メッセージとして表示される可能性のあるものには以下があります。

• Unfortunately, messages from [IP_ADDRESS] weren’t sent. Please contact your Internet Service provider since part of their network is on our block list.
• Message rejected due to local policy.
• The message was blocked by the receiver as spam.
• Service unavailable, Client host [IP_ADDRESS] blocked using Spamhaus.

ストレージ保持期間

過去60時間のエラーがメッセージアクティビティログで確認できます。60時間以上経過したログはクリーンアップされ、アクセスできなくなります。

保存されるエラーログの件数

保存されるログの件数は、いくつかの条件によって変わります。たとえば、スケジュールされたキャンペーンが数千人のユーザーに送信された場合、メッセージアクティビティログにはすべてのエラーではなく、エラーのサンプルが表示される可能性があります。以下は、保存されるログ件数に影響する条件の概要です。

• 以下のエラータイプについて、同一キャンペーンまたはキャンバスステップごとに、1時間の固定時間枠内で同じエラータイプのエラーログが最大20件保存されます。
  • Connected Content エラー
  • メッセージ中止エラー
  • Webhook エラー
  • SMS 拒否エラー
  • SMS 配信失敗エラー
  • WhatsApp 失敗エラー
  • ABテストエラー
• 以下のエラータイプについて、同一キャンペーンまたはキャンバスステップとアプリの組み合わせごとに、同じエラータイプのプッシュ通知エラーログが最大20件保存されます。
  • 無効なプッシュ認証情報
  • 無効なプッシュトークン
  • プッシュ認証情報なし
  • トークンエラー
  • クォータ超過
  • リトライタイムアウト
  • 無効なペイロード
  • 予期しないエラー
• 以下のエラータイプについて、同一アプリごとに、1時間の固定時間枠内で同じエラータイプのエラーログが最大100件保存されます。
  • ライブアクティビティエラー（プッシュ認証情報なし）
  • ライブアクティビティエラー（無効なプッシュ認証情報）
  • その他のライブアクティビティエラー
  • APNS フィードバックによるトークン削除エラー
• 以下のエラータイプについて、同一キャンペーンまたはキャンバスステップごとに、1時間の固定時間枠内で同じエラータイプのエラーログが最大100件保存されます。
  • メールソフトバウンスエラー
  • メールハードバウンスエラー
  • メールブロックエラー
• 同一ワークスペースごとに、1時間の固定時間枠内でユーザーエイリアスエラーログが最大100件保存されます。

テスト送信

メッセージアクティビティログには、以下のメッセージングチャネルのテストログが表示されます。

• SMS
• WhatsApp
• LINE
• KakaoTalk
• Webhook

テスト送信ログは、メール、Content Cards、アプリ内メッセージ、プッシュの各チャネルでは利用できません。

テスト送信ログには「[TEST SEND]」というプレフィックスが付きますが、すべてのテスト送信ログにプレフィックスが付くとは限りません（例えば、コネクテッドコンテンツのエラーにはプレフィックスが付きません）。