커런츠 설정

이 페이지는 Braze 커런츠를 통합하고 구성하는 일반적인 프로세스를 설명합니다.

문제 해결

새 Currents 통합을 추가할 수 없음

새 통합을 추가할 때 “You do not have any remaining Currents integrations” 메시지가 표시되거나 새 Currents 커넥터 추가 버튼이 비활성화되어 있다면, 일반적인 원인은 다음과 같습니다.

• 이 워크스페이스에 Currents 사용 권한을 구매하지 않았습니다.
• Currents 사용 권한이 회사 내 다른 워크스페이스에 있습니다.

이 문제를 해결하려면 회사 내 다른 워크스페이스를 확인하세요. 다른 워크스페이스에 사용 가능한 Currents 사용 권한이 표시될 수 있습니다. 사용 권한을 요청하거나 구성을 조정해야 하는 경우 Braze 계정 매니저에게 문의하세요.

추가 이벤트 추적을 활성화할 수 없음

커넥터를 생성하거나 편집할 수는 있지만 선택 사항인 추적 스위치 중 하나를 활성화할 수 없다면, 워크스페이스가 해당 이벤트 카테고리의 사용 권한 한도에 도달했을 수 있습니다.

• 고객 행동 및 사용자 이벤트 추적을 사용하려면 사용 가능한 고객 행동 이벤트 사용 권한이 필요합니다.
• 사용자 프로필 및 속성 추적을 사용하려면 사용 가능한 사용자 프로필 및 속성 사용 권한이 필요합니다.

추가 사용 권한이 필요하거나 구성 조정에 도움이 필요한 경우 Braze 계정 매니저에게 문의하세요.

통합 오류 알림 이해하기

Currents 통합에서 이벤트 전달에 문제가 발생하면 Braze는 해당 통합에 설정된 연락처 이메일 주소로 이메일을 보냅니다. 통합에 연락처 이메일이 없으면 Braze는 Braze 계정 팀에 적절한 담당자에게 연락하도록 요청합니다. 이러한 알림을 직접 받으려면 각 통합에 연락처 이메일을 추가하세요.

모든 알림은 통합이 복구되었다는 알림을 포함하여 동일한 제목란 “[Urgent Action Required to Prevent Data Loss] Company name Integration type Currents integration failing”을 사용합니다. 어떤 알림을 받았는지 확인하려면 이메일 본문에서 다음 표와 일치하는 문구를 찾으세요. 이메일에 통합이 비활성화되었다는 내용이 있다면, 통합이 여전히 실패하고 있다는 내용이 함께 있더라도 일치하는 “disabled” 행을 참고하세요.

이메일 내 문구	의미	조치 방법
통합이 “is failing due to invalid credentials” 또는 “is still failing due to invalid credentials”	대상이 Braze가 데이터를 보내는 데 사용하는 자격 증명을 거부했습니다. 자격 증명이 만료되었거나 변경되었을 수 있습니다. 이메일에는 오류와 통합이 실패하기 시작한 대략적인 시간이 포함됩니다.	Braze에서 통합의 자격 증명을 업데이트하세요. Braze는 5일 후부터 이벤트를 삭제하기 시작하며, 삭제된 이벤트는 복구할 수 없습니다.
통합이 “is failing and receiving an unsupported response from the target endpoint” 또는 “is still failing due to receiving unsupported responses”	대상이 Braze가 처리할 수 없는 응답을 반환했습니다. Braze는 계속 재시도합니다. 이메일에는 응답 예시가 포함됩니다.	대상이 올바르게 설정되어 있는지 확인하고, 이메일에 포함된 응답을 가지고 대상의 지원팀에 문의하세요. 문제가 지속되면 Braze는 5일 후부터 이벤트를 삭제하기 시작합니다.
통합이 “is being rate-limited by the destination”	대상이 Braze로부터 받는 트래픽 양을 제한하고 있습니다. Braze는 계속 재시도하며, 대상이 다시 트래픽을 받기 시작하면 이벤트를 보냅니다.	엔드포인트의 사용량 제한이 Braze가 보내는 양을 처리할 수 있는지 확인하거나, 대상의 지원팀에 더 높은 처리량 한도를 요청하세요.
통합이 “is failing with HTTP 400 Bad Request responses from the destination”	대상이 Braze가 보내는 페이로드를 거부하고 있습니다. 이메일에는 실패한 이벤트의 대략적인 수가 포함됩니다.	커스텀 HTTP 커넥터의 경우 엔드포인트에서 허용하는 요청 형식이 변경되었는지 확인하세요. 이메일에 해당 커넥터의 알려진 실패 시나리오라고 나와 있다면 대상의 지원팀에 문의하세요.
“we have temporarily disabled it”	이메일에 표시된 시간 이후로 통합이 데이터를 보내지 못해 Braze가 통합을 비활성화했습니다. 통합이 비활성화된 동안 Braze는 새 데이터를 대기줄에 추가하지 않으며, 이미 대기 중인 데이터는 최대 7일간 보관합니다.	근본적인 문제(예: 만료된 자격 증명)를 해결하고 Braze에서 통합을 다시 활성화하세요. 7일 이내에 문제를 해결하고 통합을 다시 활성화하지 않으면 대기 중인 데이터가 손실됩니다.
통합이 “has been disabled”	통합이 실패하는 동안 회사 사용자 등에 의해 비활성화되었습니다. 통합이 다시 활성화될 때까지 Braze는 새 데이터를 대기줄에 추가하지 않으며, 이미 대기 중인 데이터는 최대 7일간 보관합니다.	근본적인 문제를 해결한 후 통합을 다시 활성화하여 대기 중인 데이터와 새 데이터를 보내세요.
통합이 “is now recovering”	문제가 해결되어 데이터가 다시 전송되고 있지만, Braze가 밀린 데이터를 보내는 동안 데이터가 지연됩니다. 밀린 데이터 전송이 완료되면 Braze가 후속 알림을 보냅니다.	별도의 조치가 필요하지 않습니다.
통합이 “has fully recovered”	Braze가 밀린 데이터를 모두 전송했습니다.	별도의 조치가 필요하지 않습니다.

요구 사항

어떤 파트너와 Currents를 사용하든 동일한 기본 파라미터와 연결 방법론이 필요합니다.

각 파트너는 Braze가 데이터 파일을 작성하고 전송할 수 있는 권한을 갖도록 요구합니다. Braze는 해당 파일을 작성할 위치, 특히 버킷 이름이나 키를 요청합니다.

다음은 대부분의 파트너와 통합하기 위한 기본 최소 요구 사항입니다. 일부 파트너는 추가 파라미터가 필요하며, 이러한 파라미터와 기본 요구 사항에 관련된 세부 사항은 각 파트너 설명서에 나와 있습니다.

요구 사항	Origin	액세스	설명
파트너 계정	해당 파트너와 계정을 개설하거나 Braze 계정 매니저에게 문의하여 추천을 받으세요.	해당 파트너의 사이트를 확인하거나 파트너에게 문의하여 가입하세요.	회사 계정을 통해 해당 데이터에 액세스할 수 없는 경우 Braze는 파트너에게 데이터를 전송하지 않습니다.
파트너 API 키 또는 토큰	일반적으로 파트너의 대시보드에서 확인할 수 있습니다.	지정된 Braze 필드에 복사하여 붙여넣습니다.	Braze에는 해당 파트너의 통합 페이지에 이를 위한 지정 필드가 있습니다. 데이터를 전송할 위치를 매핑하는 데 필요합니다. 파트너 키 또는 토큰을 최신 상태로 유지하세요. 유효하지 않은 자격 증명으로 인해 커넥터가 비활성화되고 이벤트가 삭제될 수 있습니다.
인증 코드/키, 비밀 키, 인증서 파일	해당 파트너의 계정 담당자에게 문의하세요. 파트너의 대시보드에서도 확인할 수 있습니다.	지정된 Braze 필드에 키를 복사하여 붙여넣습니다. .json 또는 기타 인증서 파일을 생성하여 Braze의 적절한 위치에 업로드합니다.	Braze에는 해당 파트너의 통합 페이지에 이를 위한 지정 필드가 있습니다. 이를 통해 Braze가 자격 증명을 얻고 파트너 계정에 파일을 작성할 권한을 부여받습니다. 인증 세부 정보를 최신 상태로 유지하는 것이 중요합니다. 유효하지 않은 자격 증명으로 인해 커넥터가 비활성화되고 이벤트가 삭제될 수 있습니다.
버킷, 폴더 경로	일부 파트너는 버킷별로 데이터를 정리하고 분류합니다. 파트너의 대시보드에서 확인할 수 있습니다.	필요한 경우 버킷 이름 또는 파일 경로를 Braze의 지정된 공간에 정확하게 복사합니다.	일부 파트너에게만 필요하지만, 필요한 경우에는 정확하게 입력하는 것이 중요합니다.

Currents 설정

1단계: 파트너 선택

Braze Currents를 사용하면 플랫 파일을 사용하는 데이터 스토리지를 통해 통합하거나, 지정된 엔드포인트로 일괄 처리된 JSON 페이로드를 전송하여 행동 분석 및 고객 데이터 파트너와 통합할 수 있습니다.

통합을 시작하기 전에 목적에 가장 적합한 통합 방식을 결정하는 것이 좋습니다. 예를 들어, 이미 mParticle과 Segment를 사용하고 있고 Braze 데이터를 해당 플랫폼으로 스트리밍하려는 경우에는 일괄 처리된 JSON 페이로드를 사용하는 것이 가장 좋습니다. 데이터를 직접 조작하거나 보다 복잡한 데이터 분석 시스템을 사용하는 경우에는 데이터 스토리지를 사용하는 것이 가장 좋을 수 있습니다(Braze도 이 방법을 사용합니다!).

2단계: Currents 열기

시작하려면 파트너 통합 > Currents로 이동합니다. Currents 통합 관리 페이지로 이동하게 됩니다.

3단계: 파트너 추가

화면 상단의 드롭다운을 선택하여 파트너(“Currents 커넥터”라고도 함)를 추가합니다.

파트너마다 필요한 구성 단계가 다릅니다. 각 통합을 활성화하려면 사용 가능한 파트너 목록을 참조하고 각 파트너 페이지의 안내를 따르세요.

통합 오류 알림을 받을 연락처 이메일을 입력하세요. 자격 증명 문제나 연결 문제 등 통합에서 오류가 발생하면 Braze가 이 주소로 알림을 보냅니다. 적절한 담당자가 알림을 받을 수 있도록 배포 목록이나 그룹 이메일 주소를 사용하는 것이 좋습니다.

4단계: 이벤트 구성

사용 가능한 옵션 중에서 해당 파트너에게 전달할 이벤트를 선택합니다. 이러한 이벤트 목록은 고객 행동 이벤트 및 메시지 인게이지먼트 이벤트 라이브러리에서 확인할 수 있습니다.

필요한 경우 이벤트 전달 의미론 문서에서 이벤트에 대해 자세히 알아볼 수 있습니다.

5단계: 필드 변환 설정

Currents 필드 변환을 사용하여 문자열 필드를 제거하거나 해시할 수 있습니다.

• 제거: 문자열 필드를 [REDACTED]로 대체합니다. 파트너가 누락되거나 비어 있는 필드가 있는 이벤트를 거부하는 경우에 유용합니다.
• 해시: 문자열 필드에 SHA-256 해싱 알고리즘을 적용합니다.

이러한 변환 중 하나에 필드를 선택하면 해당 필드가 나타나는 모든 이벤트에 변환이 적용됩니다. 예를 들어, 해싱할 필드로 email_address를 선택하면 이메일 발송, 이메일 열람, 이메일 반송 및 구독 그룹 상태 변경 이벤트의 email_address 필드가 해시됩니다.

필드 변환은 문자열 필드에서만 작동합니다. 배열과 같은 다른 필드 유형은 선택할 수 없으므로 제거하거나 해시할 수 없습니다. 예를 들어, 이메일 클릭 이벤트의 suspected_bot_click_reason 배열 필드는 내보내기에 그대로 남습니다.

실시간 커넥터에서 필드 변환 편집

실시간 커넥터를 다시 시작하지 않고도 필드 변환을 추가, 변경 또는 제거할 수 있습니다. 커넥터를 업데이트하면 약 5분 후에 변경 사항이 적용됩니다.

필드 변환을 편집해도 Avro 스키마 버전이나 스토리지 경로의 version=<currents_version> 세그먼트는 변경되지 않습니다. 해당 세그먼트는 Currents 릴리스를 통해서만 변경됩니다. 자세한 내용은 Avro 스키마 변경을 참조하세요.

6단계: 통합 테스트

테스트하기 전에 GitHub의 샘플 Currents 데이터를 확인해 보세요. 테스트할 준비가 되면 다음 섹션에서 옵션을 선택합니다.

테스트 이벤트 보내기

통합을 테스트하려면 테스트 이벤트 보내기를 선택하여 선택한 각 이벤트 유형에서 하나의 이벤트를 이 Current로 보낼 수 있습니다. 각 이벤트 유형에 대한 자세한 내용은 고객 행동 이벤트 및 메시지 인게이지먼트 이벤트 라이브러리를 참조하세요.

Currents 커넥터 테스트

테스트 Currents 커넥터는 기존 커넥터의 무료 버전으로, 다양한 대상을 테스트하고 사용해 보는 데 사용할 수 있습니다. 테스트 Currents에는 다음과 같은 제한이 있습니다.

• 워크스페이스당 최대 10개의 테스트 Currents 커넥터
• 고정된 24시간 동안 총 최대 1,500개의 이벤트(UTC 기준 자정에 재설정). Currents 페이지에서 이 한도 대비 현재 전송량을 추적할 수 있습니다. Braze는 이 합계를 매시간 업데이트합니다.

Braze는 테스트 Currents 사용량을 시간당 한 번씩 이 한도와 비교하여 확인합니다. 두 번의 시간별 확인 사이에 대량의 이벤트가 한꺼번에 도착하면, 한도가 적용되기 전에 테스트 Currents 커넥터가 해당 기간 동안 1,500개 이상의 이벤트를 내보낼 수 있습니다.

시간별 확인에서 테스트 Currents 커넥터가 전송 한도에 도달한 것으로 확인되면, Braze는 커넥터를 비활성화하고 한도에 도달한 동안 생성된 이벤트를 삭제합니다. 이벤트 동기화는 UTC 기준 자정에 한도가 재설정된 후 재개됩니다.

테스트 Currents 커넥터를 업그레이드하려면 대시보드에서 통합을 편집하고 테스트 통합 업그레이드를 선택합니다.

Currents 업데이트

Currents 커넥터를 시작한 후 업데이트하려면 다음과 같이 하세요.

1. Braze에서 파트너 통합 > 데이터 내보내기로 이동합니다.
2. 목록에서 Currents 커넥터를 찾습니다.
3.  편집을 선택합니다.
4. 변경 사항을 적용합니다.
5. Update Current를 선택합니다.

이렇게 해도 기존 내보내기가 중지되지 않으며, 새로운 선택에 따라 이벤트 발송이 시작됩니다.

IP 허용 목록

Braze는 아래에 나열된 IP에서 Currents 데이터를 전송합니다.

• united states (us)
• european union (eu)
• australia (au)
• indonesia (id)
• japan (jp)
• south korea (kr)