Talkable
Talkable은 소비자 브랜드가 만족한 고객을 확장 가능한 추천 채널로 전환할 수 있도록 지원합니다. Braze 통합을 통해 Talkable 추천 캠페인에서 수집된 마케팅 이메일 옵트인이 실시간으로 Braze에 전달되므로, 팀은 모든 새로운 추천인과 친구를 환영하고, 세분화하고, 참여시키는 데 필요한 동의, 컨텍스트, 캠페인 데이터를 확보할 수 있습니다.
이 통합은 Talkable에서 유지 관리합니다.
통합 정보
Talkable은 Braze가 구동하는 고객 여정에 추천인 주도의 고객 확보를 도입합니다. 이 통합은 Talkable이 캡처하는 모든 추천 옵트인을 실시간으로 일치하는 Braze 프로필로 전달하므로, 수동 목록 내보내기나 배치 동기화 없이도 신뢰할 수 있는 동의 및 추천 컨텍스트를 기반으로 환영 플로우, 추천 여정, 세분화, 라이프사이클 메시징을 시작할 수 있습니다.
Talkable은 두 가지 시나리오에서 마케팅 옵트인을 캡처합니다:
- 추천인 가입: 추천인이 Talkable 추천 Campaign에 가입하고 마케팅 이메일 수신에 동의합니다.
- 친구 이메일 게이팅: 친구가 Talkable의 이메일 게이팅 단계를 완료하고 마케팅 이메일에 옵트인합니다.
두 경우 모두 Talkable은 일치하는 Braze 사용자 프로필을 실시간으로 생성하거나 업데이트하고, 사용자의 이메일 구독 상태를 Opted In으로 설정합니다.
기본 동작
Talkable은 Talkable에서 명시적으로 동의한 사용자의 개별 옵트인 이벤트가 발생할 때만 Braze로 데이터를 전송합니다. 이는 추천인이 Campaign에 가입하거나 친구가 이메일 게이팅 중 옵트인하는 경우에 해당합니다. Talkable은 야간 배치, 전체 동기화 또는 암묵적 프로필 업데이트를 실행하지 않습니다. Talkable은 옵트인하지 않은 프로필을 Braze로 전송하지 않습니다.
사용 사례
- 옹호자가 Talkable 추천 Campaign에 가입하는 순간 Braze 환영 Canvas를 트리거합니다.
- 친구가 옵트인하는 즉시 친구 전용 Canvas와 개인화된 첫 구매 오퍼를 통해 추천받은 친구를 활성화합니다.
- Braze 커스텀 속성으로 전송된 옹호자 및 친구 플래그와 Campaign 메타데이터를 사용하여 추천 컨텍스트별로 세분화합니다.
- 규정을 준수하는 뉴스레터 발송을 위해 추천 옵트인을 지정된 Braze 구독 그룹으로 라우팅합니다.
사전 요구 사항
시작하기 전에 다음이 필요합니다:
| 사전 요구 사항 | 설명 |
|---|---|
| Talkable 계정 | 이 파트너십을 활용하려면 최소 하나의 캠페인이 구성된 Talkable 사이트가 필요합니다. |
| Braze REST API 키 | users.track 권한이 있는 Braze REST API 키. Braze 대시보드에서 설정 > API 키로 이동하여 이 키를 생성하세요. 자세한 내용은 REST API 키 생성을 참조하세요. |
| Braze REST 엔드포인트 | Braze REST 엔드포인트 URL(예: https://rest.iad-01.braze.com). US(.com) 및 EU(.eu) Braze 클러스터가 모두 지원됩니다. 자세한 내용은 REST API 엔드포인트를 참조하세요. |
통합
1단계: Talkable에 Braze 앱 설치
- Talkable 관리자 계정에 로그인하고 메뉴를 연 다음, All Site Settings > App Store로 이동합니다.
- Braze를 찾아 Install을 선택합니다.
- Braze REST 엔드포인트와
users.track권한이 있는 REST API 키를 입력한 다음 Save를 선택합니다.
2단계: 이메일 옵트인 액션 구성
- Talkable Braze 앱에서 Email opt-in 액션을 엽니다.
- (선택 사항) Braze 구독 그룹 식별자를 입력하고, 커스텀 속성을 추가하거나, 사용자 별칭을 구성합니다. 자세한 내용은 Talkable 커스터마이징을 참조하세요.
- Save를 선택합니다. 실시간 옵트인 이벤트가 동기화되기 전에 테스트 페이로드로 구성을 확인할 수 있도록 액션을 비활성화 상태로 둡니다.
3단계: 샘플 페이로드로 테스트
- Talkable에서 Email opt-in 액션의 Send sample payload를 선택하여 Braze에 테스트 요청을 보냅니다.
- Braze에서 오디언스 > 사용자 검색으로 이동하여 테스트 이메일 주소로 검색합니다.
- 프로필이 존재하고 Email Subscribe가 Opted In으로 설정되어 있으며, 구성한 커스텀 속성, 구독 그룹 등록 또는 사용자 별칭이 예상대로 표시되는지 확인합니다.
4단계: 실시간 트래픽에 대해 액션 활성화
Braze에서 테스트 프로필이 올바르게 표시되면 Talkable로 돌아가서 Email opt-in 액션을 활성화합니다.
이 시점부터 모든 Talkable 옵트인 이벤트가 일치하는 프로필을 실시간으로 Braze에 동기화합니다.
Braze로 전송되는 기본 사용자 속성
모든 옵트인 이벤트에서 Talkable은 다음과 같은 표준 Braze 사용자 속성으로 일치하는 Braze 고객 프로필을 생성하거나 업데이트합니다. 빈 값은 생략됩니다.
| Braze 속성 | 유형 | 참고 |
|---|---|---|
email_subscribe |
문자열 | 모든 Talkable 옵트인 이벤트에서 Opted In으로 설정됩니다. |
email |
문자열 | Braze 프로필을 매칭하는 데 사용되는 기본 식별자입니다. |
phone |
문자열 | 사용자 속성으로만 캡처됩니다. Braze는 E.164 형식을 기대하며, Talkable에 저장된 그대로 전송됩니다. |
first_name |
문자열 | 사용자의 이름입니다. |
last_name |
문자열 | 사용자의 성입니다. |
| 구독 그룹 등록 | 해당 없음 | 구독 그룹이 구성된 경우 Talkable은 사용자를 구독 상태로 등록합니다. |
| 사용자 별칭 | 해당 없음 | 사용자 별칭이 구성된 경우에만 추가됩니다. 자세한 내용은 Talkable 커스터마이징을 참조하세요. |
Talkable 커스터마이즈
다음과 같은 선택적 커스터마이즈 옵션을 사용할 수 있습니다. 원하는 조합으로 구성할 수 있으며, 각 옵션은 독립적입니다.
Braze 구독 그룹에 옵트인 등록
- Braze에서 오디언스 > 구독 그룹 관리로 이동하여 구독 그룹 ID를 복사합니다. 자세한 내용은 사용자 구독 관리를 참조하세요.
- Talkable의 Email opt-in 액션에서 Subscription group identifier 필드에 붙여넣습니다.
Talkable은 각 옵트인을 해당 구독 그룹에 구독 상태로 등록하여, 추천 옵트인을 글로벌 구독 대신 해당 그룹으로 범위를 지정합니다. Talkable은 구독만 추가하며, 구독을 제거하지는 않습니다.
커스텀 속성 전송
액션의 페이로드 편집기에 키-값 페어를 추가합니다. 입력한 키가 Braze 고객 프로필의 속성 이름이 됩니다.
값은 Liquid 템플릿으로 처리됩니다. 다음 변수를 사용할 수 있습니다.
| 변수 | 내용 |
|---|---|
{{ person }} |
옵트인한 추천인 또는 친구(email, first_name, last_name, phone_number, username, is_advocate, custom_properties 등). |
{{ ip }} |
옵트인이 발생한 IP 주소. |
{{ campaign }} |
원래 Talkable 캠페인(name, type, tag_names 등). |
예: talkable_is_advocate = {{ person.is_advocate }}와 talkable_campaign_name = {{ campaign.name }}을 추가하면 Braze에서 추천 컨텍스트별로 세분화할 수 있습니다.
Braze 사용자 별칭으로 사용자 식별
페이로드 편집기에서 user_alias.alias_name(예: {{ person.username }})과 user_alias.alias_label(예: username)을 추가합니다. 자세한 내용은 사용자 별칭 오브젝트를 참조하세요.
두 필드가 모두 있으면 시스템은 이메일 외에 별칭으로도 사용자를 식별하며, 일치하는 항목이 없으면 Braze가 새로운 별칭 프로필을 생성합니다.
두 별칭 필드 모두 필수입니다. alias_name 또는 alias_label 중 하나만 설정된 경우, Talkable은 사용자 별칭을 전송하지 않으며 프로필은 이메일로만 매칭됩니다.
Braze에서 사용자 찾기 및 생성하기
- 기본적으로 Braze는 이메일 주소를 기준으로 프로필을 매칭합니다. 일치하는 프로필이 없으면 Braze가 새 프로필을 생성합니다.
- 사용자 별칭이 구성된 경우, Braze는 해당 별칭으로도 매칭하며 일치하는 항목이 없으면 새로운 별칭 프로필을 생성합니다.
- 이 통합에서는 외부 ID를 사용하지 않습니다. Talkable 옵트인을 기존의 외부 식별된 프로필에 연결하려면, 해당 프로필의 알려진 별칭과 일치하는 별칭 라벨을 가진 사용자 별칭을 구성하세요.
Braze에서 Talkable 사용하기
동기화된 사용자 찾기
오디언스 > 사용자 검색으로 이동하여 이메일로 검색하면 Talkable이 생성하거나 업데이트한 프로필을 확인할 수 있습니다.
표준 필드(이메일, 전화번호, 이름 또는 성)와 설정한 커스텀 속성이 프로필에 표시되며, Email Subscribe는 Opted In으로 표시됩니다.
추천 Segment 만들기
- Email Subscribe가 Opted In인 조건으로 필터링된 Segment를 생성합니다.
- Talkable이 전송하는 커스텀 속성으로 세분화합니다. 예를 들어,
talkable_is_advocate가true인 조건으로 추천인을 타겟팅하거나,talkable_campaign_name이 특정 Campaign과 일치하는 조건으로 특정 추천 프로그램을 타겟팅할 수 있습니다.
라이프사이클 메시징 트리거하기
- 실행 기반 전달로 Canvas 또는 Campaign을 구성합니다. 이 통합에서는 다음 Braze 트리거 유형을 사용할 수 있습니다:
- Update Subscription Status (예: 이메일 구독이 Opted In으로 변경되는 경우)
- Update Subscription Group Status (구독 그룹이 설정된 경우)
- Change Custom Attribute Value (전송하는 모든 Talkable 커스텀 속성에 해당)
- 프로필의 Talkable 커스텀 속성(Campaign 이름, 보상 값, 추천인 등)을 사용하여 메시지를 개인화합니다.
고려 사항
- 이메일 옵트인만 해당: 전화번호는 표준 사용자 속성으로 캡처되지만, 이 통합에서는 SMS 구독 상태를 설정하지 않습니다. Talkable은 SMS 옵트인을 동기화하지 않습니다.
- 전화번호 형식: Braze는 국제(E.164) 형식의 전화번호를 요구합니다.
- 실시간 이벤트 기반 동기화: Talkable은 옵트인 이벤트당 하나의 요청을 전송합니다(요청당 사용자 한 명). 배치 처리나 주기적인 전체 동기화는 없으며, 볼륨은 추천 옵트인 볼륨에 따라 달라집니다.
- 안정적인 전달: Braze가 일시적으로 오류를 반환하면 Talkable이 자동으로 재시도합니다. 지속적인 실패 시 사이트 관리자에게 이메일 알림이 전송됩니다.
문제 해결
| 오류 | 가능한 원인 | 해결 방법 |
|---|---|---|
| 401 Unauthorized | REST API 키에 users.track 권한이 없거나 엔드포인트가 잘못된 클러스터를 가리키고 있습니다. |
users.track 권한이 포함된 키를 다시 발급하고, REST 엔드포인트가 Braze 클러스터와 일치하는지 확인합니다. |
| 설치 시 REST 엔드포인트 거부됨 | URL이 Braze REST 엔드포인트가 아닙니다. | 클러스터의 REST 엔드포인트를 사용합니다(예: https://rest.iad-01.braze.com). 대시보드 URL은 작동하지 않습니다. |
| 프로필이 생성되었지만 구독 그룹에 포함되지 않음 | 구독 그룹 ID가 구성되지 않았습니다. | Email opt-in 액션에 구독 그룹 ID를 입력합니다. |
| 사용자 별칭이 적용되지 않음 | 두 별칭 필드(이름 또는 라벨) 중 하나만 입력되었습니다. | 액션에서 별칭 이름과 별칭 라벨 두 필드를 모두 입력합니다. |
| 프로필이 표시되지 않음 | 샘플 요청이 아직 전송되지 않았거나 액션이 비활성화되어 있습니다. | Talkable에서 Send sample payload를 선택하고 Email opt-in 액션이 활성화되어 있는지 확인합니다. |
| 키 교체 후 요청 전송이 중단됨 | 저장된 API 키가 Braze에서 취소되었거나 교체되었습니다. | Talkable 앱 스토어에서 Braze 앱을 열고 새 REST API 키를 붙여넣은 후 Save를 선택합니다. Send sample payload로 다시 테스트합니다. |
Talkable 통합에 대한 자세한 내용은 Talkable Braze 통합 설명서를 참조하세요. Talkable 지원팀에 문의하려면 [email protected]으로 이메일을 보내세요.