Braze(이벤트 스트림)

Amplitude Activation Braze 스트리밍 연동은 몇 번의 클릭만으로 Amplitude 이벤트와 사용자를 Braze로 전달합니다.

활용 사례

이벤트 스트리밍은 고객이 작업을 수행한 직후에 메시지를 고객에게 전송합니다. 예를 들면 다음과 같습니다.

• 장바구니를 버린 고객에게 이메일을 보냅니다.
• 고정 작업을 완료한 고객에게 축하의 말을 전합니다.

연동 설정

사전 조건

Amplitude에서 Braze로의 스트리밍을 구성하려면 Braze에서 다음 정보가 필요합니다.

• Braze API 엔드포인트: REST 작업을 위한 Braze 엔드포인트입니다.
• Braze API 키: 인증에 사용되는 Braze API 키입니다. 엔드포인트를 확인하거나 API 키를 찾는 데 도움을 받으려면 Braze 문서를 참조하십시오.
• Braze 앱 ID: Amplitude 이벤트를 수신하는 앱의 Braze 앱 ID입니다. 앱 ID를 찾는 데 도움을 받으려면 Braze 문서를 참조하십시오.

새 동기화 생성

1. Amplitude 데이터에서 카탈로그를 클릭하고 대상 탭을 선택합니다.
2. **Braze(이벤트 · 사용자 속성)**를 선택하거나 유형 > 이벤트를 기준으로 필터링합니다.
3. 목적지 추가를 선택합니다.
4. 동기화 이름을 입력한 다음 동기화 생성을 클릭합니다.

자격 증명 입력

1. 사용자의 Braze API 엔드포인트를 선택합니다.
2. Braze API 키를 입력하십시오.
3. 귀하의 Braze 앱 ID를 입력하십시오.
4. Braze 사용자 별칭을 사용하여 Braze에서 사용자를 식별하는 경우 사용할 Braze 사용자 별칭 레이블을 입력하십시오. 그렇지 않으면 이 필드를 무시하십시오.
5. 새 사용자를 생성하지 않고 Braze에 존재하는 사용자를 업데이트하려면 'Update Users Only' 옵션을 선택합니다. 별칭 전용 사용자 프로필을 전송하는 경우 이 필드를 선택하지 마십시오. 사용자만 업데이트를 체크하면 Amplitude는 Braze에서 별칭 전용 사용자 프로필을 생성하지 않습니다. 자세한 내용은 Braze 설명서를 참조하십시오.

매핑 구성

이는 이벤트 및 사용자 전달 모두에 적용됩니다.

1. 왼쪽 드롭다운에서 귀하의 Braze 사용자 ID에 해당하는 Amplitude 사용자 속성을 선택합니다.
2. 오른쪽 드롭다운에서 Braze 사용자 ID 유형을 선택합니다.
   • 외부 ID: Braze의 각 사용자를 위한 전체 고유 식별자입니다.
   • Braze ID: Braze가 각 사용자에게 제공하는 고유 식별자입니다.
   • 사용자 별칭: Braze의 각 사용자를 위한 대체 고유 식별자입니다.
   • 이메일: 외부 ID 또는 Braze ID 없이 이메일을 식별자로 사용하면 예기치 않은 동작이 발생할 수 있습니다. 예를 들어 Amplitude가 ID와 동일한 이메일을 사용하여 사용자를 Braze로 전송할 경우 Braze는 이를 병합하지 않으므로 두 명의 사용자가 별도로 생성됩니다. 이 문제를 방지하려면 Braze 사용자 프로필 설명서를 참조하십시오. 또한 Braze는 사용자를 병합하기 위한 사용자 병합 API를 제공합니다.

이벤트 전달 구성

이벤트를 Braze로 스트리밍하려면 'Send Events'에서 토글('Events are sent to Braze')을 활성화합니다. 활성화된 경우 Amplitude는 이벤트를 수집할 때 자동으로 Braze에 전달합니다. Amplitude는 이 연동을 사용하여 일정에 따라 또는 주문형으로 이벤트를 전송하지 않습니다.

1. 이벤트 선택 및 필터링에서 전송할 이벤트를 선택합니다. Braze에서 필요한 이벤트만 선택하십시오.

2. (선택 사항) 추가 속성 선택에서 Braze로 전송할 이벤트 및 사용자 속성을 더 선택합니다. 여기서 전체 속성을 선택하지 않으면 Amplitude는 전체를 전송하지 않습니다. Amplitude는 이러한 속성을 Braze 사용자 지정 이벤트 속성으로 Braze에 전송합니다.

사용자 전달 구성

사용자 및 속성 업데이트를 Braze로 스트리밍하려면 'Send Users'를 활성화하십시오. 이 설정은 사용자가 Amplitude에서 HTTP V2 API 또는 Identify API를 사용하여 사용자들을 업데이트할 때 Braze에서 사용자를 생성하거나 업데이트합니다. 이 연동은 예약된 업데이트 또는 주문형 업데이트를 지원하지 않습니다.

'Select additional properties' 필드에서 Braze로 전송할 사용자 속성을 선택적으로 선택할 수 있습니다. Amplitude는 사용자가 선택한 속성만 전송하며 그 중 하나가 업데이트될 때만 전송합니다. Amplitude는 이러한 속성을 Braze 사용자 지정 속성으로 전송합니다.

동기화 활성화

구성을 완료했으면 페이지 상단의 상태를 활성화됨으로 전환하고 저장을 클릭합니다.

자주 묻는 질문

Amplitude에서 사용자 속성을 설정해제해도 Braze에서 사용자 지정 속성이 제거되지 않는 이유

Amplitude 이벤트 스트리밍은 $unset을 사용하여 사용자 속성을 삭제할 때 Braze에 명시적 삭제 또는 Null 신호를 전송하지 않습니다. 대신, Amplitude는 스트리밍 페이로드에서 해당 속성을 생략합니다. 속성이 API 요청에 포함되어 있지 않을 때 Braze는 기존 사용자 지정 속성 값을 유지하므로 속성은 Braze에서 변경되지 않은 채로 유지됩니다.

이는 현재 연동의 알려진 제한 사항입니다. Braze는 사용자 지정 속성을 지우기 위해 /users/trackAPI 페이로드에 명시적 null 값을 필요로 하지만, Amplitude의 스트리밍 레이어는 $unset작업을 Braze API에 대한 명시적 null 값으로 변환하지 않습니다.

Amplitude 이벤트 스트리밍은 Braze에서 사용자 지정 속성을 제거하거나 지우는 것을 지원하지 않습니다. 또한 Amplitude는 사용자 속성을 JSON으로 설정하는 것을 지원하지 않습니다. nullAmplitude HTTP API는 사용자 속성 값으로 이를 null받아들이지 않습니다.

Braze에서 속성을 지워야 하는 경우 Braze /users/trackAPI를 직접 사용하여 제거하려는 속성에 대한 명시적 null값을 전송하십시오. 이 기능이 귀하의 사용 사례에 중요하다면 Amplitude 담당자를 통해 기능 요청을 제출하십시오.