Tealium AudienceStream
Tealium AudienceStream은 옴니채널 고객 세분화 및 실시간 동작 엔진입니다. AudienceStream은 EventStream으로 유입되는 데이터를 가져와 브랜드에 대한 고객 참여의 가장 중요한 속성을 나타내는 방문자 프로필을 생성합니다.
Braze와 Tealium 통합은 AudienceStream 방문자 프로필을 활용합니다. 공유된 행동은 이러한 프로필을 세분화하여 공통 특성을 가진 방문자 집합(오디언스)을 생성합니다. 이러한 오디언스는 커넥터를 통해 실시간으로 마케팅 기술 스택을 지원할 수 있습니다.
Tealium AudienceStream과 EventStream은 배치 및 비배치 커넥터 동작을 모두 제공합니다. 비배치 커넥터는 실시간 요청이 사용 사례에 중요하고 Braze API 사용량 제한 사양에 도달하는 것에 대한 우려가 없을 때 사용해야 합니다. 질문이 있으시면 Braze 고객지원 또는 고객 성공 매니저에게 문의하세요.
필수 조건
| 이름 | 설명 |
|---|---|
| Tealium 계정 | 서버 측 액세스가 가능한 Tealium 계정이 필요합니다. 이 파트너십을 최대한 활용하려면 클라이언트 측 통합도 사용하는 것을 권장합니다. |
| REST API 키 | users.track, users.delete, subscription.status.set 권한이 있는 Braze REST API 키.Braze 대시보드 > 개발자 콘솔 > REST API 키 > 새 API 키 생성에서 생성할 수 있습니다. |
| Braze REST 엔드포인트 | REST 엔드포인트 URL. 엔드포인트는 인스턴스의 Braze URL에 따라 달라집니다. |
통합
1단계: 속성 및 배지 설정
속성 이해하기
AudienceStream을 사용하는 첫 번째 단계는 속성을 생성하는 것입니다. 속성을 사용하면 방문자의 습관, 선호도, 행동 및 브랜드에 대한 참여를 나타내는 중요한 특성을 정의할 수 있습니다.
방문 속성: 방문 속성은 사용자의 현재 방문(또는 세션)과 관련됩니다. 이러한 속성에 저장된 데이터는 방문 기간 동안 유지됩니다. 방문 속성의 예시는 다음과 같습니다:
- 방문 시간 (숫자)
- 현재 브라우저 (문자열)
- 현재 기기 (문자열)
- 페이지 조회 수 (숫자)
방문자 속성: 방문자 속성은 현재 사용자와 관련됩니다. 이러한 속성에 저장된 데이터는 사용자의 수명 동안 유지됩니다. 방문자 속성의 예시는 다음과 같습니다:
- 평생 주문 금액 (숫자)
- 이름 (문자열)
- 생년월일 (날짜)
- 구매 브랜드 (집계)
사용 가능한 데이터 유형의 전체 목록은 Tealium을 참조하세요.
속성 보강
원하는 속성을 식별한 후에는 보강 - 속성 값을 언제, 어떻게 업데이트할지 결정하는 비즈니스 규칙으로 구성할 수 있습니다. 각 데이터 유형은 속성 값을 조작하기 위한 자체 보강 선택 항목을 제공합니다. 이는 “WHEN” 설정과 연결됩니다. 각 방문 및 방문자 속성에 대해 다음 옵션을 사용할 수 있습니다:
- New Visitor: 방문자가 처음으로 사이트를 방문할 때 발생합니다.
- New Visit: 방문자의 새 방문 시 발생합니다.
- Any Event: 모든 이벤트에서 발생합니다.
- Visit Ended: 방문이 종료될 때 발생합니다.
보강이 발생하는 시점을 결정하는 규칙이라는 커스텀 조건을 생성할 수도 있습니다.
배지
배지는 가치 있는 행동 패턴을 나타내는 특수 방문자 속성입니다. 배지는 보강 로직에 따라 방문자에게 할당되거나 제거됩니다. 이 로직은 일반적으로 방문자 세그먼트를 캡처하기 위해 여러 조건을 결합하거나 특정 값에 도달했을 때의 임계값을 설정합니다.
속성 및 배지 예시
고객이 완료한 모든 주문(구매 이벤트)에 대해 누적 지출 금액(order_total)을 계산하는 방문자 속성 “Lifetime Order Value”를 생성합니다. Tealium 계정에서 평생 주문 금액을 설정하려면 다음 지침을 따르세요:
- AudienceStream > Visitor/Visit Attributes로 이동하여 Add Attribute를 클릭합니다.
- 범위를 Visitor로 선택하고 Continue를 클릭합니다.
- 데이터 유형 Number를 선택하고 Continue를 클릭합니다.
- 속성 이름 “Lifetime Order Value”를 입력합니다.
- Add Enrichment를 클릭하고 Increment or Decrement Number를 선택합니다.
- 증가시킬 값이 포함된 속성(
order_total)을 선택합니다. - “WHEN”을 “Any Event”로 두고 Create a New Rule을 클릭합니다.
- 구매 이벤트가 발생했을 때를 식별하는 규칙을 생성합니다.
- Save를 클릭한 다음 Finish를 클릭합니다.
이제 모든 고객에게 평생 주문 금액 속성이 연결됩니다.
공유하는 특정 속성에 따라 사용자를 분류하고 타겟팅하는 데 도움이 되는 배지를 생성할 수 있습니다. 다음 예시에서는 “Lifetime Order Value”가 $500 이상인 사용자를 위한 VIP 배지를 생성합니다.
- AudienceStream > Visitor/Visit Attributes로 이동하여 Add Attribute를 클릭합니다.
- 범위를 Visitor로 선택하고 Continue를 클릭합니다.
- 데이터 유형 Badge를 선택하고 Continue를 클릭합니다.
- 배지 이름 “VIP”를 입력합니다.
- Add Enrichment를 클릭하고 Assign Badge를 선택합니다.
- “WHEN”을 “Any Event”로 둡니다.
- Create Rule을 선택하여 배지 할당 규칙을 생성합니다. 이 규칙에 제목을 지정하고, 이전에 생성한 속성을 사용하여 규칙을 “…has attribute “Lifetime Order Value greater than 500”으로 설정합니다.
- Save를 클릭한 다음 Finish를 클릭합니다.
2단계: 오디언스 생성
Tealium 홈 페이지에서 사이드바 내비게이션의 AudienceStream 아래에서 Audiences를 선택합니다. 여기에서 공통 속성을 가진 사용자의 오디언스를 생성할 수 있습니다. 이 오디언스에 대한 사용자의 진입 또는 이탈은 다음 단계에서 설정하는 커넥터 동작의 트리거가 되며, 이 정보를 Braze의 고객 프로필로 전달합니다.
먼저 오디언스의 이름을 지정한 다음, 생성하려는 오디언스 유형에 적용할 속성을 고려합니다. 예를 들어, VIP 사용자의 오디언스를 생성하려면 VIP 배지를 가진 방문자의 오디언스를 생성할 수 있습니다.
완료되면 오디언스를 Save / Publish하세요.
3단계: 이벤트 커넥터 생성
커넥터는 데이터를 전송하는 데 사용되는 Tealium과 다른 벤더 간의 통합입니다. 이러한 커넥터에는 파트너가 지원하는 API를 나타내는 동작이 포함되어 있습니다.
- Tealium의 사이드바에서 Server-Side 아래의 AudienceStream > Audience Connectors로 이동합니다.
- 파란색 + Add Connector 버튼을 선택하여 커넥터 마켓플레이스를 탐색합니다. 나타나는 새 대화 상자에서 스포트라이트 검색을 사용하여 Braze 커넥터를 찾습니다.
- 이 커넥터를 추가하려면 Braze 커넥터 타일을 클릭합니다. 클릭하면 연결 요약과 필수 정보, 지원되는 동작 및 구성 지침 목록을 볼 수 있습니다. 구성은 소스, 구성, 동작의 세 단계로 구성됩니다.
소스
나타나는 Source 대화 상자에서 이전 단계에서 생성한 오디언스와 상황에 적합하다고 생각되는 트리거를 선택합니다. 빈도 제한을 토글하여 이 동작이 트리거되는 빈도를 제어할 수도 있습니다.
구성
다음으로 Configuration 대화 상자가 나타납니다. 페이지 하단에서 Add Connector를 선택합니다. 커넥터 이름을 지정하고 여기에 Braze API 엔드포인트와 Braze REST API 키를 입력합니다.
이전에 커넥터를 생성한 적이 있다면 사용 가능한 커넥터 목록에서 기존 커넥터를 선택적으로 사용하고 연필 아이콘으로 수정하거나 휴지통 아이콘으로 삭제할 수 있습니다.
이 오디언스를 연결할 커넥터를 생성하거나 선택한 후 Done을 클릭하여 계속합니다.
동작
다음으로 커넥터 동작의 이름을 지정하고 구성한 매핑에 따라 데이터를 전송할 동작 유형을 선택합니다. 여기에서 Braze 속성을 Tealium 속성 이름에 매핑합니다. 선택한 동작 유형에 따라 Tealium에서 요구하는 필드 선택이 달라집니다. 다음은 이러한 필드의 예시와 설명입니다.
제공되는 모든 필드가 필수는 아닙니다.
이 동작을 사용하면 사용자, 이벤트 및 구매 속성을 하나의 동작으로 추적할 수 있습니다. Track User 동작은 AudienceStream과 EventStream 모두에서 동일하지만, Tealium은 AudienceStream 동작으로 사용자 속성 매핑을 설정하고 EventStream 동작으로 이벤트 및 구매 매핑을 설정할 것을 권장합니다.
| 매개변수 | 설명 |
|---|---|
| 사용자 ID | 이 필드를 사용하여 Tealium 사용자 ID 필드를 Braze에 해당하는 필드에 매핑합니다. 하나 이상의 사용자 ID 속성을 매핑합니다. 여러 ID가 지정된 경우 다음 우선순위에 따라 첫 번째 비어 있지 않은 값이 선택됩니다: 외부 ID, Braze ID, 별칭 이름, 별칭 라벨. - 푸시 토큰을 가져오는 경우 외부 ID와 Braze ID를 지정하면 안 됩니다. - 사용자 별칭을 지정하는 경우 별칭 이름과 별칭 라벨을 설정해야 합니다. 자세한 내용은 Braze /users/track 엔드포인트를 확인하세요. |
| 사용자 속성 | 기존 Braze 고객 프로필 필드 이름을 사용하여 Braze 대시보드에서 고객 프로필 값을 업데이트하거나 고객 프로필에 자체 커스텀 사용자 속성 데이터를 추가합니다. - 기본적으로 존재하지 않는 경우 새 사용자가 생성됩니다. - Update Existing Only를 true로 설정하면 기존 사용자만 업데이트되며 새 사용자는 생성되지 않습니다.- Tealium 속성이 비어 있으면 null로 변환되어 Braze 고객 프로필에서 제거됩니다. 사용자 속성을 제거하기 위해 null 값을 Braze에 보내지 않으려면 보강을 사용해야 합니다. |
| 사용자 속성 수정 | 이 필드를 사용하여 특정 사용자 속성을 증가 또는 감소시킵니다. - 정수 속성은 양의 정수 또는 음의 정수로 증가시킬 수 있습니다. - 배열 속성은 기존 배열에서 값을 추가하거나 제거하여 수정할 수 있습니다. |
| 이벤트 | 이벤트는 특정 사용자가 특정 타임스탬프에 수행한 커스텀 이벤트의 단일 발생을 나타냅니다. 이 필드를 사용하여 Braze 이벤트 오브젝트와 같은 이벤트 속성을 추적하고 매핑합니다. - 이벤트 속성 Name은 매핑된 모든 이벤트에 필수입니다.- 이벤트 속성 Time은 명시적으로 매핑되지 않는 한 자동으로 현재 시간으로 설정됩니다. - 기본적으로 존재하지 않는 경우 새 이벤트가 생성됩니다. Update Existing Only를 true로 설정하면 기존 이벤트만 업데이트되며 새 이벤트는 생성되지 않습니다.- 배열 유형 속성을 매핑하여 여러 이벤트를 추가합니다. 배열 유형 속성은 동일한 길이여야 합니다. - 단일 값 속성을 사용할 수 있으며 각 이벤트에 적용됩니다. |
| 이벤트 템플릿 | 본문 데이터에서 참조할 이벤트 템플릿을 제공합니다. 템플릿을 사용하여 Braze로 보내기 전에 데이터를 변환할 수 있습니다. 자세한 내용은 Tealium의 템플릿 가이드를 참조하세요. |
| 이벤트 템플릿 변수 | 이벤트 템플릿 변수를 데이터 입력으로 제공합니다. 자세한 내용은 Tealium의 템플릿 변수 가이드를 참조하세요. |
| 구매 | 이 필드를 사용하여 Braze 구매 오브젝트와 같은 사용자 구매 속성을 추적하고 매핑합니다. - 구매 속성 Product ID, Currency, Price는 매핑된 모든 구매에 필수입니다.- 구매 속성 Time은 명시적으로 매핑되지 않는 한 자동으로 현재 시간으로 설정됩니다.- 기본적으로 존재하지 않는 경우 새 구매가 생성됩니다. Update Existing Only를 true로 설정하면 기존 구매만 업데이트되며 새 구매는 생성되지 않습니다.- 배열 유형 속성을 매핑하여 여러 구매 항목을 추가합니다. 배열 유형 속성은 동일한 길이여야 합니다. - 단일 값 속성을 사용할 수 있으며 각 항목에 적용됩니다. |
| 구매 템플릿 | 템플릿을 사용하여 Braze로 보내기 전에 데이터를 변환할 수 있습니다. - 중첩된 오브젝트 지원이 필요한 경우 구매 템플릿을 정의합니다. - 구매 템플릿이 정의되면 동작의 구매 섹션에서 설정한 구성은 무시됩니다. - 자세한 내용은 Tealium의 템플릿 가이드를 참조하세요. |
| 구매 템플릿 변수 | 제품 템플릿 변수를 데이터 입력으로 제공합니다. 자세한 내용은 Tealium의 템플릿 변수 가이드를 참조하세요. |
이 동작을 사용하면 Braze 대시보드에서 사용자를 삭제할 수 있습니다.
| 매개변수 | 설명 |
|---|---|
| 사용자 ID | 이 필드를 사용하여 Tealium 사용자 ID 필드를 Braze에 해당하는 필드에 매핑합니다. - 하나 이상의 사용자 ID 속성을 매핑합니다. 여러 ID가 지정된 경우 다음 우선순위에 따라 첫 번째 비어 있지 않은 값이 선택됩니다: 외부 ID, Braze ID, 별칭 이름, 별칭 라벨. - 사용자 별칭을 지정하는 경우 별칭 이름과 별칭 라벨을 모두 설정해야 합니다. 자세한 내용은 Braze /users/delete 엔드포인트를 참조하세요. |
이 동작을 사용하면 Braze SMS 또는 이메일 구독 그룹에서 사용자를 추가하거나 제거할 수 있습니다.
| 매개변수 | 설명 |
|---|---|
| 그룹 유형 | 이 필드를 사용하여 SMS 또는 이메일 구독 그룹인지 표시합니다. |
| 업데이트 유형 | 이 동작을 구독 취소 또는 구독 이벤트에 매핑합니다. |
| 속성 | - 구독 그룹 ID (필수): 앞의 필드에서 매핑된 그룹 유형과 관련된 구독 그룹의 ID입니다. - 외부 ID: 사용자의 외부 ID입니다. 이메일 그룹 전용: - 이메일: 사용자의 이메일 주소입니다. 외부 ID가 정의되지 않은 경우 이메일이 필수입니다. SMS 그룹 전용: - 전화번호: E.164 형식의 전화번호입니다. 예: +14155552671. 외부 ID가 정의되지 않은 경우 전화번호가 필수입니다. |
Finish를 선택합니다.
요약
생성한 커넥터의 요약을 확인합니다. 선택한 옵션을 수정하려면 Back을 선택하여 편집하거나 Finish를 선택하여 완료합니다.
이제 커넥터가 Tealium 홈 페이지의 커넥터 목록에 표시됩니다.
완료되면 커넥터를 저장하거나 게시하세요. 구성한 동작은 트리거 연결 조건이 충족되면 실행됩니다.
4단계: Tealium 커넥터 테스트
커넥터가 실행된 후에는 제대로 작동하는지 테스트해야 합니다. 가장 간단한 테스트 방법은 Tealium Trace Tool을 사용하는 것입니다. Trace를 사용하려면 Tealium Tools 브라우저 확장 프로그램을 추가했는지 확인하세요.
- 새 추적을 시작하려면 Server-Side 옵션 아래의 사이드바에서 Trace를 선택합니다. Start를 클릭하고 Trace ID를 캡처합니다.
- 브라우저 확장 프로그램을 열고 AudienceStream Trace에 Trace ID를 입력합니다.
- 실시간 로그를 확인합니다.
- 검증하려는 동작을 Actions Triggered 항목을 클릭하여 확장합니다.
- 검증하려는 동작을 찾고 로그 상태를 확인합니다.
Tealium의 Trace 도구 구현에 대한 자세한 지침은 Tealium의 Trace 설명서를 참조하세요.
통합 데모
잠재적 데이터 포인트 초과
Tealium을 통해 Braze를 통합할 때 실수로 데이터 초과가 발생할 수 있는 세 가지 주요 방법이 있습니다:
중복 데이터 전송 - 속성의 Braze 델타만 전송하세요
Tealium은 사용자 속성의 Braze 델타를 전송하지 않습니다. 예를 들어, 사용자의 이름, 이메일, 휴대폰 번호를 추적하는 EventStream 동작이 있는 경우, Tealium은 동작이 트리거될 때마다 세 가지 속성을 모두 Braze에 전송합니다. Tealium은 변경되거나 업데이트된 내용을 확인하고 해당 정보만 전송하지 않습니다.
해결 방법:
백엔드를 확인하여 속성이 변경되었는지 평가하고, 변경된 경우 Tealium의 관련 메서드를 호출하여 고객 프로필을 업데이트할 수 있습니다. 이것은 Braze를 직접 통합하는 사용자가 일반적으로 수행하는 방법입니다.
또는
백엔드에 자체 고객 프로필 버전을 저장하지 않아 속성이 변경되었는지 알 수 없는 경우, AudienceStream을 사용하고 보강을 생성하여 값이 변경된 경우에만 사용자 속성을 전송할 수 있습니다.
관련 없는 데이터 전송 또는 불필요한 데이터 덮어쓰기
동일한 이벤트 피드를 대상으로 하는 여러 EventStream이 있는 경우, 해당 커넥터에 대해 활성화된 모든 동작은 단일 동작이 트리거될 때마다 자동으로 실행되며, 이로 인해 Braze에서 데이터가 덮어쓰여질 수도 있습니다.
해결 방법:
각 동작을 추적하기 위해 별도의 이벤트 사양 또는 피드를 설정합니다.
또는
Tealium 대시보드의 토글을 사용하여 실행하지 않으려는 동작(또는 커넥터)을 비활성화합니다.
Braze를 너무 일찍 초기화
Braze Web SDK 태그를 사용하여 Tealium과 통합하는 경우 MAU가 급격히 증가하는 것을 볼 수 있습니다. Braze가 페이지 로드 시 초기화되면, 웹 사용자가 처음으로 웹사이트를 방문할 때마다 Braze가 익명 프로필을 생성합니다. 이에는 봇 트래픽도 포함되어 활성 사용자 수가 부풀려질 수 있습니다. 일부 사용자는 MAU 수를 줄이기 위해 “로그인” 또는 “동영상 시청”과 같은 특정 동작을 완료한 경우에만 사용자 행동을 추적하고 싶을 수 있습니다.
해결 방법:
로드 규칙을 설정하여 사이트에서 태그가 로드되는 시기와 위치를 정확히 결정합니다. 봇 트래픽 필터링 및 조건부 SDK 초기화에 대한 보다 포괄적인 안내는 봇 트래픽 필터링을 참조하세요.