詳細ログの読み取り

このページでは、Braze SDKからの詳細ログ出力を解釈する方法について説明します。各メッセージングチャネルについて、確認すべき主要なログエントリ、その意味、および注意すべき一般的な問題を紹介します。

始める前に、詳細ログの有効化が完了していることと、お使いのプラットフォームでログを収集する方法を把握していることを確認してください。

セッション

セッションはBrazeの分析とメッセージ配信の基盤です。アプリ内メッセージやContent Cardsなど、多くのメッセージング機能は、有効なセッションが開始されてから動作します。セッションが正しく記録されていない場合は、まずこの問題を調査してください。セッショントラッキングの有効化について詳しくは、ステップ5：ユーザーセッショントラッキングを有効にするを参照してください。

主要なログエントリ

• swift
• android

1
Started user session (id: <SESSION_ID>)

1
2
3
4
5
Ended user session (id: <SESSION_ID>, duration: <DURATION>s)
Logged event:
- userId: <USER_ID>
- sessionId: <SESSION_ID>
- data: sessionEnd(duration: <DURATION>)

1
2
3
4
New session created with ID: <SESSION_ID>
Session start event for new session received
Completed the openSession call
Opened session with activity: <ACTIVITY_NAME>

1
2
3
Closed session with activity: <ACTIVITY_NAME>
Closed session with session ID: <SESSION_ID>
Requesting data flush on internal session close flush timer.

確認すべきポイント

• アプリ起動時にセッション開始ログが表示されることを確認します。
• セッション開始が表示されない場合は、SDKが正しく初期化されていること、および openSession（Android）が呼び出されていることを確認してください。
• Androidでは、Brazeエンドポイントへのネットワークリクエストが送信されていることを確認します。表示されない場合は、APIキーとエンドポイントの設定を確認してください。

プッシュ通知

プッシュ通知ログは、デバイストークンが登録されていること、通知が配信されていること、クリックイベントがトラッキングされていることを確認するのに役立ちます。

トークン登録

セッションが開始されると、SDKはデバイスのプッシュトークンをBrazeに登録します。

• swift
• android

1
2
3
4
Updated push notification authorization:
- authorization: authorized

Received remote notifications device token: <PUSH_TOKEN>

1
2
3
4
5
6
"attributes": [
  {
    "push_token": "<PUSH_TOKEN>",
    "user_id": "<USER_ID>"
  }
]

1
2
3
4
"device": {
  "ios_push_auth": "authorized",
  "remote_notification_enabled": 1
}

1
Registering for Firebase Cloud Messaging token using sender id: <SENDER_ID>

確認事項

• リクエストボディに push_token がない場合、トークンが取得されていません。アプリ設定でプッシュの設定を確認してください。
• ios_push_auth が denied または provisional と表示される場合、ユーザーがプッシュのフル権限を許可していません。
• Androidで SENDER_ID_MISMATCH が表示される場合は、FCMの送信者IDをFirebaseプロジェクトに合わせて更新してください。

プッシュの配信とクリック

プッシュ通知がタップされると、SDKは処理イベントとクリックイベントをログに記録します。

• swift
• android

1
2
3
4
5
6
7
8
9
10
11
12
13
Processing push notification:
- date: <TIMESTAMP>
- silent: false
- userInfo: {
  "ab": { ... },
  "ab_uri": "<DEEP_LINK_OR_URL>",
  "aps": {
    "alert": {
      "body": "<MESSAGE_BODY>",
      "title": "<MESSAGE_TITLE>"
    }
  }
}

1
2
3
4
Logged event:
- userId: <USER_ID>
- sessionId: <SESSION_ID>
- data: pushClick(campaignId: ...)

1
2
3
4
Opening '<URL>':
- channel: notification
- useWebView: false
- isUniversalLink: false

1
BrazeFirebaseMessagingService: Got Remote Message from FCM

確認事項

• プッシュペイロードに期待される title、body、およびディープリンク（ab_uri）が含まれていることを確認します。
• タップ後に pushClick イベントがログに記録されていることを確認します。
• クリックイベントが記録されていない場合は、アプリのデリゲートまたは通知ハンドラーがプッシュイベントをBraze SDKに正しく転送しているか確認してください。

アプリ内メッセージ

アプリ内メッセージのログには、サーバーからの配信、イベントに基づくトリガー、表示、インプレッションの記録、クリックトラッキングなど、完全なライフサイクルが表示されます。

メッセージ配信

ユーザーがセッションを開始し、アプリ内メッセージの対象となると、SDKはサーバーからメッセージペイロードを受信します。

• swift
• android

1
2
3
4
5
6
7
8
9
"templated_message": {
  "data": {
    "message": "...",
    "type": "HTML",
    "message_close": "SWIPE",
    "trigger_id": "<TRIGGER_ID>"
  },
  "type": "inapp"
}

1
Triggering action: <CAMPAIGN_BSON_ID>

メッセージの表示とインプレッション

• swift
• android

1
2
3
In-app message ready for display:
- triggerId: (campaignId: <CAMPAIGN_ID>, ...)
- extras: { ... }

1
2
3
4
Logged event:
- userId: <USER_ID>
- sessionId: <SESSION_ID>
- data: inAppMessageImpression(triggerIds: [...])

1
handleExistingInAppMessagesInStackWithDelegate:: Displaying in-app message

クリックとボタンイベント

ユーザーがボタンをタップするか、メッセージを閉じた場合：

• swift
• android

1
2
3
4
Logged event:
- userId: <USER_ID>
- sessionId: <SESSION_ID>
- data: inAppMessageButtonClick(triggerIds: [...], buttonId: "<BUTTON_ID>")

1
No matching trigger for event.

確認すべきポイント

• アプリ内メッセージが表示されない場合は、最初にセッション開始が記録されていることを確認してください。
• 設定済みのBrazeエンドポイントからのレスポンスをフィルターして、メッセージペイロードが配信されたことを確認してください。
• インプレッションが記録されない場合は、ログ記録を抑制するカスタム inAppMessageDisplay デリゲートを実装していないか確認してください。
• 「No matching trigger for event」が表示される場合、これは正常であり、そのイベントに対して追加のアプリ内メッセージが設定されていないことを示しています。

Content Cards

Content Cardsのログは、カードがデバイスに同期され、ユーザーに表示され、インタラクション（インプレッション、クリック、非表示操作）がトラッキングされていることを確認するのに役立ちます。

カード同期

Content Cardsはセッション開始時と手動更新が要求された時に同期されます。セッションが記録されていない場合、Content Cardsは表示されません。

• swift
• android

1
2
3
4
5
6
7
8
9
10
11
"cards": [
  {
    "id": "<CARD_ID>",
    "tt": "<CARD_TITLE>",
    "ds": "<CARD_DESCRIPTION>",
    "tp": "short_news",
    "v": 0,
    "cl": 0,
    "p": 1
  }
]

1
Requesting content cards sync.

インプレッション、クリック、非表示

• swift
• android

1
2
3
4
Logged event:
- userId: <USER_ID>
- sessionId: <SESSION_ID>
- data: contentCardImpression(cardIds: [...])

1
2
3
4
Logged event:
- userId: <USER_ID>
- sessionId: <SESSION_ID>
- data: contentCardClick(cardIds: [...])

1
2
3
Opening '<URL>':
- channel: contentCard
- useWebView: true

1
2
3
4
Logged event:
- userId: <USER_ID>
- sessionId: <SESSION_ID>
- data: contentCardDismissed(cardIds: [...])

確認すべき事項

• カードが表示されない：セッション開始が記録されていることを確認してください。Content Cardsは同期するためにアクティブなセッションが必要です。
• 新規ユーザーにカードが表示されない：新規ユーザーは初回セッションではContent Cardsが表示されない場合があります。次のセッションまでお待ちください。これは想定される動作です。
• カードがサイズ制限を超えている：2KBを超えるContent Cardsは表示されず、メッセージは中断されます。
• キャンペーンを停止した後もカードが残る：キャンペーンを停止した後に同期が完了したことを確認してください。同期が成功すると、Content Cardsはデバイスから削除されます。キャンペーンを停止する際は、ユーザーフィードからアクティブなカードを削除するオプションが選択されていることを確認してください。

ディープリンク

ディープリンクのログは、プッシュ通知、アプリ内メッセージ、Content Cardsにわたって表示されます。ログの構造は、ソースチャネルに関係なく一貫しています。

• swift
• android

1
2
3
4
5
Opening '<DEEP_LINK_URL>':
- channel: <SOURCE_CHANNEL>
- useWebView: false
- isUniversalLink: false
- extras: { ... }

1
adb shell am start -W -a android.intent.action.VIEW -d "<YOUR_DEEP_LINK>" "<YOUR_PACKAGE_NAME>"

確認すべきポイント

• ディープリンクURLがキャンペーンで設定したものと一致していることを確認してください。
• ディープリンクが1つのチャネル（例：プッシュ）では動作するが、別のチャネル（例：Content Cards）では動作しない場合、ディープリンクの処理実装がすべてのチャネルをサポートしているかどうかを確認してください。
• iOSでは、ユニバーサルリンクには追加の処理が必要です。Brazeチャネルからユニバーサルリンクが動作しない場合、アプリがURL処理用の BrazeDelegate プロトコルを実装しているか確認してください。
• Androidでは、カスタムハンドラーを使用している場合、自動ディープリンク処理が無効になっているか確認してください。そうでないと、デフォルトのハンドラーが実装と競合する可能性があります。

ユーザー識別

ユーザーが external_id で識別されると、SDKはユーザー変更イベントを記録します。

• android
• swift

1
changeUser called with: <EXTERNAL_ID>

1
"user_id": "<EXTERNAL_ID>"

ネットワークリクエスト

詳細ログには、SDKとBrazeサーバー間の通信に関するHTTPリクエストおよびレスポンスの完全な詳細が含まれます。これらは接続の問題を診断する際に役立ちます。

リクエスト構造

設定済みのBrazeエンドポイント（例：sdk.iad-01.braze.com）へのリクエストをフィルタリングします。リクエスト構造には以下が含まれます：

• swift
• android

1
2
3
4
5
6
7
[http] request POST: <YOUR_BRAZE_ENDPOINT>
- Headers:
  - Content-Type: application/json
  - X-Braze-Api-Key: <REDACTED>
  - X-Braze-Req-Attempt: 1
  - X-Braze-Req-Tokens-Remaining: <COUNT>
- Body: { ... }

1
Making request(id = <REQUEST_ID>) to <YOUR_BRAZE_ENDPOINT>

確認すべき項目

• APIキー: XBraze-ApiKey がワークスペースのAPIキーと一致していることを確認します。
• エンドポイント: リクエストURLが設定済みのSDKエンドポイントと一致していることを確認します。
• リトライ回数: XBraze-Req-Attempt が1より大きい場合、SDKが失敗したリクエストをリトライしていることを示しており、接続の問題がある可能性があります。
• レート制限: XBraze-Req-Tokens-Remaining は残りのリクエストトークン数を示します。カウントが少ない場合、SDKがレート制限に近づいている可能性があります。
• リクエストの欠落: Androidでは、セッション開始後にBrazeエンドポイントへのリクエストが表示されない場合、APIキーとエンドポイントの設定を確認してください。

一般的なイベントの略称

冗長ログペイロードでは、Brazeは省略されたイベント名を使用します。以下はリファレンスです。

トラブルシューティング

Android SDK 13.1.0〜15.x でジオフェンスがトリガーされない

Braze Android SDK 13.1.0 から 15.x には、ジオフェンス更新イベントの記録が停止する可能性のあるリグレッションがありました。Android 10 以前を実行しているデバイスでは、セッション開始時の位置情報の更新も失敗する可能性がありました。Android SDK 16.0.0 以降にアップグレードしてください。SDKの設定については、ジオフェンスを参照してください。

ユーザープロファイルのセッション数が0と記録されるのはどのような場合ですか？

REST API（/users/track）またはCSVインポートでFirst session や Last session フィールドなしにユーザーをインポートした場合、ユーザープロファイルにセッション数が0と表示されることがあります。セッションは、ユーザーがSDKを通じてアプリを操作したときに記録されます。詳細については、ユーザープロファイルのセッション数が0を参照してください。

SDKとREST APIを併用した場合のユーザーデータの不一致

SDKとREST APIを同時に使用すると、競合によりデータの不一致が発生する可能性があります。changeUser() を呼び出した後、重要なREST API呼び出しを行う前にSDKが保留中のデータをフラッシュできるようにし、時間に敏感な更新のバッチ処理を避け、SDKとAPIリクエストの間に短い遅延を追加することを検討してください。changeUser() の動作については、changeUser() の仕組みを参照してください。

データがBrazeに届かない

データがBrazeに届かない場合は、ファイアウォールがBraze APIエンドポイントおよびCDNプロバイダーへの送信トラフィックを許可していることを確認してください。問題が発生している間にMTRテストを実行し、Fastly Debugを使用してください。許可リストへの登録と接続のトラブルシューティングについては、APIネットワーク接続の問題を参照してください。