SDK 데이터 수집
Braze SDK를 앱 또는 사이트에 통합하면 Braze가 특정 유형의 데이터를 자동으로 수집합니다. 이 데이터 중 일부는 프로세스에 필수적이며, 일부 데이터는 필요에 따라 설정하거나 해제할 수 있습니다. 또한 세분화 및 메시징을 더욱 강화하기 위해 추가 유형의 데이터를 수집하도록 Braze를 구성할 수도 있습니다.
Braze는 유연한 데이터 수집이 가능하도록 설계되었으므로 다음과 같은 방법으로 Braze SDK를 통합할 수 있습니다:
- 최소 통합: Braze는 Braze 서비스와의 통신에 필요한 데이터를 자동으로 수집합니다.
- 기본적으로 수집되는 선택적 데이터: Braze는 대부분의 활용 사례에 광범위하게 유용한 일부 데이터를 자동으로 캡처합니다. Braze 서비스와의 통신에 필수적이지 않은 경우 이 데이터의 자동 수집을 비활성화할 수 있습니다.
- 기본적으로 수집되지 않는 선택적 데이터: Braze는 특정 활용 사례에 유용한 일부 데이터를 캡처하며, 광범위한 규정 준수를 위해 자동으로 수집을 활성화하지는 않습니다. 활용 사례에 적합한 경우 이 데이터를 수집하도록 선택할 수 있습니다.
- 개인화된 통합: Braze는 기본 선택적 데이터 외에도 추가 데이터를 유연하게 수집할 수 있는 기능을 제공합니다.
최소 통합
다음은 SDK를 초기화할 때 Braze가 생성하고 수신하는 필수 데이터의 목록입니다. 이 데이터는 구성할 수 없으며 핵심 플랫폼 기능에 필수적입니다. 세션 시작 및 세션 종료를 제외하고, 자동으로 추적되는 다른 모든 데이터는 데이터 포인트 사용량에 포함되지 않습니다.
| 속성 | 설명 | 수집하는 이유 |
|---|---|---|
| 앱 버전 이름 / 앱 버전 코드 |
최신 앱 버전 | 이 속성은 앱 버전 호환성과 관련된 메시지를 올바른 기기로 전송하는 데 사용됩니다. 서비스 중단이나 버그를 사용자에게 알리는 데 사용할 수 있습니다. |
| Country | IP 주소 지리 위치로 식별된 국가. IP 주소 지리 위치를 사용할 수 없는 경우 기기 로캘로 식별됩니다. 해당 값은 SDK가 setCountry로 직접 설정하는 값으로 대체될 수 있으나, SDK나 API를 통해 속성 값을 전달할 경우 데이터 포인트가 기록된다는 점에 유의하세요. 국가가 수동으로 설정된 후(SDK 메서드, REST API 또는 CSV 업로드를 통해)에는 SDK가 더 이상 이 값을 자동으로 업데이트하지 않습니다. |
이 속성은 위치를 기준으로 메시지를 타겟팅하는 데 사용됩니다. |
| Device ID | 기기 식별자, 무작위로 생성된 문자열 | 이 속성은 사용자의 기기를 구분하고 올바른 기기로 메시지를 전송하는 데 사용됩니다. |
| OS 및 OS 버전 | 현재 보고된 기기 또는 브라우저 및 기기 또는 브라우저 버전 | 이 속성은 호환되는 기기로만 메시지를 보내는 데 사용됩니다. 세분화 내에서 사용자가 앱 버전을 업그레이드하도록 타겟팅하는 데도 사용할 수 있습니다. |
| 세션 시작 및 세션 종료 | 사용자가 통합된 앱 또는 사이트를 사용하기 시작할 때 | Braze SDK는 사용자 참여를 계산하기 위해 Braze 대시보드에서 사용하는 세션 데이터 및 사용자를 이해하는 데 핵심적인 기타 분석을 보고합니다. 앱 또는 사이트에서 세션 시작 및 세션 종료가 호출되는 정확한 시점은 개발자가 구성할 수 있습니다(Android, iOS, Web). |
| SDK 메시지 상호작용 데이터 | 푸시 직접 열기, 인앱 메시지 상호작용, 콘텐츠 카드 상호작용 | 이 속성은 메시지가 수신되었는지 확인하고 전송이 중복되지 않도록 하는 등 품질 관리 목적으로 사용됩니다. |
| SDK 버전 | 현재 SDK 버전 | 이 속성은 호환되는 기기로만 메시지를 전송하고 서비스 중단을 방지하는 데 사용됩니다. |
| 세션 ID 및 세션 타임스탬프 | 세션 식별자, 무작위로 생성된 문자열 및 세션 타임스탬프 | 사용자가 새 세션을 시작하는지 기존 세션을 이어가는지 여부를 판별하고, 이 사용자에게 의도된 메시지의 재수신 자격을 결정하는 데 사용됩니다. 인앱 메시지 및 콘텐츠 카드와 같은 일부 메시징 채널은 세션 시작 시 기기와 동기화됩니다. 그런 다음 백엔드는 기기가 저장하고 다시 전송하는 Braze 서버 마지막 접속 시점 관련 데이터를 사용하여 사용자가 새로운 메시지를 받을 자격이 있는지 확인합니다. |
계산된 측정기준
Braze는 SDK 데이터, 비 SDK 메시지와 관련된 메시지 상호작용 데이터 및 파생된 정보를 기반으로 계산된 측정기준을 생성합니다. 참고로, 이 계산된 데이터는 SDK에 의해 추적되는 것이 아니라 Braze 서비스에 의해 생성되며, 고객 프로필에는 추적된 데이터와 생성된 데이터가 모두 표시됩니다.
계산된 측정기준에는 다음 속성이 포함됩니다.
| 속성 | 설명 |
|---|---|
| 처음 사용한 앱 | 시간 |
| 마지막으로 사용한 앱 | 시간 |
| 총 세션 수 | 숫자 |
| 클릭한 카드 | 숫자 |
| 마지막으로 수신한 메시지 | 시간 |
| 마지막으로 받은 이메일 캠페인 | 시간 |
| 마지막으로 받은 푸시 캠페인 | 시간 |
| 피드백 항목 수 | 숫자 |
| 지난 Y일 동안의 세션 수 | 숫자와 시간 |
| 캠페인에서 메시지를 수신함 | 부울. 이 필터는 이전 캠페인을 수신했는지 여부에 따라 사용자를 타겟팅합니다. |
| 태그가 있는 캠페인에서 메시지를 수신함 | 부울. 이 필터는 현재 태그가 있는 캠페인을 수신했는지 여부에 따라 사용자를 타겟팅합니다. |
| 리타겟 캠페인 | 부울. 이 필터는 사용자가 과거에 특정 이메일, 푸시 또는 인앱 메시지를 열었거나 클릭했는지 여부에 따라 사용자를 타겟팅합니다. |
| 제거됨 | 부울 및 시간 |
최소 통합에만 관심이 있고 mParticle, Segment, Tealium 또는 GTM과 통합하는 경우 다음 사항에 유의하세요:
- 모바일 플랫폼: 이러한 구성에 대한 코드를 수동으로 업데이트해야 합니다. mParticle 및 Segment는 해당 플랫폼을 통해 이 작업을 수행할 수 있는 방법을 제공하지 않습니다.
- 웹: 최소 통합 구성을 허용하려면 Braze 통합을 네이티브로 수행해야 합니다. 태그 매니저는 플랫폼을 통해 이 작업을 수행할 수 있는 방법을 제공하지 않습니다.
기본적으로 수집되는 선택적 데이터
최소 통합 데이터 외에도, SDK 통합을 초기화할 때 다음 속성이 Braze에 의해 자동으로 캡처됩니다. 최소 통합을 위해 이러한 속성 수집을 거부할 수 있습니다.
| 속성 | 플랫폼 | 설명 | 수집하는 이유 |
|---|---|---|---|
| 브라우저 이름 | 웹 | 브라우저의 이름 | 이 속성은 호환되는 브라우저에만 메시지를 보내는 데 사용됩니다. 브라우저 기반 세분화에도 사용할 수 있습니다. |
| 기기 로캘 | Android, iOS | 기기의 기본 로캘 | 이 속성은 사용자의 선호 언어로 메시지를 번역하는 데 사용됩니다. |
| 최신 기기 로캘 | Android, iOS | 기기의 가장 최근 기본 로캘 | 이 속성은 사용자의 기기 설정에서 가져오며 메시지를 사용자가 선호하는 언어로 번역하는 데 사용됩니다. Most Recent Location 속성과는 독립적입니다. |
| 기기 모델 | Android, iOS | 기기의 특정 하드웨어 | 이 속성은 호환되는 기기로만 메시지를 보내는 데 사용됩니다. 세분화 내에서도 사용할 수 있습니다. |
| 기기 브랜드 | Android | 기기의 브랜드(예: Samsung) | 이 속성은 호환되는 기기로만 메시지를 보내는 데 사용됩니다. |
| 기기 이동통신사 | Android, iOS | 이동통신사 | 이 속성은 메시지 타겟팅에 선택적으로 사용됩니다. 참고: 이 필드는 iOS 16부터 더 이상 사용되지 않으며 향후 iOS 버전에서 기본값이 --로 설정됩니다. |
| 언어 | Android, iOS, 웹 | 기기 또는 브라우저 언어, 기기 로캘에서 가져옴 | 이 속성은 메시지를 사용자가 선호하는 언어로 번역하는 데 사용됩니다. 기기 로캘을 기반으로 합니다. |
| 알림 설정 | Android, iOS, 웹 | 이 앱에 푸시 알림이 활성화되어 있는지 여부 | 이 속성은 푸시 알림을 활성화하는 데 사용됩니다. |
| 해상도 | Android, iOS, 웹 | 기기 또는 브라우저 해상도 | 선택적으로 기기 기반 메시지 타겟팅에 사용됩니다. 이 값의 형식은 “<width>x<height>“입니다. |
| 시간대 | Android, iOS, 웹 | 기기 또는 브라우저 시간대 | 이 속성은 각 사용자의 현지 시간대에 따라 적절한 시간에 메시지를 보내는 데 사용됩니다. |
| 사용자 에이전트 | 웹 | 사용자 에이전트 | 이 속성은 호환되는 기기로만 메시지를 보내는 데 사용됩니다. 세분화 내에서도 사용할 수 있습니다. |
기기 수준 속성(기기 이동통신사, 시간대, 해상도 등) 추적에 대해 자세히 알아보려면 플랫폼별 설명서를 참조하세요: Android, iOS, Web.
기본적으로 수집되지 않는 데이터
기본적으로 다음 속성은 수집되지 않습니다. 각 속성은 수동으로 통합해야 합니다.
| 속성 | 플랫폼 | 설명 | 수집되지 않는 이유 |
|---|---|---|---|
| 기기 광고 추적 활성화 | Android, iOS | iOS에서:set(adTrackingEnabled:)Android에서: Braze.setGoogleAdvertisingId() |
이 속성은 추가적인 앱 수준 권한이 필요하며, 통합자가 부여해야 합니다. |
| 기기 IDFA | iOS | 광고주를 위한 기기 식별자 | 이는 앱 추적 투명성 프레임워크를 필요로 하며, App Store에서 추가적인 개인정보 검토가 트리거됩니다. 자세한 내용은 set(identifierForAdvertiser:)를 참조하세요. |
| Google 광고 ID | Android | Google Play 앱 내 광고를 위한 식별자 | 이를 위해 앱이 GAID를 검색하여 Braze에 전달해야 합니다. 자세한 내용은 선택적 Google 광고 ID를 참조하세요. |
| 가장 최근 위치 | Android, iOS | 사용자 기기의 마지막으로 알려진 GPS 위치입니다. 세션 시작 시 업데이트되며 사용자의 프로필에 저장됩니다. | 이를 위해서는 사용자가 앱에 위치 권한을 부여해야 합니다. |
Braze SDK는 IP 주소를 로컬에 저장하지 않습니다.
개인화된 통합
Braze를 최대한 활용하기 위해 SDK 통합자는 종종 Braze SDK를 구현하고 자동으로 수집된 데이터 외에 비즈니스와 관련된 커스텀 속성, 커스텀 이벤트 및 구매 이벤트를 기록합니다.
개인화된 통합은 사용자 경험과 관련된 맞춤형 커뮤니케이션을 가능하게 합니다.
Braze는 세션 수가 5,000,000개가 넘는 사용자(“더미 사용자”)를 금지 또는 차단하고 더 이상 해당 사용자의 SDK 이벤트를 수집하지 않습니다. 자세한 내용은 스팸 차단을 참조하세요.
GitHub 에서 이 페이지를 편집합니다.