데이터 웨어하우스 통합

1. Redshift 테이블과 동기화하려는 Braze 액세스가 허용되었는지 확인하십시오. Braze는 인터넷을 통해 Redshift에 연결됩니다.
2. Redshift 인스턴스에서 Braze와 동기화하려는 테이블 또는 뷰를 설정하십시오.
3. Braze 대시보드에서 새 통합을 생성합니다.
4. 통합을 테스트하고 동기화를 시작하십시오.

1단계: 테이블을 설정하십시오

선택적으로 소스 테이블을 보유할 새 데이터베이스 및 스키마를 설정하십시오

1
2
CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;

CDI 통합에 사용할 테이블(또는 뷰)을 만드십시오

1
2
3
4
5
6
7
8
9
10
11
12
13
14
CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC (
   updated_at timestamptz default sysdate,
   --at least one of external_id, alias_name and alias_label, or braze_id is required
   external_id varchar,
   --if using user alias, both alias_name and alias_label are required
   alias_label varchar,
   alias_name varchar,
   --braze_id can only be used to update existing users created through the Braze SDK
   braze_id varchar,
   --If you include both email and phone, we will use the email as the primary identifier
   email varchar,
   phone varchar,
   payload varchar(max)
)

데이터베이스, 스키마 및 테이블의 이름은 원하는 대로 지정할 수 있지만, 열 이름은 앞서 정의한 것과 일치해야 합니다.

• UPDATED_AT - 이 행이 테이블에 업데이트되거나 추가된 시간. 우리는 마지막 동기화 이후에 추가되거나 업데이트된 행만 동기화할 것입니다.
• 사용자 식별자 열. 귀하의 테이블에는 하나 이상의 사용자 식별자 열이 포함될 수 있습니다. 각 행에는 하나의 식별자( external_id, alias_name와 alias_label의 조합 또는 braze_id)만 포함되어야 합니다. 소스 테이블에는 하나, 둘 또는 세 가지 식별자 유형에 대한 열이 있을 수 있습니다.
  • EXTERNAL_ID - 업데이트하려는 사용자를 식별합니다. 이것은 Braze에서 사용된 external_id 값과 일치해야 합니다.
  • ALIAS_NAME 및 ALIAS_LABEL - 이 두 열은 사용자 별칭 객체를 생성합니다. alias_name은(는) 고유한 식별자여야 하며, alias_label은(는) 별칭의 유형을 지정합니다. 사용자는 여러 레이블이 있는 여러 별칭을 가질 수 있지만 alias_label당 하나의 alias_name만 가질 수 있습니다.
  • BRAZE_ID - Braze 사용자 식별자. 이것은 Braze 소프트웨어 개발 키트에 의해 생성되었으며, 새로운 사용자는 Braze ID를 통해 클라우드 데이터 수집을 사용하여 생성될 수 없습니다. 새 사용자를 만들려면 외부 사용자 ID 또는 사용자 별칭을 지정하십시오.
  • EMAIL - 사용자의 이메일 주소. 동일한 이메일 주소를 가진 여러 프로필이 존재하는 경우, 가장 최근에 업데이트된 프로필이 업데이트 우선순위가 됩니다. 이메일과 전화번호를 모두 포함하면 이메일을 기본 식별자로 사용하겠습니다.
  • PHONE - 사용자의 이메일 주소. 동일한 전화번호를 가진 여러 프로필이 존재하는 경우, 가장 최근에 업데이트된 프로필이 업데이트에 우선됩니다.
• PAYLOAD - 이것은 Braze에서 사용자와 동기화하려는 필드의 JSON 문자열입니다.

2단계: 사용자를 생성하고 권한을 부여하십시오

1
2
3
CREATE USER braze_user PASSWORD '{password}';
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT SELECT ON TABLE USERS_ATTRIBUTES_SYNC TO braze_user;

이 사용자를 위한 최소한의 권한입니다. 여러 CDI 통합을 생성하는 경우 스키마에 대한 권한을 부여하거나 그룹을 사용하여 권한을 관리할 수 있습니다.

3단계: Braze IP에 대한 액세스 허용

방화벽이나 기타 네트워크 정책이 있는 경우 Braze 네트워크에 Redshift 인스턴스에 대한 액세스 권한을 부여해야 합니다. Redshift URL 엔드포인트의 예는 “example-cluster.ap-northeast-2.redshift.amazonaws.com”입니다.

알아야 할 중요한 사항들:

• Braze가 Redshift에서 데이터에 액세스할 수 있도록 보안 그룹을 변경해야 할 수도 있습니다.
• IP 테이블과 Redshift 클러스터를 쿼리하는 데 사용되는 포트(기본값은 5439)에서 인바운드 트래픽을 명시적으로 허용해야 합니다. 이 포트에서 Redshift TCP 연결을 명시적으로 허용해야 합니다. 수신 규칙이 ‘모두 허용’으로 설정되어 있더라도.
• Braze가 클러스터에 연결할 수 있도록 Redshift 클러스터의 엔드포인트는 공개적으로 접근 가능해야 합니다.
  • Redshift 클러스터가 공개적으로 액세스할 수 없도록 하려면 VPC와 EC2 인스턴스를 설정하여 SSH 터널을 사용하여 Redshift 데이터에 액세스할 수 있습니다. 이 AWS 지식 센터 게시물을 확인하여 자세한 정보를 확인하세요.

다음 IP에서 Braze 대시보드의 지역에 해당하는 액세스를 허용합니다.

파트너 통합 > 기술 파트너. Redshift 페이지를 찾아 새 가져오기 동기화 생성을 선택하세요.

1단계: Redshift 연결 정보 및 소스 테이블 추가

Redshift 데이터 웨어하우스 및 소스 테이블에 대한 정보를 입력하십시오. 프라이빗 네트워크 터널을 사용 중인 경우, 슬라이더를 토글하고 터널 정보를 입력하세요. 그런 다음 다음 단계로 진행하십시오.

2단계: 동기화 세부 정보 구성

다음으로, 동기화 이름을 선택하고 연락처 이메일을 입력하세요. 이 연락처 정보를 사용하여 테이블에 대한 접근이 예상치 못하게 제거되는 등의 통합 오류에 대해 알려드리겠습니다.

연락처 이메일은 누락된 테이블, 권한 등과 같은 글로벌 또는 동기화 수준 오류에 대한 알림만 받게 됩니다. 그들은 행 수준 문제를 받지 않을 것입니다. 전역 오류는 동기화 실행을 방해하는 연결의 치명적인 문제를 나타냅니다. 이러한 문제에는 다음이 포함될 수 있습니다:

• 연결 문제
• 자원의 부족
• 권한 문제
• (카탈로그 동기화 전용) 카탈로그 계층의 공간이 부족합니다

또한 데이터 유형과 동기화 빈도를 선택합니다. 빈도는 15분마다 한 번에서 한 달에 한 번까지 어디에서나 있을 수 있습니다. Braze 대시보드에 구성된 시간대를 사용하여 반복 동기화를 예약합니다. 지원되는 데이터 유형은 커스텀 속성, 커스텀 이벤트 및 구매 이벤트이며, 동기화의 데이터 유형은 생성 후 변경할 수 없습니다.

Braze 대시보드로 돌아가서 연결 테스트를 선택하세요. 성공하면 데이터 미리보기를 볼 수 있습니다. 만약 어떤 이유로 연결할 수 없다면, 문제를 해결할 수 있도록 오류 메시지를 표시할 것입니다.

Braze와 여러 통합을 설정할 수 있지만, 각 통합은 다른 테이블과 동기화되도록 구성해야 합니다. 추가 동기화를 생성할 때 동일한 Snowflake 또는 Redshift 계정에 연결하는 경우 기존 자격 증명을 재사용할 수 있습니다.

동일한 사용자를 통합 간에 재사용하는 경우 모든 활성 동기화에서 제거될 때까지 Braze 대시보드에서 사용자를 삭제할 수 없습니다.

활성화되면 동기화가 설정 중 구성된 일정에 따라 실행됩니다. 정기 테스트 일정 외에 동기화를 실행하거나 최신 데이터를 가져오려면 지금 동기화를 선택하십시오. 이 실행은 정기적으로 예정된 향후 동기화에 영향을 미치지 않습니다.