Skip to content

Braze 학습 과정Currents용 Amplitude

Amplitude는 제품 분석 및 비즈니스 인텔리전스 플랫폼입니다.

Braze와 Amplitude의 양방향 통합을 통해 Amplitude 코호트를 동기화하고, 사용자 특성 및 이벤트를 Braze로 가져올 수 있으며, Braze 커런츠를 활용하여 Braze 이벤트를 Amplitude로 내보내 제품 및 마케팅 데이터에 대한 심층 분석을 수행할 수 있습니다.

필수 조건

데이터 내보내기 통합

Braze에서 Amplitude로 내보낼 수 있는 이벤트 및 이벤트 속성정보의 전체 목록은 다음 섹션에서 확인할 수 있습니다. Amplitude로 전송되는 모든 이벤트에는 사용자의 external_user_id가 Amplitude 사용자 ID로 포함됩니다. Braze 전용 이벤트 속성정보는 Amplitude로 전송되는 데이터의 event_properties 키 아래에 전송됩니다.

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 키를 찾습니다.

2단계: Braze 커런트 생성

Braze에서 Currents > + Create Current > Create Amplitude Export로 이동합니다. 나열된 필드에 통합 이름, 연락처 이메일, Amplitude 내보내기 API 키 및 Amplitude 리전을 입력합니다. 그런 다음 추적하려는 이벤트를 선택합니다. 사용 가능한 이벤트 목록이 제공됩니다. 마지막으로 Launch Current을 클릭합니다.

Braze Amplitude 커런츠 페이지. 이 페이지에는 통합 이름, 연락처 이메일, API 키 및 US 리전 필드가 포함되어 있습니다. 커런츠 페이지 하단에는 보낼 수 있는 커런츠 이벤트가 나열되어 있습니다.

자세한 내용은 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.FirstSession
    • users.behaviors.app.SessionEnd
    • users.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.MatchedAudience
    • users.canvas.exit.PerformedEvent
  • 실험 단계 (전환, 분할 진입)
    • users.canvas.experimentstep.Conversion
    • users.canvas.experimentstep.SplitEntry

메시지

  • 콘텐츠 카드 (중단, 클릭, 닫기, 노출, 전송)
    • users.messages.contentcard.Abort
    • users.messages.contentcard.Click
    • users.messages.contentcard.Dismiss
    • users.messages.contentcard.Impression
    • users.messages.contentcard.Send
  • 이메일 (중단, 반송, 클릭, 전달, 스팸 신고, 열기, 전송, 소프트 반송, 수신 거부)
  • 인앱 메시지 (중단, 클릭, 노출)
    • users.messages.inappmessage.Abort
    • users.messages.inappmessage.Click
    • users.messages.inappmessage.Impression
  • 푸시 알림 (중단, 반송, iOS 포그라운드, 열기, 전송)
    • users.messages.pushnotification.Abort
    • users.messages.pushnotification.Bounce
    • users.messages.pushnotification.IosForeground
    • users.messages.pushnotification.Open
    • users.messages.pushnotification.Send
  • SMS (중단, 통신사 전송, 전달, 전달 실패, 인바운드 수신, 거부, 전송, 짧은 링크 클릭)
    • users.messages.sms.Abort
    • users.messages.sms.Delivery
    • users.messages.sms.DeliveryFailure
    • users.messages.sms.InboundReceive
    • users.messages.sms.Rejection
    • users.messages.sms.Send
    • users.messages.sms.ShortLinkClick
  • 웹훅 (중단, 전송)
    • users.messages.webhook.Abort
    • users.messages.webhook.Send
  • WhatsApp (중단, 전달, 실패, 인바운드 수신, 읽음, 전송)
    • users.messages.whatsapp.Abort
    • users.messages.whatsapp.Delivery
    • users.messages.whatsapp.Failure
    • users.messages.whatsapp.InboundReceive
    • users.messages.whatsapp.Read
    • users.messages.whatsapp.Send
New Stuff!