Skip to content

Segment

Segment는 고객 데이터를 수집, 정리 및 활성화하는 데 도움이 되는 고객 데이터 플랫폼입니다.

Braze와 Segment 통합을 통해 사용자를 추적하고 다양한 사용자 분석 제공업체로 데이터를 라우팅할 수 있습니다. Segment를 사용하면 다음을 수행할 수 있습니다:

필수 조건

통합

Braze와 Segment를 통합하려면 선택한 통합 유형(연결 모드)에 따라 Braze를 대상으로 설정해야 합니다. Braze를 처음 사용하는 고객이라면 Segment 리플레이를 사용하여 과거 데이터를 Braze로 전달할 수 있습니다. 다음으로 매핑을 설정하고 통합을 테스트하여 Braze와 Segment 간의 원활한 데이터 흐름을 보장해야 합니다.

1단계: Braze 대상 생성

소스를 성공적으로 설정한 후에는 각 소스(iOS, Android, 웹 등)에 대해 Braze를 대상으로 구성해야 합니다. 연결 설정을 사용하여 Braze와 Segment 간의 데이터 흐름을 커스터마이즈할 수 있는 다양한 옵션이 있습니다.

2단계: 대상 프레임워크 및 연결 유형 선택

Segment에서 Destinations > Braze > Configure Braze > Select your Source > Setup으로 이동합니다.

소스 설정 페이지. 이 페이지에는 대상 프레임워크를 'actions' 또는 'classic'으로 설정하고 연결 모드를 'cloud mode' 또는 'device mode'로 설정하는 설정이 포함되어 있습니다.

Segment의 웹 소스(Analytics.js)와 네이티브 클라이언트 측 라이브러리를 병렬(디바이스 모드) 통합 또는 서버 간(클라우드 모드) 통합을 사용하여 Braze와 통합할 수 있습니다.

연결 모드 선택은 대상이 구성된 소스 유형에 따라 결정됩니다.

병렬 SDK 통합

디바이스 모드라고도 하며, 이 통합은 Segment의 SDK와 메서드를 Braze SDK에 매핑하여 푸시, 인앱 메시징 및 Braze 네이티브 메서드 등 SDK가 제공하는 모든 기능에 접근할 수 있게 합니다.

디바이스 모드 연결을 사용할 때, Braze SDK를 네이티브로 통합하는 것과 유사하게 Braze SDK는 모든 사용자에게 device_id와 백엔드 식별자인 braze_id를 할당합니다. 이를 통해 Braze는 userId 대신 해당 식별자를 매칭하여 기기에서의 익명 활동을 캡처할 수 있습니다.

Android 소스의 디바이스 모드 대상으로 Braze를 설정하려면 Destination framework로 Actions를 선택한 다음 Save를 선택합니다.

병렬 통합을 완료하려면 Android 앱에 Braze Kotlin 대상 플러그인을 추가해야 합니다. 이 플러그인은 Segment SDK와 Braze SDK를 연결하여 디바이스 모드 데이터가 Braze로 흐를 수 있게 합니다. Segment 설치 지침에 따라 플러그인 종속성을 추가하고 Segment 분석 인스턴스로 초기화하세요.

Android 디바이스 모드 통합의 소스 코드는 Braze에서 유지 관리하며 새로운 Braze SDK 릴리스를 반영하여 정기적으로 업데이트됩니다.

iOS 소스의 디바이스 모드 대상으로 Braze를 설정하려면 Destination framework로 Actions를 선택한 다음 Save를 선택합니다.

병렬 통합을 완료하려면 iOS 앱에 Braze Swift 대상 플러그인을 추가해야 합니다. 이 플러그인은 Segment SDK와 Braze SDK를 연결하여 디바이스 모드 데이터가 Braze로 흐를 수 있게 합니다. Segment 설치 지침에 따라 플러그인 종속성(스위프트 패키지 매니저 또는 CocoaPods를 통해)을 추가하고 Segment 분석 인스턴스로 초기화하세요.

iOS 디바이스 모드 통합의 소스 코드는 Braze에서 유지 관리하며 새로운 Braze SDK 릴리스를 반영하여 정기적으로 업데이트됩니다.

Segment의 Braze Web Mode (Actions) 프레임워크는 웹 소스의 디바이스 모드 대상으로 Braze를 설정하는 데 권장됩니다.

Segment에서 대상 프레임워크로 Actions를, 연결 모드로 Device Mode를 선택합니다.

React Native Braze 플러그인의 소스 코드는 Segment에서 유지 관리하며 새로운 Braze SDK 릴리스를 반영하여 정기적으로 업데이트됩니다.

React Native Segment 소스를 Braze에 연결할 때는 운영체제별로 소스와 대상을 설정해야 합니다. 예를 들어, iOS 대상과 Android 대상을 설정합니다.

앱 코드베이스 내에서 각 앱에 연결된 해당 소스 쓰기 키를 사용하여 기기 유형별로 Segment SDK를 조건부로 초기화합니다.

기기에서 푸시 토큰이 등록되어 Braze로 전송되면 SDK 초기화 시 사용된 앱 식별자와 연결됩니다. 기기 유형 조건부 초기화는 Braze로 전송된 모든 푸시 토큰이 관련 앱과 연결되도록 확인하는 데 도움이 됩니다.

각 소스의 디바이스 모드 대상으로 Braze를 설정하려면 Destination framework로 Actions를 선택한 다음 Save를 선택합니다.

서버 간 통합

클라우드 모드라고도 하며, 이 통합은 Segment에서 Braze REST API로 데이터를 전달합니다. Segment의 Braze Cloud Mode (Actions) 프레임워크를 사용하여 모든 소스에 대한 클라우드 모드 대상을 설정합니다.

병렬 통합과 달리 서버 간 통합은 인앱 메시징, Content Cards 또는 자동 푸시 토큰 등록과 같은 Braze UI 기능을 지원하지 않습니다. 또한 클라우드 모드를 통해서는 사용할 수 없는 자동 수집 데이터(익명 사용자 및 기기 수준 필드 등)도 있습니다.

이 데이터와 기능을 사용하려면 병렬(디바이스 모드) SDK 통합을 사용하는 것을 고려하세요.

Braze Cloud Mode (Actions) 대상의 소스 코드는 Segment에서 유지 관리합니다.

3단계: 설정

대상에 대한 설정을 정의합니다. 모든 설정이 모든 대상 유형에 적용되는 것은 아닙니다.

4단계: 메서드 매핑

Braze는 Page, Identify 및 Track Segment 메서드를 지원합니다. 이러한 메서드 내에서 사용되는 식별자 유형은 데이터가 서버 간(클라우드 모드) 또는 병렬(디바이스 모드) 통합을 통해 전송되는지에 따라 달라집니다. Braze Web Mode Actions 및 Cloud Mode Actions 대상에서는 Segment alias 호출에 대한 매핑도 설정할 수 있습니다.

Cloud Mode (Actions) 대상은 별칭 전용 사용자를 생성하거나 기존 external_id 프로필에 별칭을 추가하는 데 사용할 수 있는 Create Alias 동작을 제공합니다. Identify User 동작은 Create Alias 동작과 함께 사용하여 사용자에게 external_id가 사용 가능해진 후 별칭 전용 사용자를 external_id와 병합할 수 있습니다.

또한 braze_id를 사용하여 클라우드 모드에서 익명 사용자 데이터를 전송하는 우회 방법을 구현할 수도 있습니다. 이를 위해서는 모든 Segment API 호출에 사용자의 braze_id를 수동으로 포함해야 합니다. 이 우회 방법을 설정하는 방법에 대해 자세히 알아보려면 Segment 문서를 참조하세요.

Braze로 전송되는 대상 데이터는 Cloud Mode Actions 내에서 배치 처리할 수 있습니다. 배치 크기는 75개 이벤트로 제한되며, 이러한 배치는 플러시되기 전에 30초 동안 누적됩니다. 요청 배치 처리는 동작별로 수행됩니다. 예를 들어, Identify 호출(속성)은 하나의 요청으로 배치 처리되고 Track 호출(커스텀 이벤트)은 두 번째 요청으로 배치 처리됩니다. Braze는 이 기능을 활성화하는 것을 권장합니다. 이렇게 하면 Segment에서 Braze로 전송되는 요청 수가 줄어듭니다. 결과적으로 대상이 Braze 사용량 제한에 도달하여 요청을 재시도하는 위험이 줄어듭니다.

Braze 대상 > Mappings로 이동하여 동작에 대한 배치 처리를 활성화할 수 있습니다. 거기에서 매핑 오른쪽의 점 3개 아이콘을 클릭하고 Edit Mapping을 선택합니다. Select mappings 섹션 하단으로 스크롤하여 Batch Data to Braze가 Yes로 설정되어 있는지 확인합니다.

Identify

Identify 호출을 사용하면 사용자를 해당 동작에 연결하고 사용자에 대한 속성을 기록할 수 있습니다.

특정 Segment 특수 트레이트는 Braze의 표준 속성 프로필 필드에 매핑됩니다:

email_subscribe 및 push_subscribe와 같은 기타 예약된 Braze 프로필 필드는 이러한 필드에 대한 Braze 명명 규칙을 사용하고 identify 호출 내에서 트레이트로 전달하여 전송할 수 있습니다.

구독 그룹에 사용자 추가

트레이트 매개변수에서 다음 필드를 사용하여 지정된 구독 그룹에서 사용자를 구독하거나 구독 취소할 수도 있습니다.

오브젝트 배열과 연결할 수 있는 braze_subscription_groups라는 예약된 Braze 프로필 필드를 사용합니다. 배열의 각 오브젝트에는 두 개의 예약된 키가 있어야 합니다:

  1. subscription_group_state: 사용자가 특정 구독 그룹에 "subscribed" 또는 "unsubscribed" 상태인지를 나타냅니다.
  2. subscription_group_id: 구독 그룹의 고유 ID를 나타냅니다. 이 ID는 Braze 대시보드의 구독 그룹 관리에서 찾을 수 있습니다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

analytics.identify(
  userId: "{your-user}",
  traits: [
    "braze_subscription_groups": [
      [
        "subscription_group_id": "{your-group-id}",
        "subscription_group_state": "subscribed"
      ],
      [
        "subscription_group_id", "{your-group-id}",
        "subscription_group_state": "unsubscribed"
      ]
    ]
  ]
)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

analytics.identify(
  "{your-user}",
  buildJsonObject {
    put("braze_subscription_groups", buildJsonArray {
        add(
          buildJsonObject {
            put("subscription_group_id", "{your-group-id}")
            put("subscription_group_state", "subscribed")
          }
        )
        add(
          buildJsonObject {
            put("subscription_group_id", "{your-group-id}")
            put("subscription_group_state", "unsubscribed")
          }
        )
      }
    )
  }
)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

analytics.identify(
  "{your-user}",
  {
    braze_subscription_groups: [
      {
        subscription_group_id: "{your-group-id}",
        subscription_group_state: "subscribed"
      },
      {
        subscription_group_id: "{your-group-id}",
        subscription_group_state: "unsubscribed"
      }
    ]
  }
)
커스텀 속성

다른 모든 트레이트는 커스텀 속성으로 기록됩니다.

Web Mode Actions 및 Cloud Mode Actions 대상에서 위의 매핑은 Update User Profile 동작을 사용하여 설정할 수 있습니다.

Track

이벤트를 추적하면 제공된 이름을 사용하여 해당 이벤트를 커스텀 이벤트로 기록합니다.

Track 호출의 속성 오브젝트 내에서 전송된 메타데이터는 연결된 이벤트의 커스텀 이벤트 속성정보로 Braze에 기록됩니다. 모든 커스텀 이벤트 속성정보 데이터 유형이 지원됩니다.

Web Mode Actions 및 Cloud Mode Actions 대상에서 위의 매핑은 Track Event 동작을 사용하여 설정할 수 있습니다.

주문 완료

Segment의 eCommerce API에 설명된 형식을 사용하여 Order Completed라는 이름의 이벤트를 추적하면 나열한 제품을 구매로 기록합니다.

Web Mode Actions 및 Cloud Mode Actions 대상에서 기본 매핑은 Track Purchase 동작을 통해 커스터마이즈할 수 있습니다.

Page

Page 호출을 사용하면 사용자가 웹사이트의 페이지를 볼 때마다 페이지에 대한 선택적 속성과 함께 기록할 수 있습니다.

이 이벤트 유형은 Web Mode Actions 및 Cloud Actions 대상에서 Braze에 커스텀 이벤트를 기록하는 트리거로 사용할 수 있습니다.

5단계: 통합 테스트

병렬(디바이스 모드) 통합을 사용할 때 개요 측정기준(전체 세션, MAU, DAU, 사용자 고착도, 일일 세션 및 MAU당 일일 세션)을 사용하여 Braze가 Segment에서 데이터를 수신하고 있는지 확인할 수 있습니다.

커스텀 이벤트 또는 매출 페이지에서 데이터를 확인하거나 Segment를 생성하여 확인할 수 있습니다. 대시보드의 커스텀 이벤트 페이지에서 시간에 따른 커스텀 이벤트 수를 확인할 수 있습니다. 서버 간(클라우드 모드) 통합을 사용할 때는 MAU 및 DAU 통계를 포함하는 수식을 사용할 수 없습니다.

구매 데이터를 Braze로 전송하는 경우(3단계의 Track 탭에서 주문 완료 참조), 매출 페이지에서 특정 기간의 매출 또는 구매 데이터 또는 앱의 총 매출을 확인할 수 있습니다.

Segment를 생성하면 커스텀 이벤트 및 속성 데이터를 기반으로 사용자를 필터링할 수 있습니다.

사용자 삭제 및 억제

사용자를 삭제하거나 억제해야 하는 경우, Segment의 사용자 삭제 기능이 Braze /users/delete 엔드포인트에 매핑되어 있다는 점에 유의하세요. 이러한 삭제의 확인에는 최대 30일이 소요될 수 있습니다.

Braze와 Segment 간에 공통 사용자 식별자(예: external_id)를 선택해야 합니다. Segment에서 삭제 요청을 시작한 후 Segment 대시보드의 삭제 요청 탭에서 상태를 확인할 수 있습니다.

Segment 리플레이

Segment는 모든 과거 데이터를 새로운 기술 파트너에게 “리플레이”하는 서비스를 고객에게 제공합니다. 모든 관련 과거 데이터를 가져오려는 새로운 Braze 고객은 Segment를 통해 이를 수행할 수 있습니다. 관심이 있으시면 Segment 담당자에게 문의하세요.

Segment는 /users/track 엔드포인트에 연결하여 사용자를 대신하여 Braze로 사용자 데이터를 가져옵니다.

모범 사례

데이터 초과를 방지하기 위해 사용 사례를 검토하세요.

Segment는 고객이 전송하는 데이터 요소의 수를 제한하지 않습니다. Segment를 사용하면 모든 이벤트를 전송하거나 Braze에 전송할 이벤트를 결정할 수 있습니다. Segment를 사용하여 모든 이벤트를 전송하는 대신, 마케팅 및 편집 팀과 함께 사용 사례를 검토하여 데이터 초과를 방지하기 위해 Braze에 전송할 이벤트를 결정하는 것이 좋습니다.

모바일 디바이스 모드 대상 설정에서 커스텀 API 엔드포인트와 커스텀 REST API 엔드포인트의 차이점을 이해하세요.

Braze API 엔드포인트(Segment에서 “커스텀 API 엔드포인트”라고 함)는 Braze가 SDK에 대해 설정하는 SDK 엔드포인트입니다(예: sdk.iad-03.braze.com). Braze REST API 엔드포인트(Segment에서 “커스텀 REST API 엔드포인트”라고 함)는 REST API 엔드포인트입니다(예: https://rest.iad-03.braze.com).

커스텀 API 엔드포인트가 모바일 디바이스 모드 대상 설정에 올바르게 입력되었는지 확인하세요.

Braze SDK 엔드포인트를 올바르게 입력하려면 적절한 형식을 따라야 합니다. Braze SDK 엔드포인트에는 https://가 포함되어서는 안 됩니다(예: sdk.iad-03.braze.com). 그렇지 않으면 Braze 통합이 중단됩니다. 이는 Segment가 자동으로 엔드포인트 앞에 https://를 추가하여 Braze가 잘못된 엔드포인트 https://https://sdk.iad-03.braze.com으로 초기화되기 때문입니다.

데이터 매핑 뉘앙스.

데이터가 예상대로 전달되지 않는 시나리오:

  1. 중첩 커스텀 속성
    • 중첩 커스텀 속성은 기술적으로 Segment를 통해 Braze로 전송할 수 있지만, 매번 전체 페이로드가 전송됩니다. 이로 인해 페이로드가 전송될 때마다 중첩 오브젝트에 전달된 키당 데이터 포인트가 발생합니다.

      페이로드 전송 시 데이터 포인트의 일부만 사용하려면 Segment가 소유한 커스텀 대상 함수 기능을 사용할 수 있습니다. Segment 플랫폼의 이 기능을 사용하면 다운스트림 대상으로 데이터가 전송되는 방식을 커스터마이즈할 수 있습니다.
  1. 서버 간 익명 데이터 전달.
    • 고객은 Segment의 서버 간 라이브러리를 사용하여 익명 데이터를 다른 시스템으로 전달할 수 있습니다. 서버 간(클라우드 모드) 통합을 통해 external_id 없이 사용자를 Braze로 전송하는 방법에 대해 자세히 알아보려면 메서드 매핑 섹션을 참조하세요.
Braze 초기화 커스터마이즈.

Braze를 커스터마이즈할 수 있는 여러 가지 방법이 있습니다: 푸시, 인앱 메시지, Content Cards 및 초기화. 병렬 통합을 사용하면 직접 Braze 통합과 마찬가지로 푸시, 인앱 메시지 및 Content Cards를 커스터마이즈할 수 있습니다.

그러나 Braze SDK가 통합되는 시점을 커스터마이즈하거나 초기화 구성을 지정하는 것은 어렵고 때로는 불가능할 수 있습니다. 이는 Segment 초기화가 발생할 때 Segment가 Braze SDK를 초기화하기 때문입니다.

Braze로 델타 전송.

사용자 속성 데이터를 전달할 때 마지막 업데이트 이후 변경된 속성 값만 전달하는지 확인하세요. 이렇게 하면 불필요한 데이터 포인트가 기록되는 것을 방지할 수 있습니다. 클라이언트 측 소스의 경우 Segment의 오픈 소스 Middleware 도구를 사용하여 Segment에서 중복 identify() 호출을 디바운싱하여 통합을 최적화하고 데이터 포인트 사용량을 제한하세요.

올바른 Braze 데이터 센터를 사용하세요.

Segment는 Braze 데이터 센터를 사용하여 서버 간 호출을 위한 적절한 Braze REST 엔드포인트(예: https://rest.iad-01.braze.com)를 가져옵니다.

Segment의 이벤트 테스터를 사용할 때 커스텀 REST API 엔드포인트를 제거하세요.

Segment의 이벤트 테스터는 Braze /users/track REST API 엔드포인트로 이벤트를 전송하며, Braze 대상 설정에 커스텀 REST API 엔드포인트가 설정되어 있으면 해당 엔드포인트가 올바르더라도 401 Invalid API Key 오류를 발생시킵니다. 이벤트 테스터가 올바르게 작동하도록 하려면 Segment에서 커스텀 REST API 엔드포인트 값을 제거하세요.

새 소스를 구성한 후 업데이트에 시간을 허용하세요.

Segment는 구성 설정을 오랫동안 캐시에 보관하므로 새 소스를 구성할 때(예: 클라우드에서 디바이스 모드로 전환) 캐시가 갱신될 때까지 앱에 새로운 동작이나 데이터가 표시되지 않을 수 있습니다. 소스를 추가할 때 이 지연을 염두에 두세요.
New Stuff!