상세 로그 읽기

이 페이지에서는 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를 보지 못할 수 있습니다. 이는 예상되는 동작입니다.
• 카드가 크기 제한을 초과함: 2 KB를 초과하는 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 키: 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 네트워크 연결 문제를 참조하세요.