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

학습 내용

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

This content requires Functional cookies to be enabled.

Update Cookie Settings

시작하기 전에 알아야 할 것

Klaviyo에서 데이터를 내보내기 전에 데이터 웨어하우스를 대상(목적지)으로 설정해 주세요:

• 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

데이터 웨어하우스에 연결

1. 데이터 관리 > 동기화로 이동해 주세요. 이미 연결이 있으면 동기화 만들기를 클릭해 주세요.
2. 데이터 웨어하우스로 데이터 내보내기를 선택하세요.
3. 웨어하우스를 선택한 다음 설정 페이지에서 [warehouse name]에 연결을 클릭해 주세요.

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

데이터 웨어하우스에서 데이터 가져오기 옵션을 선택하면 직접 데이터 웨어하우스 가져오기가 설정돼요. SFTP를 통해 CSV 파일을 업로드하려면 다음 섹션을 따라 주세요.

SFTP를 통해 데이터 가져오기

데이터 웨어하우스의 데이터를 Klaviyo로 가져오려면 SFTP를 통해 가져올 수 있어요. 데이터 웨어하우스에 직접 연결하려면 Klaviyo에서 데이터 웨어하우스 가져오기 이해하기를 참고해 주세요.

연동으로 이동한 다음 데이터 관리 > SFTP 데이터 전송을 열고, SFTP 설정 탭을 선택해 주세요.

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

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

데이터베이스 내보내기

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

로컬 머신에서 SSH 키 생성

로컬 컴퓨터에서 새 SSH 키 쌍을 생성해 주세요. SFTP 클라이언트용 비공개 키는 보관해 주세요.

1. SFTP 설정에서 SSH 키 추가를 클릭해 주세요. 키 제목을 입력하고 공개 키를 SSH 키에 붙여넣어 주세요.
2. 키 추가를 클릭해 주세요.

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

Klaviyo에 공개 키를 추가한 후 SFTP 클라이언트를 구성하고 CSV 파일을 업로드해 주세요.

1. SFTP 설정에서 SFTP 자격 증명 아래에 표시된 서버, 포트, 사용자 이름을 사용해 SFTP 클라이언트에서 연결을 생성해 주세요. 일치하는 개인 키로 인증해 주세요.
2. 업로드하기 전에, CSV 파일이 위에 링크된 권장 형식 가이드라인을 따르는지 확인해 주세요.
3. SFTP 클라이언트를 통해 CSV 파일을 업로드해 주세요.

가져오기를 확인하려면 SFTP 데이터 전송에서 데이터 가져오기 탭을 여세요. 최근 가져오기 에는 다음이 표시돼요:

• 상태
  대기열에 있음, 처리 중, 완료됨, 실패함 또는 취소됨. 완료된 가져오기에도 오류가 포함될 수 있어요.
• 처리된 행
  현재까지 처리된 파일의 비율이에요. 가져오기를 펼쳐서 처리된 행 수와 건너뛴 행 수를 확인해 보세요.
• 가져오기 날짜
  가져온 날짜.
• 가져온 사용자
  데이터를 가져온 사용자입니다.

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

데이터 웨어하우스를 대상(목적지)으로 구성하려면 각 데이터 웨어하우스마다 다음 정보 및 자격 증명 세트가 필요해요.

Amazon Redshift

Amazon Redshift를 대상(Destination)으로 구성하려면 다음 스크립트를 실행하여 klaviyo_event, klaviyo_profile, klaviyo_metric 테이블을 생성하세요.

실행하기 전에 데이터베이스 관리자에게 이 예시를 환경에 맞게 조정하도록 요청하세요. 자리 표시자를 바꾸고, 시작 부분 근처에 있는 짝이 맞지 않는 */를 수정한 다음, 테이블을 만든 후 테이블별 GRANT 문을 실행하세요.

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

• 이름: 이 연결을 식별하는 데 도움이 되는 이름입니다. Redshift 데이터베이스와 동일한 이름을 사용할 수 있어요.
• 호스트 URL: Amazon Redshift 서버의 엔드포인트( Redshift에서 연결 URL이라고 함)
• 데이터베이스: Klaviyo에서 연결할 Redshift 데이터베이스 이름
• 포트: Redshift에서 사용하는 포트 번호
• 스키마: 데이터베이스 스키마
• 사용자 이름: Redshift에 로그인할 때 사용되는 사용자 이름
• 데이터베이스 비밀번호: Redshift에 로그인하는 데 사용하는 비밀번호
  

Amazon S3

Amazon S3를 대상 위치로 구성하려면 버킷 이름, 버킷 리전, AWS 액세스 자격 증명을 미리 준비해 주세요.

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

• 이름: 이 연결을 식별하는 데 도움이 되는 이름입니다.
• 버킷: 버킷 이름입니다.
• 버킷 위치: 스토리지 버킷을 만들 때 선택한 지역 이름입니다.
• 액세스 키 ID: AWS 액세스 키 ID입니다.
• 비밀 액세스 키: AWS 비밀 액세스 키입니다.
  

Google BigQuery

Google BigQuery를 목적지로 구성하려면 다음 스크립트를 실행하여 klaviyo_profile, klaviyo_event, klaviyo_metric 테이블을 설정해 주세요. 연결 프로세스가 성공적으로 진행되려면 Google BigQuery 계정에 결제 프로필이 있어야 해요.

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

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

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

Microsoft Azure Synapse Analytics

Microsoft Azure를 대상으로 구성하려면 다음 스크립트를 실행해 klaviyo_profile, klaviyo_event 및 klaviyo_metric 테이블을 생성해 주세요. 실행하기 전에 데이터베이스 관리자가 예제를 조정하도록 해 주세요. 예제는 DROP TABLE 문으로 시작하며, 중복된 DROP TABLE klaviyo_profile도 포함되어 있어요. 새 테이블을 생성할 때, 또는 기존 데이터를 유지해야 하는 경우에는 DROP TABLE 문을 제거해 주세요.

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

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

Snowflake

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

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

textCopy

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

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

textCopy

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

3. 다음 스크립트를 실행하여 KLAVIYO_PROFILE, KLAVIYO_EVENT, KLAVIYO_METRIC 테이블을 설정해 주세요. 아래 설정을 완료하려면 securityadmin 및 sysadmin 권한이 있어야 해요. 보유한 역할(role)을 확인하려면 SHOW GRANTS TO USER <your_username>를 실행하고, 두 역할이 모두 목록에 표시되는지 확인해 주세요. 역할을 조정해야 한다면 시스템 관리자에게 문의해 주세요. 스크립트를 실행하기 전에 SET_ 자리표시자를 해당 값으로 바꾸고, GENERATE_PUBLIC_KEY는 생성한 공개 키로 바꿔 주세요. 이 스크립트는 CREATE OR REPLACE TABLE을 사용하며, 같은 이름의 기존 테이블이 있으면 해당 테이블을 대체해요. 기존 데이터를 유지해야 한다면 새 데이터베이스를 사용하거나, 관리자가 해당 구문을 조정하도록 해 주세요.

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

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

Databricks

설정 스크립트, 필요한 권한, 연결 자격 증명을 포함해 Databricks를 대상(destination)으로 구성하려면 Klaviyo 데이터를 Databricks로 내보내는 방법의 단계를 따라 주세요.

연결 양식에 Blob 스토어 섹션이 표시되면, 이를 사용해 내보내기의 스토리지를 구성해 주세요. 웨어하우스 대상의 경우, 이 스토리지는 데이터를 웨어하우스에 로드하기 전에 스테이징합니다. Amazon S3의 경우, 이는 내보내기 대상입니다.

1. 저장된 스토어를 사용하려면 표시되는 경우 blob 구성 사용을 선택한 다음, 호환되는 Blob 스토어를 선택해 주세요. blob 구성 사용을 선택하지 않으면 위에 나열된 연결 세부 정보로 계속 진행해 주세요. Klaviyo에서 Blob 스토어가 필요하면 계속하기 전에 하나를 선택해 주세요.
2. 스토어를 추가하려면 Blob 저장소 드롭다운에서 만들기를 선택해 주세요. 메시지가 표시되면 제공업체를 선택하고 연결 세부 정보를 입력한 다음 만들기를 클릭해 주세요.
3. 스토리지 구성 이름 필드가 표시되면 웨어하우스에서 생성한 스토리지 구성 이름을 입력해 주세요.
4. Amazon S3 대상의 경우, 해당 제어가 표시되면 파일 형식과 내보낸 파일 압축 여부를 선택해 주세요.

연결 세부 정보를 입력한 후 다음을 클릭해 주세요. 그런 다음 내보내기에 사용할 데이터와 예약 일정을 선택해 주세요.

데이터 개체

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

제외할 연동 서비스

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

선택적 동기화

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

데이터 동기화 빈도 선택

데이터 동기화 빈도 선택에서 매의 간격을 선택해 주세요: 1, 2, 4, 6, 12 또는 24시간. 일정에 사용할 시작 날짜, 시작 시간, 시간대를 설정해 주세요.

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

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

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

후기 동기화

다음을 클릭해 검토를 여세요. 연결 세부정보와 내보내기 설정을 확인해 주세요. 여기에는 다음이 포함돼요:

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

연결을 클릭해 연결을 저장하고 일정에 따라 동기화를 시작하세요.

Klaviyo에 연결할 수 없음이 표시되면 자격 증명 편집을 클릭해 연결 정보를 수정한 다음 검토로 돌아가 연결을 다시 클릭하세요.

연결이 저장되면 Klaviyo에서 데이터 동기화로 돌아가요. 연결 테이블에는 다음이 표시돼요:

• 웨어하우스
• 유형: 가져오기 또는 내보내기
• 생성한 날짜:

내보내기 대상과 직접 가져오기 연결은 동일한 표에 표시돼요. 구분하려면 유형을 확인해 주세요.

데이터 동기화 대시보드

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

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

• 과거 기록
• 정기

과거 기록

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

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

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

정기

정기 탭에는 진행 중인 동기화 상태가 표시돼요. 고객이 계속해서 브랜드와 상호작용하고 새로운 데이터가 생성되면, 선택한 일정에 따라 데이터 웨어하우스로 전송돼요. 각 실행이 완료되면, Klaviyo가 다음 실행을 예약해요.

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

• 이름
  동기화에 포함되는 데이터예요.
• 상태
  동기화의 현재 상태와 모든 오류예요. 이러한 상태에는 다음이 포함될 수 있어요:
  • 예약됨
    동기화가 다음 예약된 실행을 기다리고 있어요.
  • 동기화 중
    데이터가 데이터 웨어하우스로 동기화되고 있어요.
  • 오류 발생
    오류가 발생했지만 Klaviyo에서 연결을 다시 설정하기 위해 계속 시도합니다. 연동에 따라 이 타이밍이 약간 다를 수 있습니다.
  • 실패
    연결을 다시 설정하려고 시도한 후에도 동기화가 완전히 실패했어요. 즉, 구성 설정 또는 데이터 웨어하우스 설정을 검토해야 해요. 문제를 해결한 후 동기화에 대해 다시 활성화를 클릭해 주세요.
  • 일시 중지됨
    동기화를 수동으로 일시 중지했습니다.
  • 취소됨
    동기화가 취소되어 더 이상 예약되지 않아요.
• 데이터 최신성
  데이터 최신성은 데이터가 얼마나 최신 상태인지 의미해요. 예를 들어, 최신성이 2분이라면 동기화가 대략 2분 전까지의 데이터를 처리했다는 뜻이에요. 더 최신 데이터는 아직 동기화를 기다리고 있을 수 있어요.
• 일시 중지, 재개, 개별 동기화 다시 활성화 버튼.

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

1. 연동으로 이동해 주세요.
2. 데이터 웨어하우스 연동 옆에 있는 메뉴를 열고 연동 제거를 선택해 주세요. 확인 대화 상자에서 연동 제거를 다시 클릭해 주세요.

오류 로그 보기

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

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

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

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

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

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

추가 자료