メッセージアクティビティログ
メッセージアクティビティログでは、キャンペーンや送信に関連するあらゆるメッセージ（特にエラーメッセージ）を確認できます。
API キャンペーンのトランザクションの確認、失敗したメッセージの詳細のトラブルシューティング、通知配信の改善方法や既存の技術的問題の解決に関するインサイトの収集が可能です。
ログにアクセスするには、設定 > メッセージアクティビティログに移動します。
この記事に加えて、品質保証とデバッグツールのBrazeラーニングコースもご確認ください。メッセージアクティビティログを使用して独自のトラブルシューティングやデバッグを行う方法を解説しています。
メッセージアクティビティログに記録される以下のコンテンツでフィルタリングできます。
- プッシュ通知エラー
- 中止されたテンプレートアプリ内メッセージエラー
- Webhookエラー
- メールエラー
- APIメッセージレコード
- コネクテッドコンテンツエラー
- REST API接続オーディエンスエラー
- ユーザーエイリアスエラー
- ABテストエラー
- SMS/MMSエラー
- WhatsAppエラー
- ライブアクティビティエラー
- 不正なユーザートリガーエラー
- Braze Agentsの1日あたりの呼び出し制限エラー
- Braze Agentsの利用不可モデルエラー
これらのメッセージは、Brazeのシステム、お客様のアプリやプラットフォーム、またはサードパーティパートナーから送信される場合があります。そのため、このログに表示されるメッセージの数は無限に存在する可能性があります。
ログメッセージの理解
メッセージの意味を判断するには、各メッセージの文言と対応する列に注目してください。コンテキストの手がかりを使ってトラブルシューティングに役立てることができます。
たとえば、メッセージに「empty-cart_app」と表示されるログエントリがあり、その意味がわからない場合は、左側のタイプ列を確認してください。「Aborted Message Error」と表示されている場合、そのメッセージはLiquidを使用した中止メッセージとして記述されたものであり、メッセージの意図された受信者のアプリ内カートが空であったためにメッセージが中止されたと判断できます。
一般的なメッセージ
一般的なメッセージタイプがいくつかあり、問題の診断と修正に役立つトラブルシューティングリンクが提供される場合もあります。
以下に記載されているメッセージは例示目的であり、ログのメッセージ列に表示される内容と完全に一致しない場合があります。
| メッセージタイプ | 想定されるメッセージ | 説明 |
|---|---|---|
| ソフトバウンス | メールアドレス [email protected] がソフトバウンスしました。 | メールアドレスは有効で、メールメッセージは受信者のメールサーバーに到達しましたが、「一時的な」問題により拒否されました。 一般的なソフトバウンスの理由には以下があります。
|
| ハードバウンス | 送信先のメールアカウントが存在しません。受信者のメールアドレスにタイプミスや不要なスペースがないか再確認してください。 | メッセージはこの人の受信トレイに届きませんでした。到達すべき受信トレイが存在しなかったためです。さらに詳しく調べたい場合、このようなメッセージには詳細を表示列にリンクが表示され、意図された受信者のプロファイルを確認できることがあります。 |
| ブロック | スパムメッセージがアンチスパムポリシーにより拒否されました。 | メッセージがスパムとして分類されました。このメールエラーは、メールサービスプロバイダー (ESP) からメールがドロップされたことを示すイベントを受信した場合にユーザーに対して記録されます。その意図された受信者だけの問題かもしれませんが、このメッセージが頻繁に表示される場合は、送信習慣やメッセージの内容を再評価することをお勧めします。また、IPウォームアップは行いましたか？まだの場合は、Brazeに連絡してアドバイスを受けてください。 |
| 中止されたメッセージエラー | empty-cart_web | カート機能を持つアプリがある場合や、Liquidで中止メッセージを含む送信を作成した場合、送信が中止された際に返されるメッセージをカスタマイズできます。この場合、返されるメッセージは empty-cart_web です。 |
メッセージがここに記載されていない理由
メッセージアクティビティログのメッセージは、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件保存されます。
- コネクテッドコンテンツエラー
- 中止メッセージエラー
- Webhookエラー
- SMS拒否エラー
- SMS配信失敗エラー
- WhatsApp失敗エラー
- ABテストエラー
- 以下のエラータイプについて、同じキャンペーンまたはキャンバスステップとアプリの組み合わせに対して、同じエラータイプのプッシュ通知エラーログが最大20件保存されます。
- 無効なプッシュ認証情報
- 無効なプッシュトークン
- プッシュ認証情報なし
- トークンエラー
- クォータ超過
- リトライタイムアウト
- 無効なペイロード
- 予期しないエラー
- 以下のエラータイプについて、同じアプリに対して、1時間の固定時間枠内で同じエラータイプのエラーログが最大100件保存されます。
- ライブアクティビティエラー（プッシュ認証情報なし）
- ライブアクティビティエラー（無効なプッシュ認証情報）
- その他のライブアクティビティエラー
- APNsフィードバック削除トークンエラー
- 以下のエラータイプについて、同じキャンペーンまたはキャンバスステップに対して、1時間の固定時間枠内で同じエラータイプのエラーログが最大100件保存されます。
- メールソフトバウンスエラー
- メールハードバウンスエラー
- メールブロックエラー
- 同じワークスペースに対して、1時間の固定時間枠内でユーザーエイリアスエラーログが最大100件保存されます。
テスト送信
メッセージアクティビティログには、以下のメッセージングチャネルのテストログが表示されます。
- SMS
- LINE
- KakaoTalk
- Webhook
テスト送信ログは、メール、Content Cards、アプリ内メッセージ、プッシュの各チャネルでは利用できません。
テスト送信ログには「[TEST SEND]」というプレフィックスが付きますが、すべてのテスト送信ログにプレフィックスが付くことは保証されていません（たとえば、コネクテッドコンテンツエラーにはプレフィックスが付きません）。