Tealium

Tealium은 모바일, 웹, 타사 소스의 대체 데이터를 연결할 수 있는 EventStream, AudienceStream, iQ 태그 관리로 구성된 유니버설 데이터 허브이자 고객 데이터 플랫폼입니다. Braze에 Tealium을 연결하면 커스텀 이벤트, 사용자 속성, 구매 데이터의 데이터 흐름을 통해 실시간으로 데이터에 기반한 조치를 취할 수 있습니다.

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

• Braze 캠페인과 캔버스를 개인화하거나 세그먼트를 구축하는 데 사용할 수 있도록 Tealium 오디언스를 AudienceStream에서 Braze에 동기화합니다.
• 여러 플랫폼에서 데이터를 가져옵니다. Braze는 Android, iOS, 웹 애플리케이션을 위한 나란히 배치된 SDK 통합과 이벤트 데이터를 보고할 수 있는 모든 플랫폼 내에서 사용할 수 있는 서버 간 통합을 모두 제공합니다.
  
  

• eventstream
• audiencestream
• iq 태그 관리

전제 조건

요구 사항	설명
Tealium 계정	이 파트너십을 활용하려면 서버 및/또는 클라이언트 측 액세스 권한이 있는 Tealium 계정이 필요합니다.
설치된 소스 및 Tealium 소스 라이브러리	모바일 앱, 웹사이트 또는 백엔드 서버 등 Tealium으로 전송된 모든 데이터의 출처입니다. 앱, 사이트 또는 서버에 라이브러리를 설치해야만 Tealium 커넥터를 성공적으로 설정할 수 있습니다.
Braze REST 및 SDK 엔드포인트	REST 또는 SDK 엔드포인트 URL. 엔드포인트는 인스턴스의 Braze URL에 따라 달라집니다.
Braze 앱 식별자 키(나란히만 사용 가능)	앱 식별자 키. Braze 대시보드 > 설정 관리 > API 키에서 찾을 수 있습니다.
코드 버전(병렬 전용)	SDK 버전에 해당하며 major.minor 형식이어야 합니다(예: 3.0.1이 아닌 3.2). 코드 버전은 3.0 이상이어야 합니다.
REST API 키(서버 간에만 해당)	users.track 및 users.delete 권한이 있는 Braze REST API 키. Braze 대시보드 > 개발자 콘솔 > REST API 키 > 새 API 키 생성에서 생성할 수 있습니다.

통합 유형 선택

통합	세부 정보
병렬	Tealium의 SDK를 사용하여 이벤트를 Braze의 기본 호출로 변환함으로써 서버 간 통합보다 더 심층적인 기능에 액세스하고 더 포괄적으로 Braze를 사용할 수 있습니다. Braze 원격 명령을 사용하려는 경우, Tealium이 모든 Braze 메서드(예: 콘텐츠 카드)를 지원하지는 않는다는 점에 유의하세요. 해당 원격 명령을 통해 매핑되지 않은 Braze 메서드를 사용하려면 코드베이스에 기본 Braze 코드를 추가하여 메서드를 호출해야 합니다.
서버 간	Tealium에서 Braze의 REST API 엔드포인트로 데이터를 전달합니다. 인앱 메시징, 콘텐츠 카드 또는 푸시 알림과 같은 Braze UI 기능을 지원하지 않습니다. 또한 이 메서드를 통해 사용할 수 없는 기기 수준 필드와 같이 자동으로 캡처된 데이터도 존재합니다. 이 기능을 사용하려면 병렬 통합을 고려합니다.

SDK 병렬 통합

원격 명령

원격 명령은 Tealium iOS 및 Android 라이브러리의 기능으로, Tealium SDK에서 Braze 서버를 통해 Braze로 호출할 수 있습니다. Braze 원격 명령 모듈은 필요한 Braze 라이브러리를 자동으로 설치 및 빌드하고 모든 메시지 렌더링 및 분석 추적을 처리합니다. Braze 모바일 원격 명령을 사용하려면 앱에 Tealium 라이브러리가 설치되어 있어야 합니다.

Tealium은 모바일 원격 명령을 통합하는 두 가지 방법을 제공하며, 통합 유형 간에 기능 손실이 없고 기본 네이티브 코드가 동일합니다.

모바일 원격 명령 방법	장점	단점
원격 명령 태그	Tealium iQ UI를 사용하여 원격 명령으로 전송되는 매핑과 데이터를 쉽게 수정할 수 있습니다. 이를 통해 클라이언트가 앱을 업데이트할 필요 없이 앱을 이미 App Store에 등록한 후 추가 데이터나 이벤트를 서드파티 SDK로 전송할 수 있습니다.	앱의 태그 관리 모듈은 숨겨진 웹뷰를 사용하여 JavaScript를 처리합니다.
JSON 구성 파일 (권장)	JSON 메서드를 사용하면 앱에 숨겨진 웹뷰가 필요하지 않으며 메모리 사용량을 크게 줄일 수 있습니다. JSON 파일은 원격으로 호스팅하거나 고객 앱 내에서 로컬로 호스팅할 수 있습니다.	현재로서는 이를 관리할 수 있는 UI가 없기 때문에 약간의 추가 노력이 필요합니다. 참고: Tealium은 이 문제를 해결하고 iQ Tag 관리 버전과 동일한 수준의 유연성을 JSON 원격 명령에 제공할 수 있는 관리 UI를 추가하기 위해 노력하고 있습니다.

Braze 모바일 원격 명령 데이터 매핑을 사용하여 기본 사용자 속성 및 사용자 지정 속성을 설정하고 구매 및 사용자 지정 이벤트를 추적할 수 있습니다. 해당 Braze 메서드는 다음 차트를 참조하세요.

원격 명령	브레이징 방법
appendcustomarrayattribute	addToCustomAttributeArrayWithKey()
이메일 알림	setEmailNotificationSubscriptionType()
incrementcustomattribute	incrementCustomAttribute()
초기화	startWithApiKey()
logcustomevent	logCustomEvent()
로그 구매	logPurchase()
푸시 알림	setPushNotificationSubscriptionType()
removecustomattribute	setCustomAttributeWithKey()
setcustomattribute	setCustomAttributeArrayWithKey()
setcustomarrayattribute	setCustomAttributeArrayWithKey()
setlastknownlocation	setLastKnownLocationWithLatitude()
unsetcustomattribute	unsetCustomAttributeWithKey()
useralias	addAlias()
userattribute	ABKUser()
사용자 식별자	changeUser()

Braze 모바일 원격 명령 설정 방법과 지원되는 메서드의 개요에 대한 자세한 내용은 Tealium 개발자 설명서에서 확인할 수 있습니다.

• 원격 명령
• 원격 명령 태그

Braze 웹 SDK 태그

Braze 웹 SDK 태그를 사용하여 웹사이트에 Braze의 웹 SDK를 배포합니다. Tealium iQ 태그 관리를 통해 고객은 방문자 활동을 추적하기 위해 Tealium 대시보드 내에 Braze를 태그로 추가할 수 있습니다. 태그는 일반적으로 마케팅 담당자가 온라인 광고, 이메일 마케팅 및 사이트 개인화의 효과를 파악하는 데 사용합니다.

1. Tealium에서 iQ > 태그 > + 태그 추가 > Braze 웹 SDK로 이동합니다.
2. 태그 구성 대화 상자에서 API 키(Braze 앱 식별자 키), 기본 URL(Braze SDK 엔드포인트), Braze 웹 SDK 코드 버전을 입력합니다. 디버깅 목적으로 웹 콘솔에 정보를 기록하도록 로깅을 활성화할 수도 있습니다.
3. 로드 규칙 대화 상자에서 ‘모든 페이지에 로드’를 선택하거나 규칙 생성을 선택하여 사이트에서 이 태그의 인스턴스를 로드할 시기와 위치를 결정합니다.
4. 에서 데이터 매핑 대화 상자에서 매핑 생성을 선택하여 Tealium 데이터를 Braze에 매핑합니다. Braze 웹 SDK 태그의 대상 변수는 태그의 데이터 매핑 탭에 내장되어 있습니다. 다음 표에서는 사용 가능한 대상 카테고리를 나열하며 각 대상 이름을 설명합니다.
5. 마침을 선택합니다.

병렬 통합 리소스

• iOS 원격 명령: Tealium 문서, Tealium GitHub 리포지토리
• Android 원격 명령: Tealium 문서, Tealium GitHub 리포지토리
• 웹 SDK 태그: Tealium 문서

서버 간 통합

이 통합은 Tealium에서 Braze REST API로 데이터를 전달합니다.

서버 간 통합은 인앱 메시징, 콘텐츠 카드 또는 푸시 알림과 같은 Braze UI 기능을 지원하지 않습니다. 또한 이 메서드를 통해 사용할 수 없는 기기 수준 필드와 같이 자동으로 캡처된 데이터도 존재합니다.

이 데이터와 이러한 기능을 사용하려면 SDK 병렬 통합을 사용하는 것이 좋습니다.

1단계: 소스 설정

Tealium에서는 먼저 커넥터에서 가져올 유효한 데이터 소스를 설정해야 합니다.

1. Tealium의 사이드바에서 서버 측 아래의 소스 > 데이터 소스 > + 데이터 소스 추가로 이동합니다.
2. 사용 가능한 카테고리에서 원하는 플랫폼을 찾고 소스 이름을 입력합니다(필수 필드).
   
3. 이벤트 사양 옵션에서 포함할 이벤트 사양을 선택합니다. 이벤트 사양은 설치에서 추적할 이벤트 이름과 필수 속성을 식별하는 데 도움이 됩니다. 이러한 사양은 수신 이벤트에 적용됩니다.
   
   어떤 데이터가 가장 가치가 있는지, 어떤 사양이 사용 사례에 가장 적합한지 생각해 보세요. 커스텀 이벤트 사양도 사용할 수 있습니다.
   
4. 다음 대화 상자는 코드 가져오기 단계로 진행됩니다. 여기에 제공된 기본 코드와 이벤트 추적 코드는 설치 가이드 역할을 합니다. 이 지침을 팀과 공유하려면 제공된 PDF를 다운로드하세요. 완료되면 저장 후 계속을 선택합니다.
   
5. 이제 저장된 소스를 확인하고 이벤트 사양을 추가하거나 제거할 수 있습니다.
   
   세부 데이터 소스 보기에서 다음 작업을 수행할 수 있습니다.
   • 데이터 소스 키 보기 및 복사
   • 설치 지침 보기
   • 코드 받기 페이지로 돌아가기
   • 이벤트 사양 추가 또는 제거
   • 이벤트 사양과 관련된 실시간 이벤트를 보기 위해 탐색
   • 기타…
     
6. 마지막으로, 페이지 상단에 있는 저장/게시를 선택합니다. 소스를 게시하지 않으면 Braze 커넥터를 구성할 때 소스를 찾을 수 없습니다.

데이터 소스 설정 및 편집에 대한 자세한 지침은 데이터 소스를 참조하세요.

2단계: 이벤트 커넥터 만들기

커넥터는 데이터를 전송하는 데 사용되는 Tealium과 다른 공급업체 간의 통합입니다. 이러한 커넥터에는 파트너가 지원하는 API를 나타내는 작업이 포함되어 있습니다.

1. Tealium의 사이드바에서 서버 측 아래의 EventStream > 이벤트 커넥터로 이동합니다.
2. 파란색 + 커넥터 추가 버튼을 선택하여 커넥터 마켓플레이스를 살펴봅니다. 새 대화 상자가 나타나면 스포트라이트 검색을 사용하여 Braze 커넥터를 찾습니다.
3. 이 커넥터를 추가하려면 브레이즈 커넥터 타일을 클릭합니다. 클릭하면 연결 요약과 필수 정보 목록, 지원되는 작업 및 구성 지침을 볼 수 있습니다. 구성은 소스, 구성, 작업의 세 단계로 구성됩니다.

소스

소스를 구성한 후 이벤트스트림 > 이벤트 커넥터 > + 커넥터 추가 > 브레이즈 아래의 브레이즈 커넥터 페이지로 돌아갑니다.

그런 다음 방금 구축한 데이터 소스를 선택하고 이벤트 피드에서 모든 이벤트 또는 특정 이벤트 사양(변경된 값만 Braze로 전송하도록 권장되는 경로)을 선택합니다. 계속을 선택합니다.

구성

그런 다음, 페이지 하단에서 커넥터 추가를 선택합니다. 여기에서 커넥터의 이름을 지정하고 Braze API 엔드포인트와 Braze REST API 키를 제공합니다.

이전에 커넥터를 만든 적이 있다면 사용 가능한 커넥터 목록에서 기존 커넥터를 선택적으로 사용하고 연필 아이콘을 사용하여 필요에 맞게 수정하거나 휴지통 아이콘을 사용하여 삭제할 수 있습니다.

작업

그런 다음 커넥터 작업의 이름을 지정하고 구성한 매핑에 따라 데이터를 전송할 작업 유형을 선택합니다. 여기에서 Braze 속성, 이벤트 및 구매를 Tealium 속성, 이벤트 및 구매 이름에 매핑합니다.

• 사용자 추적 - 배치 및 비배치
• 사용자 삭제 - 비일괄

계속을 선택합니다.

이제 커넥터가 Tealium 홈 페이지의 커넥터 목록에 표시됩니다.

완료되면 커넥터에 대해 저장/게시하기를 선택해야 합니다. 이제 트리거 연결이 충족되면 구성한 작업이 실행됩니다.

3단계: Tealium 커넥터 테스트

커넥터를 시작 및 실행한 후에는 커넥터가 제대로 작동하는지 테스트해야 합니다. 이를 테스트하는 가장 간단한 방법은 Tealium 추적 툴을 사용하는 것입니다. 추적 사용을 시작하려면 Tealium 툴 브라우저 확장을 추가했는지 확인합니다.

1. 새 추적을 시작하려면 사이드바의 서버 측 옵션 아래에서 추적을 선택합니다. 시작을 선택하고 추적 ID를 캡처합니다.
2. 브라우저 확장을 열고 AudienceStream 추적에 추적 ID를 입력합니다.
3. 실시간 로그를 살펴봅니다.
4. 확장할 작업 트리거 항목을 선택하여 유효성을 검사하려는 작업을 확인합니다.
5. 유효성을 검사하려는 작업을 찾아 로그 상태를 확인합니다.

Tealium의 추적 툴 구현에 대한 자세한 지침은 Tealium의 추적 설명서를 참조하세요.

통합 데모

데이터 포인트 초과 가능성

Tealium을 통해 Braze를 통합할 때 실수로 데이터 초과량이 발생할 수 있는 주된 세 가지 경우가 있습니다.

중복 데이터 전송 - Braze 델타의 속성만 전송합니다.

Tealium은 사용자 속성의 Braze 델타를 전송하지 않습니다. 예를 들어, 사용자의 이름, 이메일, 휴대폰 번호를 추적하는 EventStream 작업이 있는 경우, Tealium은 작업이 트리거될 때마다 세 가지 속성을 모두 Braze로 전송합니다. Tealium은 변경되거나 업데이트된 내용을 찾지 않고 해당 정보만 전송합니다.

솔루션:
백엔드를 확인하여 속성이 변경되었는지 여부를 평가하고, 변경된 경우 Tealium의 관련 메서드를 호출하여 사용자 프로필을 업데이트할 수 있습니다. 일반적으로 Braze를 직접 통합하는 사용자가 수행합니다.
OR
백엔드에 자체 버전의 고객 프로필을 저장하지 않고 속성이 변경되었는지 여부를 알 수 없는 경우 AudienceStream을 사용할 수 있습니다. 값이 변경된 경우에만 사용자 속성을 전송하도록 보강 기능을 생성합니다. 보강 규칙은 Tealium 설명서를 참조하세요.

관련 없는 데이터를 전송하거나 불필요하게 데이터를 덮어쓰는 경우

동일한 이벤트 피드를 대상으로 하는 이벤트스트림이 여러 개 있는 경우, 해당 커넥터에 대해 활성화된 모든 액션 은 단일 액션이 트리거될 때마다 자동으로 실행되며, **이 경우 Braze에서 데이터를 덮어쓰고 불필요한 데이터 포인트를 소비할 수도 있습니다.

솔루션:
각 작업을 추적하기 위해 별도의 이벤트 사양 또는 피드를 설정하세요.
OR
실행하지 않으려는 작업 또는 커넥터는 Tealium 대시보드의 토글을 사용하여 비활성화합니다.

너무 일찍 Braze 초기화

Braze 웹 SDK 태그를 사용하여 Tealium과 통합하는 사용자는 MAU의 급격한 증가를 확인할 수도 있습니다. 페이지 로드 시 Braze가 초기화되면 웹 사용자가 웹사이트를 처음 탐색할 때마다 익명 프로필이 생성됩니다. 사용자가 ‘로그인’ 또는 ‘비디오 시청’ 등의 특정 작업을 완료했을 때만 사용자 행동을 추적하여 MAU 수를 낮출 수도 있습니다.

솔루션:
로드 규칙을 설정하여 태그가 사이트에서 로드되는 시기와 위치를 정확하게 결정합니다.