詳細ログの読み取り

このページでは、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は表示されず、メッセージは中断されます。
• Campaignを停止した後もカードが残る：Campaignを停止した後に同期が完了したことを確認してください。同期が成功すると、Content Cardsはデバイスから削除されます。Campaignを停止する際は、ユーザーフィードからアクティブなカードを削除するオプションが選択されていることを確認してください。

ディープリンク

ディープリンクのログは、プッシュ通知、アプリ内メッセージ、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がCampaignで設定した内容と一致していることを確認してください。
• あるチャネル（例：プッシュ通知）ではディープリンクが機能するが、別のチャネル（例：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キー：X-Braze-Api-KeyがワークスペースのAPIキーと一致していることを確認してください。
• エンドポイント：リクエストURLが設定済みのSDKエンドポイントと一致していることを確認してください。
• 再試行回数：X-Braze-Req-Attemptが1より大きい場合、SDKが失敗したリクエストを再試行していることを示しており、接続の問題がある可能性があります。
• レート制限：X-Braze-Req-Tokens-Remainingは残りのリクエストトークン数を示します。カウントが低い場合、SDKがレート制限に近づいている可能性があります。
• リクエストが見つからない：Androidでは、セッション開始後にBrazeエンドポイントへのリクエストが表示されない場合は、APIキーとエンドポイントの設定を確認してください。

一般的なイベントの略称

詳細ログのペイロードにおいて、Brazeは省略形のイベント名を使用します。以下は参照用の一覧です：