Currents용 Amplitude
Amplitude는 제품 분석 및 비즈니스 인텔리전스 플랫폼입니다.
Braze와 Amplitude의 양방향 통합을 통해 Amplitude 코호트를 동기화하고, 사용자 특성 및 이벤트를 Braze로 가져올 수 있으며, Braze 커런츠를 활용하여 Braze 이벤트를 Amplitude로 내보내 제품 및 마케팅 데이터에 대한 심층 분석을 수행할 수 있습니다.
필수 조건
| 요구 사항 | 설명 |
|---|---|
| Amplitude 계정 | 이 파트너십을 활용하려면 Amplitude 계정이 필요합니다. |
| Currents | 데이터를 Amplitude로 다시 내보내려면 계정에 Braze 커런츠가 설정되어 있어야 합니다. |
데이터 내보내기 통합
Braze에서 Amplitude로 내보낼 수 있는 이벤트 및 이벤트 속성정보의 전체 목록은 다음 섹션에서 확인할 수 있습니다. Amplitude로 전송되는 모든 이벤트에는 사용자의 external_user_id가 Amplitude 사용자 ID로 포함됩니다. Braze 전용 이벤트 속성정보는 Amplitude로 전송되는 데이터의 event_properties 키 아래에 전송됩니다.

이 기능을 사용하려면 Amplitude 사용자 ID가 Braze 외부 ID와 일치해야 합니다.
Braze는 external_user_id가 설정된 사용자 또는 device_id가 설정된 익명 사용자에 대해서만 이벤트 데이터를 전송합니다. 익명 사용자의 경우 SDK에서 Amplitude 기기 ID를 Braze 기기 ID와 동기화해야 합니다. 예를 들어:
1
amplitude.setDeviceId(Appboy.getInstance(context).getDeviceId();)
Amplitude로 두 가지 유형의 이벤트를 내보낼 수 있습니다: 메시지 전송과 직접 관련된 Braze 이벤트로 구성된 메시지 참여 이벤트와 세션, 커스텀 이벤트, 플랫폼을 통해 추적된 구매 등 기타 앱 또는 웹사이트 활동을 포함하는 고객 행동 이벤트입니다. 모든 일반 이벤트에는 [Appboy] 접두사가 붙고, 모든 커스텀 이벤트에는 [Appboy] [Custom Event] 접두사가 붙습니다. 커스텀 이벤트 및 구매 이벤트 속성정보에는 각각 [Custom event property] 및 [Purchase property] 접두사가 붙습니다.
Braze로 이름이 지정되고 가져온 모든 코호트에는 [Amplitude] 접두사와 cohort_id 접미사가 붙습니다. 즉, cohort_id “abcd1234”가 포함된 “TEST_COHORT”라는 이름의 코호트는 Braze 필터에서 [Amplitude] TEST_COHORT: abcd1234라는 제목이 붙게 됩니다.
추가 이벤트 권한에 대한 액세스가 필요한 경우 계정 매니저에게 문의하거나 고객지원 티켓을 열어주세요.
1단계: Braze에서 Amplitude 통합 구성
Amplitude에서 Amplitude 내보내기 API 키를 찾습니다.

Amplitude API 키를 최신 상태로 유지하세요. 커넥터의 자격 증명이 만료되면 커넥터가 이벤트 전송을 중단합니다. 이 상태가 48시간 이상 지속되면 커넥터의 이벤트가 삭제되고 데이터가 영구적으로 손실됩니다.
2단계: Braze 커런트 생성
Braze에서 Currents > + Create Current > Create Amplitude Export로 이동합니다. 나열된 필드에 통합 이름, 연락처 이메일, Amplitude 내보내기 API 키 및 Amplitude 리전을 입력합니다. 그런 다음 추적하려는 이벤트를 선택합니다. 사용 가능한 이벤트 목록이 제공됩니다. 마지막으로 Launch Current을 클릭합니다.

Braze 커런츠에서 Amplitude로 전송된 이벤트는 Amplitude 이벤트 볼륨 할당량에 포함됩니다.

자세한 내용은 Amplitude의 통합 문서를 확인하세요.
사용량 제한
Currents는 Amplitude의 HTTP API에 연결되며, 이 API에는 기기당 30 이벤트/초의 사용량 제한과 기기당 500K 이벤트/일의 문서화되지 않은 제한이 있습니다. 이러한 임계값을 초과하면 Amplitude는 Currents를 통해 기록된 이벤트를 스로틀링합니다. 통합의 기기가 이 사용량 제한을 초과하면 모든 기기의 이벤트가 Amplitude에 표시되는 시점이 지연될 수 있습니다.
정상적인 상황에서 기기는 30 이벤트/초 또는 500K 이벤트/일을 초과하여 보고해서는 안 되며, 이 이벤트 패턴은 잘못 구성된 통합으로 인해서만 발생해야 합니다. 이러한 유형의 지연을 방지하려면 SDK 통합이 SDK 통합 지침에 명시된 대로 정상적인 속도로 이벤트를 보고하도록 하고, 단일 기기에 대해 많은 이벤트를 생성하는 자동화된 테스트를 실행하지 마세요.
지원되는 Currents 이벤트
Braze는 Currents 사용자 행동 및 메시지 참여 이벤트 용어집에 나열된 다음 데이터를 Amplitude로 내보내는 것을 지원합니다:
동작
- 커스텀 이벤트:
users.behaviors.CustomEvent - 설치 경로:
users.behaviors.InstallAttribution - 위치:
users.behaviors.Location - 구매:
users.behaviors.Purchase - 제거:
users.behaviors.Uninstall - 앱 (첫 번째 세션, 세션 종료, 세션 시작)
users.behaviors.app.FirstSessionusers.behaviors.app.SessionEndusers.behaviors.app.SessionStart
- 구독 (글로벌 상태 변경):
users.behaviors.subscription.GlobalStateChange - 구독 그룹 (상태 변경):
users.behaviors.subscriptiongroup.StateChange
Campaigns
- 중단:
users_campaigns_abort - 전환:
users.campaigns.Conversion - 컨트롤 등록:
users.campaigns.EnrollInControl
Canvas
- 중단:
users_canvas_abort - 전환:
users.canvas.Conversion - 진입:
users.canvas.Entry - 종료 (일치하는 오디언스, 수행된 이벤트)
users.canvas.exit.MatchedAudienceusers.canvas.exit.PerformedEvent
- 실험 단계 (전환, 분할 진입)
users.canvas.experimentstep.Conversionusers.canvas.experimentstep.SplitEntry
메시지
- 콘텐츠 카드 (중단, 클릭, 닫기, 노출, 전송)
users.messages.contentcard.Abortusers.messages.contentcard.Clickusers.messages.contentcard.Dismissusers.messages.contentcard.Impressionusers.messages.contentcard.Send
- 이메일 (중단, 반송, 클릭, 전달, 스팸 신고, 열기, 전송, 소프트 반송, 수신 거부)
- 인앱 메시지 (중단, 클릭, 노출)
users.messages.inappmessage.Abortusers.messages.inappmessage.Clickusers.messages.inappmessage.Impression
- 푸시 알림 (중단, 반송, iOS 포그라운드, 열기, 전송)
users.messages.pushnotification.Abortusers.messages.pushnotification.Bounceusers.messages.pushnotification.IosForegroundusers.messages.pushnotification.Openusers.messages.pushnotification.Send
- SMS (중단, 통신사 전송, 전달, 전달 실패, 인바운드 수신, 거부, 전송, 짧은 링크 클릭)
users.messages.sms.Abortusers.messages.sms.Deliveryusers.messages.sms.DeliveryFailureusers.messages.sms.InboundReceiveusers.messages.sms.Rejectionusers.messages.sms.Sendusers.messages.sms.ShortLinkClick
- 웹훅 (중단, 전송)
users.messages.webhook.Abortusers.messages.webhook.Send
- WhatsApp (중단, 전달, 실패, 인바운드 수신, 읽음, 전송)
users.messages.whatsapp.Abortusers.messages.whatsapp.Deliveryusers.messages.whatsapp.Failureusers.messages.whatsapp.InboundReceiveusers.messages.whatsapp.Readusers.messages.whatsapp.Send