Klaviyo의 데이터 웨어하우스 동기화 이해하기

학습 내용

Klaviyo에서 데이터 웨어하우스로 데이터를 동기화하는 방법과 SFTP를 통해 웨어하우스 데이터를 Klaviyo로 가져오는 방법을 알아보세요. 고객 프로필 및 이벤트 데이터를 동기화하여 Klaviyo 외부에서 고객에 대한 주요 정보를 저장하고 분석할 수 있어요.

This content requires Functional cookies to be enabled.

Update Cookie Settings

시작하기 전에 알아야 할 것

연결하려는 데이터 웨어하우스가 대상(Destination)으로 구성되어 있는지 확인해야 해요. 올바르게 설정되었는지 확인하려면 다음을 확인해 주세요:

• Klaviyo에 제공되는 사용자가 올바른 권한을 가지고 있는지 확인해 주세요.
• 웨어하우스에 따라 아래에 표시된 적절한 이름으로 테이블을 설정해 주세요.

또한 Klaviyo의 아웃바운드 데이터 웨어하우스 트래픽 IP 주소를 허용 목록에 추가해 주세요. 이렇게 하면 보안 계층에서 Klaviyo 요청이 차단되지 않아요. 이 주소는 다음 CIDR 범위로 표시돼요.

• 184.72.183.187/32
• 52.206.71.52/32
• 3.227.146.32/32
• 44.198.39.11/32
• 35.172.58.121/32
• 3.228.37.244/32
• 54.88.219.8/32
• 3.214.211.176/32

데이터 웨어하우스에 연결

Klaviyo에 데이터 웨어하우스 연결을 추가하려면 Klaviyo 고급 데이터 플랫폼 > 데이터 관리 > 동기화로 이동해 주세요.

데이터 웨어하우스를 추가하려면 커넥터 선택 모달에서 지원되는 데이터 웨어하우스를 선택하세요.

또는 연동 > 앱 둘러보기 로 이동한 다음, Klaviyo의 앱 마켓플레이스에서 데이터 웨어하우스를 선택하고 플랫폼을 검색할 수 있어요.

웨어하우스를 연결할 때는 데이터 웨어하우스에서 Klaviyo로 데이터를 가져오거나, 웨어하우스를 아웃바운드 동기화 대상 위치로 설정할 수 있습니다.

SFTP를 통해 데이터 가져오기

데이터 웨어하우스의 데이터를 Klaviyo로 가져오려면 SFTP를 통해 진행할 수 있어요.

Klaviyo로 데이터를 가져오려면 웨어하우스 대상에 처음 연결할 때 데이터 가져오기 를 선택하거나, 이미 연결이 설정되어 있다면 데이터 동기화 페이지에서 가져오기 버튼을 클릭하세요.

웨어하우스 데이터를 Klaviyo로 가져오는 프로세스는 다음과 같아요:

1. 데이터 웨어하우스에서 원하는 데이터를 내보내세요.
2. 로컬 머신에서 SSH 키를 생성하세요.
3. SFTP 클라이언트를 구성하고 가져오기를 수행하세요.

데이터베이스 내보내기

먼저 웨어하우스에서 데이터를 내보내야 해요. 웨어하우스에 로그인한 다음, Klaviyo로 가져오려는 데이터를 CSV 파일로 내보내세요.

로컬 머신에서 SSH 키 생성

웨어하우스에서 원하는 데이터를 내보낸 후 로컬 머신에서 새 SSH 키를 생성하고 SSH 키 추가 버튼을 선택해 Klaviyo에 추가하세요.

SFTP 클라이언트 구성 및 가져오기

SSH 키가 Klaviyo에 성공적으로 추가되면 SFTP 클라이언트를 구성하고 데이터를 가져와야 해요.

1. SFTP 클라이언트를 열고 Klaviyo에 표시된 자격 증명으로 새 연결을 구성하세요. SSH 키를 성공적으로 추가하면 자격 증명이 표시돼요.
2. 인증이 완료되면 가져오기 전에 데이터베이스가 권장 가이드라인을 따르는지 확인하세요.
3. SFTP 클라이언트를 통해 데이터베이스 파일을 업로드하고 검토하세요.

다음 정보와 함께 최근 가져오기 목록이 목록 보기로 표시돼요:

• 상태
  완료 또는 미완료.
• 처리된 행
  지금까지 처리된 전체 행의 백분율입니다.
• 가져오기 날짜
  가져온 날짜.
• 가져온 사용자
  데이터를 가져온 사용자입니다.

웨어하우스로 데이터 내보내기 

데이터 웨어하우스를 대상로 구성하려면 각 데이터 웨어하우스에 대해 다음 정보 및 자격 증명 세트가 필요합니다.

Amazon Redshift

Amazon Redshift를 대상(목적지)으로 구성하려면 다음 스크립트를 실행해 klaviyo_event 및 klaviyo_profile 테이블을 생성하세요.

대상으로 설정한 후 다음 자격 증명 세트를 사용하여 Klaviyo에서 웨어하우스를 연결하세요:

• 이름: Redshift의 데이터베이스 이름입니다(Redshift 데이터베이스와 동일한 이름을 사용하는 것이 좋습니다).
• 호스트 URL: Amazon Redshift 서버의 엔드포인트( Redshift에서 연결 URL이라고 함)
• 데이터베이스: 데이터 소스를 식별하기 위한 이름
• 포트: Redshift에서 사용하는 포트 번호
• 스키마: 데이터베이스 스키마
• 사용자 이름: Redshift에 로그인할 때 사용되는 사용자 이름
• 데이터베이스 비밀번호: Redshift에 로그인하는 데 사용하는 비밀번호
  

Amazon S3

Amazon S3를 대상(대상지)으로 구성하려면 테이블 이름을 klaviyo_profile 및 klaviyo_event로 설정하세요.

대상으로 설정한 후 다음 자격 증명 세트를 사용하여 Klaviyo에서 웨어하우스를 연결하세요:

• 이름: Amazon S3 데이터베이스의 머신 판독용 이름입니다.
• 버킷: 버킷 이름입니다.
• 버킷 위치: 스토리지 버킷을 만들 때 선택한 지역 이름입니다.
• 액세스 키 ID: AWS 액세스 키 ID입니다.
• 비밀 액세스 키: AWS 비밀 액세스 키입니다.
  

Google BigQuery

Google BigQuery를 대상으로 구성하려면 다음 스크립트를 실행하여 klaviyo_profile 및 klaviyo_event 테이블을 설정하세요. 연결 프로세스가 성공적으로 완료되려면 Google BigQuery 계정에 결제 프로필이 있어야 합니다.

참고: 이 스크립트에서는 자리표시자 “SERVICE ACCOUNT EMAIL”을 BigQuery 서비스 계정 이메일로 바꿔야 합니다.

대상으로 설정한 후 다음 자격 증명 세트를 사용하여 Klaviyo에서 웨어하우스를 연결하세요:

• 이름: 이 대상을 구분하는 데 도움이 되는 이름
• 프로젝트 ID: 이를 프로젝트 ID라고 하며 API 콘솔에서 찾을 수 있습니다.
• 데이터 세트: 스키마라고도 합니다. 이는 설정을 위해 실행해야 하는 스크립트에서 사용한 이름과 동일합니다.
• 서비스 계정 키: BigQuery에서 서비스 계정을 만들 때 다운로드한 JSON 파일의 전체 내용을 붙여넣습니다.
  

Microsoft Azure Synapse Analytics

Microsoft Azure를 대상으로 구성하려면 다음 스크립트를 실행하여 klaviyo_profile 및 klaviyo_event 테이블을 생성하세요.

대상으로 설정한 후 다음 자격 증명 세트를 사용하여 Klaviyo에서 웨어하우스를 연결하세요:

• 이름: Azure의 데이터베이스와 동일한 이름을 사용하는 것이 좋습니다.
• 워크스페이스: Azure Synapse 워크스페이스 이름입니다.
• 데이터베이스 이름: Dedicated SQL Pool 데이터베이스를 식별합니다.
• 사용자 이름: Dedicated SQL Pool 데이터베이스의 로그인 사용자 이름입니다.
• 데이터베이스 비밀번호:Dedicated SQL Pool 데이터베이스의 로그인 비밀번호입니다.
• 계정 이름: Windows Azure 스토리지 계정 또는 생성한 DNS 접두어입니다.
• 공유 액세스 서명: Blob Storage 컨테이너에 대한 액세스를 증명하는 공유 액세스 서명(SAS) 문자열입니다.
• 컨테이너 이름: 데이터 전송을 위한 임시 준비 영역으로 사용하는 Azure Blob 컨테이너 이름이에요.
  

Snowflake

Snowflake를 대상으로 구성하려면 다음 단계를 따르세요:

1. 터미널에서 다음 명령을 실행하여 비공개 키를 생성하세요.

text Copy

openssl genrsa 2048 | openssl pkcs8 -topk8 -inform PEM -out rsa_key.p8 -nocrypt

2. 터미널에서 다음 명령을 실행해 비공개 키를 참조하는 공개 키를 생성하세요:

text Copy

openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub

3. 다음 스크립트를 실행하여 KLAVIYO_PROFILE, KLAVIYO_EVENT, KLAVIYO_METRIC 테이블을 설정하세요. 아래 설정을 완료하려면 securityadmin 및 sysadminprivileges 권한이 있어야 해요. 어떤 역할이 있는지 확인하려면 SHOW GRANTS TO USER <your_username>를 실행하고, 두 역할이 모두 목록에 있는지 확인하세요. 역할 조정이 필요하면 시스템 관리자에게 문의하세요.

대상으로 설정한 후 다음 자격 증명 세트를 사용하여 Klaviyo에서 웨어하우스를 연결하세요:

• 이름: Snowflake 데이터베이스와 동일한 이름을 사용하는 것이 좋습니다.
• 사용자 이름: 데이터베이스에 연결할 사용자 이름입니다. 설정 스크립트의 user_name과 동일해야 합니다.
  
• 프라이빗 키: 생성된 Snowflake 프라이빗 키.
  
• 웨어하우스:  Snowflake의 웨어하우스입니다.
• 계정: Snowflake의 계정.
• 데이터베이스: 데이터베이스 이름입니다. 설정 스크립트의 database _name과 동일해야 합니다.
• 스키마: 데이터베이스 스키마입니다. 이는 설정 스크립트의 schema_name과 동일해야 합니다.
  

동기화하려는 데이터 웨어하우스의 자격 증명을 입력한 후, Klaviyo에서 동기화할 데이터를 선택하세요.

데이터 개체

데이터 객체 섹션에서 각 옵션 옆의 해당 확인란을 선택해 모든 프로필 데이터, 특정 이벤트 데이터만 또는 두 유형의 데이터를 모두 동기화하도록 선택할 수 있어요.

제외할 연동 서비스

제외할 연동 필드에서 데이터 웨어하우스 동기화에서 제외하려는 특정 연동을 선택할 수 있어요. 이 기능은 이미 Klaviyo에 연결했을 수 있는 특정 연동의 데이터도 동기화되지 않도록 제거하려는 경우에 유용해요.

선택적 동기화

Selective sync 필드에서 Klaviyo에서 데이터 웨어하우스로 동기화할 특정 이벤트를 선택해요. 기본적으로 모든 이벤트가 포함돼요. 이 필드에서 동기화할 특정 이벤트를 설정하면 선택한 이벤트만 동기화돼요.

데이터 동기화 빈도 선택

데이터가 동기화되는 빈도 선택 이라는 섹션의 정기 동기화 주기 필드에 설정된 값은 Klaviyo에서 데이터 웨어하우스로 동기화가 얼마나 자주 수행되는지 정의해요.

동기화할 과거 데이터의 규모 선택

동기화할 과거 데이터의 양을 선택 섹션에서 초기 연결 중 Klaviyo에서 데이터 웨어하우스로 동기화할 과거 데이터의 양을 정의할 수 있어요. 다음 중에서 선택할 수 있어요:

• 30일
• 90일
• 1년
• 모든 시간

후기 동기화

연동을 연결한 후 설정이 성공적으로 완료되면 연결이 활성화됨으로 표시된 최종 화면과 함께 다음 항목이 표시돼요:

• 설정한 동기화의 세부 정보
• 어떤 데이터가 공유되고 있나요(프로필, 이벤트 또는 둘 다)
• 제외한 연동

동기화가 성공적으로 연결되지 않은 경우 대신 연결할 수 없음 상태가 표시되며, 연결을 다시 시도하거나 자격 증명의 정보를 편집할 수 있는 옵션이 함께 표시돼요.

데이터 웨어하우스를 성공적으로 연결하면 기본 데이터 동기화 리스트 페이지로 돌아가게 돼요. 여기에서 다음 항목을 확인할 수 있어요:

• 웨어하우스 대상
• 활성화됨 상태
• 지난 24시간 동안 동기화에서 발생했을 수 있는 잠재적 오류
• 이 이벤트의 타임스탬프와 함께 발생한 마지막 동기화

연결할 수 있는 대상은 1개뿐이므로 이 목록 보기에는 대상 1개만 표시돼요.

데이터 동기화 대시보드

성공적으로 연결되면 데이터 동기화 목록 페이지에서 연동을 클릭하세요. 여기에서 실행된 데이터 동기화에 대한 과거 및 현재 정보를 제공하는 데이터 동기화 대시보드로 이동돼요.

여기에서 동기화 정보가 2개의 탭으로 분할되어 표시돼요:

• 과거 기록
• 정기

과거 기록

과거 탭에는 과거 데이터 동기화 상태를 보여주는 로그가 있어요. 과거 동기화는 연결을 설정할 때 Klaviyo의 기존 데이터를 데이터 웨어하우스로 동기화하는 것을 의미해요.

각 동기화에서 다음 정보를 확인할 수 있어요:

• 이름
  데이터가 동기화에 포함되고 있어요.
• 상태
  예상 백분율과 함께 동기화 상태와 잠재적 진행 상황 또는 표시된 잠재적 오류예요. 이러한 상태에는 다음이 포함될 수 있어요:
  
  
  • 완료
    이 일회성 동기화에 대한 데이터 동기화가 완료되었습니다. 자동으로 다시 동기화되지 않습니다.
  • 예약됨
    다음 동기화가 자동으로 실행되도록 예약된 시점이에요.
  • 진행 중
    데이터가 예상 완료율과 함께 데이터 웨어하우스로 적극적으로 동기화되고 있어요.
  • 오류 발생
    오류가 발생했지만 Klaviyo에서 연결을 다시 설정하기 위해 계속 시도합니다. 연동에 따라 이 타이밍이 약간 다를 수 있습니다.
  • 실패
    연결을 다시 설정하려고 시도한 후에도 동기화가 완전히 실패했어요. 즉, 구성 설정 또는 데이터 웨어하우스 설정까지 검토해야 해요.
  • 일시 중지됨
    동기화를 수동으로 일시 중지했어요.
  • 비활성화됨
    연동 자체가 비활성화되었거나 제거되었기 때문에 동기화가 비활성화되었습니다.
• 시작 시간
  동기화 시작 시간입니다.
• 
  종료일동기화 종료 시간.

정기

Periodic 탭에는 정기 동기화 상태를 보여주는 로그가 있습니다. 고객이 계속해서 브랜드와 상호 작용하고 새로운 데이터가 생성되면, 해당 데이터는 정기적으로 데이터 웨어하우스로 전송됩니다. 데이터 웨어하우스 연결을 설정하면 정기 동기화는 매시간 발생합니다.

각 동기화에서 다음 정보를 확인할 수 있어요:

• 이름
  데이터가 동기화에 포함되고 있어요.
• 상태
  예상 백분율과 함께 동기화 상태와 잠재적 진행 상황 또는 표시된 잠재적 오류예요. 이러한 상태에는 다음이 포함될 수 있어요:
  
  
  • 완료
    이 일회성 동기화에 대한 데이터 동기화가 완료되었습니다. 자동으로 다시 동기화되지 않습니다.
  • 예약됨
    다음 동기화가 자동으로 실행되도록 예약된 시점이에요.
  • 진행 중
    데이터가 예상 완료율과 함께 데이터 웨어하우스로 적극적으로 동기화되고 있어요.
  • 오류 발생
    오류가 발생했지만 Klaviyo에서 연결을 다시 설정하기 위해 계속 시도합니다. 연동에 따라 이 타이밍이 약간 다를 수 있습니다.
  • 실패
    연결을 다시 설정하려고 시도한 후에도 동기화가 완전히 실패했어요. 즉, 구성 설정 또는 데이터 웨어하우스 설정까지도 검토해야 해요.
  • 일시 중지됨
    동기화를 수동으로 일시 중지했습니다.
  • 비활성화됨
    연동 자체가 비활성화되었거나 제거되어 동기화가 비활성화되었어요.
• 데이터 최신성
  데이터 최신성은 데이터가 얼마나 최신 상태인지 나타냅니다. 예를 들어 동기화의 최신성이 2분이라면, 지난 2분 동안 Klaviyo에서 생성된 새 데이터는 아직 데이터 웨어하우스에 반영되지 않았다는 뜻입니다.
• 일시 중지, 재개, 개별 동기화 다시 활성화 버튼.

데이터 웨어하우스 연결 제거

Klaviyo 계정에서 데이터 웨어하우스 연결을 삭제하려면 연동 탭을 선택합니다.

데이터 웨어하우스 연동 옆의 메뉴를 열고 연동 제거를 선택해 연결을 제거해 주세요.

오류 로그 보기

Klaviyo와 데이터 웨어하우스 간 데이터 동기화에 문제가 발생하는 경우, 관련 오류 로그를 확인하면 문제 원인에 대한 추가 정보를 얻을 수 있어요.

오류를 보려면 동기화 페이지에서 웨어하우스 대상을 클릭해 주세요. 과거 및 정기 동기화 탭 모두에서 내보내기 목록과 해당 상태, 그리고 활성 오류가 있는지 여부를 나타내는 표시를 확인할 수 있어요.

특정 오류에 대한 자세한 내용을 보려면 실패가 발생한 내보내기를 클릭해 들어가세요.

여기에서는 동기화 상태에 따라 오류 또는 성공 메시지와 함께 아웃바운드 동기화의 타임라인이 표시됩니다.

특정 오류를 클릭하면 다음 정보가 포함된 서랍이 열립니다:

• 요약
  데이터 웨어하우스에서 반환된 오류에 대한 간단한 설명
• 코드
  오류에 대한 오류 코드
• 외부 메시지
  데이터 웨어하우스에서 반환된 실제 오류 메시지
• 날짜
  오류의 날짜 및 시간

추가 자료