자주 묻는 질문

이 페이지에서는 Currents에 대해 자주 묻는 질문에 대한 답변을 제공합니다.

특정 날짜 범위의 Campaign 또는 Canvas 데이터를 내보낼 수 있나요?

Campaign 또는 Canvas 측정기준을 특정 날짜 범위로 가져오려면 다음 방법 중 하나를 사용하세요:

• 표준 API 기간 외에 대시보드 스타일의 보고가 필요한 경우 날짜 기반 내보내기를 위한 제품 요청을 제출하세요.
• ending_at 및 length 파라미터를 사용하여 Campaign 분석 또는 Canvas 분석 엔드포인트를 호출하거나, 시계열 데이터를 위해 /campaigns/data_series 및 /canvas/data_series를 사용하세요.
• Amazon S3, Azure Blob Storage 또는 기타 지원되는 대상에서 지속적으로 쿼리 가능한 메시지 참여 데이터가 필요한 경우 Currents를 사용하여 이벤트를 데이터 웨어하우스로 스트리밍하세요.

활성 상태의 커런츠 통합을 어떻게 편집하나요?

활성 상태의 Currents 커넥터를 변경하려면 통합을 열고 페이지 왼쪽 하단의 편집을 클릭하세요. 편집이 없으면 통합 UI는 읽기 전용 상태로 유지되며, 아이콘만으로는 커넥터 설정을 수정할 수 없습니다.

Braze는 업로드 후 Azure Blob Storage Avro 파일을 어떻게 처리하나요?

Braze는 업로드가 완료된 후 Microsoft Azure Blob Storage의 Avro 파일을 수정하지 않습니다. Azure는 업로드가 아직 진행 중인 동안 blob 삭제를 차단할 수 있습니다.

과거 데이터는 어떻게 얻나요?

Currents는 실시간 라이브 데이터 스트림이므로 이벤트를 다시 재생할 수 없습니다. 하지만 Amazon S3 또는 Microsoft Azure Blob Storage와 같은 데이터 웨어하우스에 Currents 데이터를 저장할 수 있으므로 과거 이벤트에 대해 적절하게 조치를 취할 수 있습니다. 데이터는 30일 동안 보관되지만, 더 많은 과거 데이터가 필요하면 Snowflake를 쿼리할 수 있습니다.

Currents가 JSON이 아닌 Avro 형식으로 데이터를 출력하는 이유는 무엇인가요?

Avro는 스키마가 없는 JSON과 달리 스키마 진화를 기본적으로 지원합니다. 또한 Avro는 압축률이 높기 때문에 대역폭을 줄이고 저장 공간을 절약하면서 Avro 파일을 전송할 수 있는 이점을 누릴 수 있습니다.

Braze는 파일 오버헤드를 어떻게 처리하나요?

한 데이터베이스에서 대량의 데이터를 가져와 다른 데이터베이스에 저장할 수 있는 추출, 변환, 로드(ETL) 프로세스를 구축합니다.

쿼리를 위해 이 데이터를 어디에 저장해야 하나요?

Braze는 쿼리를 위해 데이터를 저장할 수 있는 여러 데이터 웨어하우스와 제휴하고 있습니다. 다음을 사용하는 것을 권장합니다:

• Amazon S3
• Microsoft Azure Blob Storage
• Google Cloud Storage.

Currents 데이터는 얼마나 신뢰할 수 있나요?

Currents는 “최소 1회” 전달을 보장하므로, 중복 이벤트가 간혹 스토리지 버킷에 기록될 수 있습니다. 사용 사례에서 정확히 1회 전달이 필요한 경우, 모든 이벤트와 함께 전송되는 고유 식별자 필드(id)를 사용하여 이벤트를 중복 제거할 수 있습니다. 자세한 내용은 이벤트 전달 시맨틱을 참조하세요.

데이터는 얼마나 자주 Currents에 동기화되나요?

데이터는 지속적으로 스트리밍됩니다. Braze는 전송할 전체 배치가 준비되거나 5분이 경과할 때마다(둘 중 먼저 도래하는 시점에) 이벤트 배치를 전송합니다. 대용량 커넥터의 경우 데이터가 거의 실시간으로 도착합니다. 소량 커넥터의 경우 데이터가 5~30분 내에 도착할 것으로 예상됩니다. 자세한 내용은 Avro 쓰기 임계값을 참조하세요.

Currents에서 사용 가능한 이벤트를 어떻게 확인하나요?

Currents가 기록하는 이벤트의 전체 목록은 고객 행동 이벤트 및 메시지 참여 이벤트 용어집을 참조하세요. 이벤트 유형(예: 발송, 전달, 열기)별로 이 용어집을 필터링할 수 있습니다.

Currents 이벤트 수가 대시보드 또는 참여 보고서 측정기준과 일치하지 않는 이유는 무엇인가요?

Currents와 Braze 대시보드는 특정 측정기준을 다르게 계산하므로, Currents 이벤트와 대시보드 측정기준 간의 정확한 일치는 예상되지 않습니다.

고유 클릭: 이메일의 경우, 대시보드는 7일 기간 동안의 고유 클릭을 추적하며 dispatch_id로 측정합니다. Currents는 각 원시 클릭 이벤트를 기록합니다. Currents 기반 고유 클릭 수를 대시보드 측정기준과 맞추려면 is_unique가 true인 이벤트를 필터링하세요.

탈퇴: 대시보드의 탈퇴 측정기준은 Braze의 표준 탈퇴 링크 클릭을 반영합니다. 커스텀 탈퇴 페이지는 API를 통해 사용자를 업데이트하지 않는 한 이 측정기준을 증가시키지 않습니다. Currents의 users.messages.email.Unsubscribe 이벤트는 사용자가 이메일 본문이나 푸터의 탈퇴 링크를 클릭하거나 list-unsubscribe 헤더를 통해 클릭할 때 발생하는 특수 클릭 이벤트입니다. 이는 모든 이메일 구독 상태 변경을 나타내는 것은 아닙니다.

타임스탬프 및 시간대: 모든 Currents 타임스탬프는 UTC입니다. 대시보드 측정기준은 회사의 시간대를 따릅니다. 회사의 시간대로 변환하지 않고 Currents 데이터를 달력 날짜별로 집계하면 대시보드에 표시되는 것과 다른 날짜 버킷에 수치가 포함될 수 있습니다.

중복 이벤트: Currents는 최소 1회 전달을 제공하므로 중복 이벤트가 간혹 기록될 수 있습니다. 대시보드 측정기준과 비교하기 전에 각 이벤트의 고유 id 필드로 중복을 제거하세요.

Currents 이메일 열기 또는 클릭 이벤트의 external_user_id(Braze 스키마: external_id)가 Braze 대시보드의 고객 프로필과 다른 이유는 무엇인가요?

• Braze 대시보드에서: 이메일 주소와 연결된 사용자가 이메일을 열거나 클릭하면, 해당 이메일 주소를 공유하는 모든 고객 프로필이 이메일을 열었거나 클릭한 것으로 표시됩니다. 자세한 내용은 이메일이 발송될 때 여러 프로필이 동일한 이메일 주소를 가지고 있으면 어떻게 되나요?를 참조하세요.
• Currents에서: 동일한 열기 또는 클릭은 하나의 프로필에 저장됩니다. Braze는 해당 프로필이 여전히 이메일 주소를 공유하고 있는 경우 원래 발송 대상이었던 프로필에 귀속시킵니다. 그렇지 않으면 이메일 주소를 공유하는 프로필 중 무작위로 선택된 하나의 프로필에 귀속시킵니다.

이러한 이유로, Currents 이메일 열기 또는 클릭 이벤트의 external_user_id 값(Braze 스키마 매핑 테이블에서 external_id로 명명됨)은 Currents와 Braze 대시보드를 비교할 때 예상하는 고객 프로필과 일치하지 않을 수 있습니다.

모든 발송 이벤트가 Currents에 기록되나요?

모든 이벤트가 Currents에 기록됩니다. 이벤트가 Currents 스트림에서 의도적으로 제외되는 시나리오는 없습니다.

Currents에서 데이터가 손상될 수 있나요?

정상적인 상황에서 Currents 데이터는 손상되지 않습니다. 드문 문제가 발생할 가능성은 항상 있지만, 데이터가 체계적으로 손상되는 알려진 조건은 없습니다.

커런츠 통합을 설정하기 전 날짜의 커스텀 이벤트 데이터가 보이는 이유는 무엇인가요?

Braze는 Currents에 이벤트를 소급 적용하지 않습니다. 하지만 커스텀 이벤트는 과거 타임스탬프로 기록될 수 있습니다(예: 이벤트 발생 시 기기가 오프라인이었고 나중에 동기화된 경우). 이러한 경우 이벤트 타임스탬프는 이벤트가 원래 발생한 시점을 반영하며, 이는 커런츠 통합이 구성되기 전일 수 있습니다.

Currents 이벤트에는 어떤 사용자 식별자가 포함되나요?

메시지 참여 이벤트(발송, 열기, 클릭 등)에는 Braze 사용자 ID(user_id)와 프로필에 존재하는 경우 외부 식별자(이벤트 페이로드에서 external_user_id, Braze 스키마 매핑 테이블에서는 external_id로 표시됨)가 포함됩니다. 일부 이메일 메시지 참여 이벤트에는 email_address도 포함됩니다. 커스텀 속성은 포함되지 않습니다. 아래를 참조하세요.

Currents 데이터를 데이터 웨어하우스나 CRM으로 라우팅하고 프로필 데이터와 조인해야 하는 경우, 다운스트림 시스템에서 user_id 또는 external_user_id를 사용하여 조인을 수행하세요.

Currents 발송 이벤트에 커스텀 속성을 포함할 수 있나요?

아니요. Currents는 발송 이벤트에 커스텀 속성을 포함하지 않습니다. Currents는 커스텀 이벤트와 메시지 참여 이벤트를 기록합니다. 사용 가능한 필드의 전체 목록은 이벤트 용어집을 참조하세요.

Currents에 Campaign 또는 Canvas 태그나 키-값 페어가 포함되나요?

아니요. Currents에는 Campaign 또는 Canvas 태그나 메시지 수준의 키-값 페어가 포함되지 않습니다. 태그 데이터를 가져오려면 내보내기 REST API를 사용하세요. 또 다른 해결 방법으로, Campaign에서 웹훅 채널을 사용하여 Liquid로 값을 템플릿화하여 태그 또는 키-값 페어 데이터를 자체 엔드포인트로 전송할 수 있습니다.

Braze는 Currents 변경 사항을 고객에게 어떻게 알리나요?

Currents 변경 사항(예: 새 이벤트 필드 또는 이벤트 유형)이 발생하면, Braze는 활성 커런츠 통합을 보유하고 있으며 지난 30일 이내에 대시보드를 사용한 모든 고객에게 이메일을 발송합니다. 최신 변경 사항은 커런츠 체인지로그에서도 확인할 수 있습니다.

Currents 데이터에 얼마나 많은 스토리지가 필요한가요?

스토리지 요구 사항은 이벤트 볼륨과 내보내는 이벤트 유형에 따라 달라집니다. Braze는 사용 사례에 맞는 파일 크기를 추정하는 데 사용할 수 있는 Avro 형식의 샘플 이벤트를 제공합니다.

Currents 데이터에서 Campaign 이름이나 캔버스 단계 이름이 NULL인 이유는 무엇인가요?

새 Campaign이나 Canvas를 생성하면 이름이 모든 Braze 시스템에 전파되는 데 시간이 걸릴 수 있습니다. 이 기간 동안 Currents를 통해 전송된 이벤트의 이름 필드(예: campaign_name 또는 canvas_step_name)에 NULL이 표시될 수 있습니다. 이벤트가 기록되기 직전에 이름이 수정된 경우에도 이러한 현상이 예상됩니다. 이를 방지하려면 Campaign이나 캔버스 단계를 생성하거나 이름을 변경한 후 발송하기 전에 어느 정도 시간을 두세요.

Currents에서 세션 종료 이벤트가 지연되거나 누락되는 이유는 무엇인가요?

세션 종료 이벤트는 SDK의 일반적인 업로드 스케줄을 따릅니다. Braze SDK는 세션 데이터를 로컬에 캐시하고 네트워크 품질에 따라 주기적으로 플러시합니다. 예를 들어, 양호한 연결에서는 약 10초마다 플러시합니다. SDK가 이벤트를 업로드하기 전까지는 Currents에 표시되지 않습니다.

사용자가 앱을 강제 종료하거나 다음 플러시 전에 오프라인 상태가 되면, 세션 종료 이벤트가 늦게 도착하거나 전혀 도착하지 않을 수 있습니다. iOS에서는 SDK가 앱이 백그라운드에 있는 동안 데이터를 전송할 수 없기 때문에 세션 종료 이벤트가 앱이 다시 열릴 때까지 플러시되지 않는 경우가 많습니다.

Currents에서 더 적시에 세션 경계가 필요한 경우, 앱이 백그라운드로 이동하거나 포그라운드로 돌아올 때와 같은 라이프사이클 시점에서 requestImmediateDataFlush()를 호출하세요. 자세한 내용은 데이터 업로드 및 다운로드 및 세션 종료와 세션 시작의 타임스탬프가 유사한 경우(iOS)를 참조하세요.

Currents가 데이터를 쓰려고 할 때 스토리지 버킷을 사용할 수 없으면 어떻게 되나요?

데이터 전송 시점에 스토리지 버킷을 사용할 수 없으면 해당 데이터는 손실됩니다. Braze는 성공적으로 전달되지 않은 이벤트를 소급 적용할 수 없습니다. 데이터 손실을 방지하려면 스토리지 버킷이 항상 사용 가능하고 올바르게 구성되어 있는지 확인하세요.

커런츠 통합을 편집할 때 “고객 행동 이벤트 자격이 남아 있지 않습니다”라는 메시지가 표시되는 이유는 무엇인가요?

이 메시지는 기존 커런츠 통합을 업데이트할 때 워크스페이스가 고객 행동 이벤트에 대한 자격 한도에 도달한 경우 나타날 수 있습니다. 자격을 요청하거나 구성을 조정하려면 Braze 계정 매니저에게 문의하세요.

스토리지 경로의 Currents 버전은 얼마나 자주 변경되나요?

스토리지 경로의 version=<currents_version> 세그먼트는 월별 주기로 각 Currents 릴리스마다 증가합니다(예: version=6에서 version=7으로). 버전 변경 후에도 파이프라인이 자동으로 데이터를 가져올 수 있도록, 특정 버전 세그먼트를 하드코딩하는 대신 루트 경로에서 파일을 재귀적으로 읽는 것을 권장합니다. 경로 형식에 대한 자세한 내용은 이벤트 전달 시맨틱을 참조하세요. 버전별 변경 이력은 커런츠 체인지로그를 참조하세요.

메시지 참여 이벤트에서 campaign_id 또는 canvas_id가 누락되는 이유는 무엇인가요?

이벤트 유형과 컨텍스트에 따라 메시지 참여 이벤트가 특정 Campaign이나 캔버스 단계에 연결되지 않을 수 있습니다. 이러한 경우 campaign_id, canvas_id 및 관련 이름 필드가 이벤트 페이로드에서 생략될 수 있습니다. 해당 필드가 특정 이벤트에 표시되지 않는 경우, 해당 이벤트 유형과 컨텍스트에서 일반적으로 Campaign 또는 Canvas 식별자가 포함되는지 확인하세요.

Currents 타임스탬프가 초 단위 정밀도로 제한되는 이유는 무엇인가요?

Currents 이벤트의 time 필드는 32비트 정수로 저장되므로 초 단위 정밀도로 제한됩니다. 일부 이벤트에는 별도의 64비트 밀리초 정밀도 타임스탬프 필드도 포함되어 있습니다. 각 이벤트 유형에서 사용 가능한 필드는 이벤트 용어집을 확인하세요.

Currents의 users.canvas.Conversion 이벤트 시간이 Canvas와 다른 이유는 무엇인가요?

Currents의 users.canvas.Conversion 이벤트 시간은 Canvas 진입 시점부터 측정된 총 전환 기간(Canvas 기간 + 전환 마감일)을 반영합니다.

참여 보고서가 S3로 전송되면 어떻게 되나요?

S3 자격 증명이 Currents가 아닌 데이터 내보내기용으로 구성된 경우, Braze는 참여 보고서를 지정된 S3 버킷에 업로드합니다. 보고서 수신자 필드에 나열된 사용자는 S3의 보고서 링크가 포함된 이메일을 수신합니다.

익명 사용자 데이터를 Braze 커런츠를 통해 Amplitude로 전송할 수 있나요?

device_id로 식별되는 익명 사용자 데이터는 Currents를 통해 Amplitude로 전송할 수 있습니다. 이 기능을 사용하려면 Braze 계정 팀에서 기능을 활성화해야 합니다.

Content Cards 및 인앱 메시지의 대조군 노출은 Currents에서 어떻게 기록되나요?

사용자가 Content Cards 또는 인앱 메시지 Campaign의 대조군에 할당되면, Currents는 노출 이벤트 대신 users.campaigns.EnrollInControl 이벤트를 발생시킵니다.

API를 통해 존재하지 않는 사용자를 타겟팅하면 어떻게 되나요?

존재하지 않는 사용자를 타겟팅하면 API는 200 응답을 반환하지만, “Unknown external ID”라는 결과와 함께 발송이 취소됩니다. 해당 발송에 대한 Currents 이벤트는 생성되지 않습니다. send_to_existing_only 파라미터는 기본값이 true이므로, 명시적으로 false로 설정하지 않는 한 알 수 없는 사용자에 대한 발송은 자동으로 건너뜁니다.