상세 로그 읽기

이 페이지에서는 Braze SDK의 상세 로그 출력을 해석하는 방법을 설명합니다. 각 메시징 채널에 대해 찾아야 할 주요 로그 항목, 그 의미 및 주의해야 할 일반적인 문제를 찾을 수 있습니다.

시작하기 전에 상세 로깅을 활성화하고 플랫폼에서 로그를 수집하는 방법을 알고 있는지 확인하십시오.

세션

세션은 Braze 분석 및 메시지 전달의 기초입니다. 인앱 메시지 및 콘텐츠 카드와 같은 많은 메시징 기능은 기능을 수행하기 전에 유효한 세션이 시작되어야 합니다. 세션이 올바르게 기록되지 않으면 먼저 이를 조사하십시오. 세션 추적을 활성화하는 방법에 대한 자세한 내용은 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 위임자를 구현하지 않았는지 확인하십시오.
• “이벤트에 대한 일치하는 트리거가 없습니다”라는 메시지가 나타나면, 이는 정상이며 해당 이벤트에 대해 추가적인 인앱 메시지가 구성되지 않았음을 나타냅니다.

콘텐츠 카드

콘텐츠 카드 로그는 카드가 기기에 동기화되고 사용자에게 표시되며 상호작용(노출 횟수, 클릭, 해제)이 추적되고 있는지 확인하는 데 도움이 됩니다.

카드 동기화

콘텐츠 카드는 세션 시작 시 및 수동 새로고침 요청 시 동기화됩니다. 세션이 기록되지 않으면 콘텐츠 카드가 표시되지 않습니다.

• 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: [...])

확인할 사항

• 카드가 표시되지 않음: 세션 시작이 기록되었는지 확인하십시오. 콘텐츠 카드는 동기화를 위해 활성 세션이 필요합니다.
• 새 사용자에게 카드가 누락됨: 첫 세션의 새 사용자는 다음 세션까지 콘텐츠 카드를 보지 못할 수 있습니다. 이는 예상되는 동작입니다.
• 카드가 크기 제한을 초과함: 2 KB를 초과하는 콘텐츠 카드는 표시되지 않으며 메시지가 중단됩니다.
• 캠페인 중지 후 카드가 지속됨: 캠페인이 중지된 후 동기화가 완료되었는지 확인하십시오. 콘텐츠 카드는 성공적인 동기화 후 기기에서 제거됩니다. 캠페인을 중지할 때 사용자 피드에서 활성 카드를 제거하는 옵션이 선택되었는지 확인하십시오.

딥 링크

딥 링크 로그는 푸시 알림, 인앱 메시지 및 콘텐츠 카드에 나타납니다. 로그 구조는 소스 채널에 관계없이 일관됩니다.

• 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이 캠페인에서 구성한 내용과 일치하는지 확인하십시오.
• 딥 링크가 한 채널(예: 푸시)에서는 작동하지만 다른 채널(예: 콘텐츠 카드)에서는 작동하지 않는 경우, 딥 링크 처리 구현이 모든 채널을 지원하는지 확인하십시오.
• iOS에서는 유니버설 링크에 추가 처리가 필요합니다. Braze 채널에서 유니버설 링크가 작동하지 않는 경우, 앱이 URL 처리를 위해 BrazeDelegate 프로토콜을 구현했는지 확인하십시오.
• Android에서는 사용자 정의 핸들러를 사용하는 경우 자동 딥 링크 처리가 비활성화되어 있는지 확인하십시오. 그렇지 않으면 기본 핸들러가 구현과 충돌할 수 있습니다.

사용자 식별

사용자가 external_id로 식별되면 SDK는 사용자 변경 이벤트를 기록합니다.

• android
• swift

1
changeUser called with: <EXTERNAL_ID>

1
"user_id": "<EXTERNAL_ID>"

네트워크 요청

자세한 로그에는 Braze 서버와의 SDK 통신을 위한 전체 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 key: XBraze-ApiKey가 귀하의 작업 공간의 API 키와 일치하는지 확인하십시오.
• 엔드포인트: 요청 URL이 구성된 SDK 엔드포인트와 일치하는지 확인하십시오.
• 재시도 시도: XBraze-Req-Attempt가 1보다 크면 SDK가 실패한 요청을 재시도하고 있음을 나타내며, 이는 연결 문제를 신호할 수 있습니다.
• 요금 제한: XBraze-Req-Tokens-Remaining는 남은 요청 토큰을 보여줍니다. 낮은 수치는 SDK가 요금 제한에 접근하고 있음을 나타낼 수 있습니다.
• 누락된 요청: Android에서 세션 시작 후 Braze 엔드포인트에 대한 요청이 보이지 않으면 API 키 및 엔드포인트 구성을 확인하십시오.

일반 이벤트 약어

자세한 로그 페이로드에서 Braze는 약어 이벤트 이름을 사용합니다. 참조입니다: