학습 내용
Klaviyo 에서 데이터 웨어하우스로 데이터를 동기화하고, SFTP를 통해 Klaviyo 로 웨어하우스 데이터를 가져오는 방법을 알아보세요. 고객 프로파일링 및 이벤트 데이터를 동기화하여 고객사에 대한 주요 정보를 Klaviyo 외부에 저장하고 분석할 수 있습니다.
클라비요 CDP는 클라비요의 표준 마케팅 애플리케이션에 포함되어 있지 않으며, 관련 기능에 액세스하려면 CDP 구독이 필요합니다. 요금제에 이 기능을 추가하는 방법에 대해 자세히 알아보거나 신규 고객인 경우 시작하려면 청구 가이드로 이동하세요.
시작하기 전 안내 사항
연결하려는 데이터 웨어하우스가 대상으로 구성되어 있는지 확인해야 합니다. 올바르게 설정했는지 확인하려면 다음과 같이 하세요:
- 클라비요에 제공된 사용자에게 올바른 권한이 있는지 확인하세요.
- 창고에 따라 아래 표시된 대로 적절한 이름으로 테이블을 설정해야 합니다.
또한 클라비요의 아웃바운드 데이터 웨어하우스 트래픽 IP 주소를 허용 목록에 추가하세요. 이렇게 하면 클라비요의 요청이 보안 계층에 의해 차단되지 않습니다. 이러한 주소는 다음 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 으로 데이터를 가져오기하거나 웨어하우스를 아웃바운드 동기화 대상으로 설정할 수 있습니다.
SFTP를 통해 데이터 가져오기SFTP를 통해 데이터 가져오기
데이터 웨어하우스에서 Klaviyo 으로 데이터를 가져오려면 SFTP를 통해 가져올 수 있습니다.
으로 데이터를 가져오려면 Klaviyo 웨어하우스 대상을 처음 연결할 때 데이터 가져오기를 선택하거나 이미 연결이 설정되어 있는 경우 데이터 동기화 페이지에서 가져오기 버튼을 클릭합니다.
웨어하우스 데이터를 Klaviyo 로 가져오는 프로세스는 다음과 같습니다:
- 데이터 웨어하우스에서 원하는 데이터를 내보내세요.
- 로컬 머신에서 SSH 키를 생성합니다.
- SFTP 클라이언트 및 가져오기를 구성합니다.
여기서는 Snowflake를 예로 들었지만, 가져오기 프로세스는 창고 통합과 관계없이 비슷합니다.
데이터베이스 내보내기
먼저, 웨어하우스에서 데이터를 내보내야 합니다. 웨어하우스에 로그인하고 가져오려는 데이터를 Klaviyo 으로 내보내 CSV 파일로 만듭니다.
CSV 형식과 크기 제한에 따라 내보낸 데이터의 형식을 지정합니다.
로컬 머신에서 SSH 키 생성
웨어하우스에서 원하는 데이터를 내보낸 후에는 로컬 컴퓨터에서 새 SSH 키를 생성하고 SSH 키 Klaviyo 추가 버튼을 선택하여 에 추가합니다.
키를 추가할 때는 다음 중 하나로 시작해야 합니다:
- Ssh-ras
- Ecdsa-sha2
- Ssh-ed
- Sk-ecdsa
- SK-SSH
SFTP 클라이언트 구성 및 가져오기
SSH 키가 Klaviyo 에 성공적으로 추가되면 SFTP 클라이언트를 구성하고 데이터를 가져와야 합니다.
- SFTP 클라이언트를 열고 Klaviyo 에 제시된 자격 증명을 사용하여 새 연결을 구성합니다. SSH 키를 성공적으로 추가하면 자격 증명이 표시됩니다.
- 인증이 완료되면 데이터베이스를 가져오기 전에 권장 지침을 따르는지 확인하세요.
- 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 계정에 결제 프로필이 있어야 합니다.
이 스크립트에서 "서비스 계정 이메일" 이라는 자리 표시자를 BigQuery 서비스 계정 이메일로 바꿔야 합니다.
대상 설정이 완료되면 다음 자격 증명 세트를 사용하여 Klaviyo와 창고를 연결합니다:
- 이름: 이름: 이 목적지를 식별하는 데 도움이 되는 이름입니다.
- 프로젝트 ID: 프로젝트 ID라고 하며 API 콘솔에서 찾을 수 있습니다.
- 데이터 집합: 스키마라고도 합니다. 이는 설정을 위해 실행해야 하는 스크립트에서 사용한 이름과 동일합니다.
-
서비스 계정 키: BigQuery에서 서비스 계정을 만들 때 다운로드한 JSON 파일의 전체 내용을 붙여넣습니다.
Microsoft Azure Synapse 분석
Microsoft Azure를 대상으로 구성하려면 다음 스크립트를 실행하여 klaviyo_profile 및 klaviyo_event 테이블을 만듭니다.
- 이름: Azure의 데이터베이스와 동일한 이름을 사용하는 것이 좋습니다.
- 작업 영역: 작업 영역: Azure Synapse 작업 영역 이름입니다.
- 데이터베이스 이름: 전용 SQL 풀 데이터베이스를 식별합니다.
- 사용자 이름: 전용 SQL 풀 데이터베이스의 로그인 사용자 이름입니다.
- 데이터베이스 비밀번호:전용 SQL 풀 데이터베이스의 로그인 비밀번호입니다.
- 계정 이름: 사용자가 만든 Windows Azure 스토리지 계정 또는 DNS 접두사.
- 액세스 서명: Blob Storage 컨테이너에 대한 액세스를 증명하는 공유 액세스 서명(SAS) 문자열입니다.
-
컨테이너 이름: 데이터 전송을 위한 임시 준비 영역의 Azure Blob 컨테이너 이름입니다.
Snowflake
Snowflake를 대상으로 구성하려면 다음 스크립트를 실행하여 KLAVIYO_PROFILE 및 KLAVIYO_EVENT 테이블을 설정합니다. 아래 설정을 완료하려면 보안 관리자 권한과 시스템 관리자 권한이있어야 합니다. 어떤 역할이 있는지 확인하려면 SHOW GRANTS TO USER <your_username> 를 실행하여 두 역할이 모두 나열되어 있는지 확인합니다. 역할을 조정해야 하는 경우 시스템 관리자에게 문의하세요.
대상 설정이 완료되면 다음 자격 증명 세트를 사용하여 Klaviyo와 창고를 연결합니다:
- 이름: 스노우플레이크의 데이터베이스와 동일한 이름을 사용하는 것이 좋습니다.
-
사용자 이름: 데이터베이스에 연결할 사용자 이름입니다.
-
비밀번호: 데이터베이스에 연결하기 위한 비밀번호입니다.
- 창고: 눈송이 내 창고.
- 계정: 스노우플레이크의 계정입니다.
- 데이터베이스: 데이터베이스 이름입니다.
- 스키마: 데이터베이스 스키마.
동기화하려는 데이터 웨어하우스에 대한 자격 증명을 입력한 후, 클라비요에서 동기화할 데이터를 선택합니다.
데이터 개체데이터 개체
데이터 개체 섹션에서 각 옵션 옆의 해당 상자를 선택하여 모든 프로필 데이터, 특정 이벤트 데이터만 동기화하거나 두 가지 유형의 데이터를 모두 동기화하도록 선택할 수 있습니다.
클라비요는 데이터 웨어하우스로 데이터를 전송할 때 중첩된 JSON 구조를 사용합니다. 프로필과 이벤트는 각각 단일 테이블로 전송되므로 데이터 웨어하우스에 있는 수많은 잠재적 테이블 이름 대신 하나의 테이블을 대상으로 쿼리할 수 있습니다.
클라비요의 모든 데이터를 동기화하면 데이터 웨어하우스에서 추가 요금이 발생할 수 있습니다.
제외할 통합
제외할 연동 서비스 필드에서 데이터 웨어하우스 동기화에서 제외할 특정 연동 서비스를 선택할 수 있습니다. 이미 클라비요에 연결한 특정 연동 서비스의 데이터도 동기화에서 제거하려는 경우 유용합니다.
특정 통합 데이터를 제외하는 것은 이벤트 데이터에만 해당되며 프로필 데 이터는 제외하지 않습니다.
선택적 동기화
선택적 동기화 필드에서 클라비요에서 데이터 웨어하우스에 동기화할 특정 이벤트를 선택합니다. 기본적으로 모든 이벤트가 포함됩니다. 이 필드와 동기화하도록 특정 이벤트를 설정하면 선택한 이벤트만 동기화됩니다.
이 필드는 이벤트 데이터 개체 를 선택한 경우에만 표시됩니다.
데이터 동기화 빈도 선택
데이터 동기화 빈도 선택 섹션의 주기적 동기 화 주기 필드에 설정된 값은 클라비요에서 데이터 웨어하우스로 동기화할 빈도를 정의합니다.
주기적 동기화 케이던스는 기본적으로 매시간으로 설정되어 있으며 변경할 수 없습니 다.
동기화할 기록 데이터의 양을 선택합니다.
동기화할 기록 데이터의 양 선택 섹션에서 초기 연결 중에 Klaviyo에서 데이터 웨어하우스로 동기화할 기록 데이터의 양을 정의할 수 있습니다. 선택할 수 있습니다:
- 30일
- 90일
- 1 년
- 모든 시간
한 번에 많은 양의 데이터를 동기화할 경우 데이터 웨어하우스에서 추가 비용이 발생할 수 있습니다.
동기화 검토
연동 서비스를 연결한 후 설정이 성공하면 연결이 사용됨이라는 최종 화면과 함께 연결이 활성화되었음을 알리는 메시지가 표시됩니다:
- 설정한 동기화에 대한 세부 정보입 니다.
- 공유되는 데이터(프로필, 이벤트 또는 둘 다).
- 제외된 모든 통합.
동기화가 성공적으로 연결되지 않으면 연결할 수 없음 상태와 함께 연결을 다시 시도하거나 자격증명 정보를 수정할 수 있는 옵션이 표시됩니다.
데이터 웨어하우스 연결에 성공하면 기본 데이터 동기화 목록 페이지로 돌아옵니다. 여기에 표시됩니다:
- 창고 목적지
- 사용 상태
- 지난 24시간 동안 동기화에서 발생했을 수 있는 모든 잠재적 오류를 확인할 수 있습니다.
- 이 이벤트의 타임스탬프와 함께 발생한 마지막 동기화입니다.
하나의 목적지만 연결할 수 있으므로 이 목록 보기에는 하나의 목적지만 반영됩니다.
데이터 동기화 대시보드데이터 동기화 대시보드
연결에 성공하면 데이터 동기화 목록 페이지에서 통합을 클릭합니다. 여기에서 실행된 데이터 동기화에 대한 기록 및 현재 정보를 제공하는 데이터 동기화 대시보드로 이동합니다.
여기에서 동기화 정보가 두 개의 탭으로 나뉘어져 있는 것을 볼 수 있습니다:
- 역사
- 정기
역사
기록 탭에는 기록 데이터 동기화 상태를 보여주는 로그가 있습니다. 기록 동기화는 연결을 설정할 때 기존 데이터를 클라비요에서 데이터 웨어하우스로 동기화하는 것을 말합니다.
각 동기화에 대해 다음 정보가 표시됩니다:
-
이름
데이터가 동기화에 포함되는 중입니다. -
상태
동기화의 상태 및 잠재적 진행률과 예상 비율 또는 잠재적 오류를 표시합니다. 이러한 상태에는 다음이 포함될 수 있습니다:
-
완료됨
이 일회성 동기화에 대한 데이터 동기화가 완료되었습니다. 자동으로 다시 동기화되지 않습니다. -
예약됨
다음 동기화가 자동으로 실행되도록 예약된 경우입니다. -
진행 중
데이터가 데이터 웨어하우스에 활발하게 동기화되고 있으며 예상 완료 비율은 다음과 같습니다. -
오류 발생
오류가 발생했지만 클라비요가 연결을 다시 설정하려고 계속 시도합니다. 통합에 따라 이 시기는 약간 다를 수 있습니다. -
실패됨
연결을 다시 설정하려고 시도한 후에도 동기화가 완전히 실패했습니다. 즉, 구성 설정이나 데이터 웨어하우스 설정까 지 검토해야 합니다. -
일시 중지됨
동기화를 수동으로 일시 중지했습니다. -
사용안 함
연동 자체가 비활성화되었거나 제거되었기 때문에 동기화가 비활성화되었습니다.
-
완료됨
-
시작 시간
동기화 시작 시간입니다. -
에서 종료됨동기화 종료 시간.
정기
주기 탭에는 주기적 동기화 상태를 보여주는 로그가 있습니다. 고객이 브랜드와 계속 상호 작용하고 새로운 데이터가 생성되면, 이 데이터는 정기 적으로 데이터 웨어하우스로 전송됩니다. 데이터 웨어하우스 연결을 설정하면 1시간마다 주기적으로 동기화가 수행됩니다.
각 동기화에 대해 다음 정보가 표시됩니다:
-
이름
데이터가 동기화에 포함되는 중입니다. -
상태
동기화의 상태 및 잠재적 진행률과 예상 비율 또는 잠재적 오류를 표시합니다. 이러한 상태에는 다음이 포함될 수 있습니다:
-
완료됨
이 일회성 동기화에 대한 데이터 동기화가 완료되었습니다. 자동으로 다시 동기화되지 않습니다. -
예약됨
다음 동기화가 자동으로 실행되도록 예약된 경우입니다. -
진행 중
데이터가 데이터 웨어하우스에 활발하게 동기화되고 있으며 예상 완료 비율은 다음과 같습니다. -
오류 발생
오류가 발생했지만 클라비요가 연결을 다시 설정하려고 계속 시도합니다. 통합에 따라 이 시기는 약간 다를 수 있습니다. -
실패됨
연결을 다시 설정하려고 시도한 후에도 동기화가 완전히 실패했습니다. 즉, 구성 설정이나 데이터 웨어하우스 설정까지 검토해야 합니다. -
일시 중지됨
동기화를 수동으로 일시 중지했습니다. -
사용안 함
연동 자체가 비활성화되었거나 제거되었기 때문에 동기화가 비활성화되었습니다.
-
완료됨
-
데이터 최신성
데이터 최신성은 데이터가 얼마나 최신 상태인지를 나타냅니다. 예를 들어, 동기화의 최신성이 2분인 경우, 이는 지난 2분 동안 클라비요에서 생성된 새 데이터가 아직 데이터 웨어하우스에 없다는 것을 의미합니다. - 개별 동기화를 일시 중지, 재개 및 다시 활성화하는 버튼입니다.
데이터 웨어하우스 연결 제거
클라비요 계정에서 데이터 웨어하우스 연결을 삭제하려면 왼쪽 하단의 계정 메뉴에서 클라비요의 연동 페이지로 이동합니다.
연동 페이지에서 데이터 웨어하우스 연동 옆의 메뉴를 열고 연동 제거를 선택하여 연결을 제거합니다.
오류 로그 보기오류 로그 보기
클라비요와 데이터 웨어하우스 간의 데이터 동기화에 문제가 있는 경우 관련 오류 로그를 확인하면 문제의 원인에 대한 추가 정보를 얻을 수 있습니다.
오류를 보려면 동기화 페이지에서 창고 대상을 클릭합니다. 기록 동기화 및 주기적 동기화 탭 모두에서 내보내기 목록과 해당 상태, 그리고 활성 오류 여부를 보여주는 표시기를 볼 수 있습니다.
특정 오류에 대한 자세한 내용을 보려면 오류가 발생한 내보내기를 클릭하세요.
여기에는 동기화 상태에 따라 오류 또는 성공 메시지와 함께 아웃바운드 동기화의 타임라인이 표시됩니다.
특정 오류를 클릭하면 다음 정보가 담긴 서랍이 열립니다:
-
요약
데이터 웨어하우스에서 반환된 오류에 대한 간략한 설명입니다. -
코드
오류에 대한 오류 코드입니다. -
외부 메시지
데이터 웨어하우스에서 반환한 실제 오류 메시지입니다. -
날짜
오류가 발생한 날짜와 시간입니다.