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

학습 내용

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

시작하기 전 안내 사항

연결하려는 데이터 웨어하우스가 대상으로 구성되어 있는지 확인해야 합니다. 올바르게 설정했는지 확인하려면 다음과 같이 하세요:

• Klaviyo 에 제공된 사용자에게 올바른 권한이 있는지 확인합니다.
• 창고에 따라 아래 표시된 대로 적절한 이름으로 테이블을 설정해야 합니다.

또한 클라비요의 아웃바운드 데이터 웨어하우스 트래픽 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를 통해 데이터 가져오기

데이터 웨어하우스에서 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 클라이언트를 통해 데이터베이스 파일을 업로드하고 검토하세요.

또한 최근 가져오기 목록 보기에 다음 정보가 표시됩니다:

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

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

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

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

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

동기화하려는 데이터 웨어하우스에 대한 자격 증명을 입력한 후, 클라비요에서 동기화할 데이터를 선택합니다. 

데이터 개체 

데이터 개체 섹션에서 각 옵션 옆의 해당 상자를 선택하여 모든 프로필 데이터, 특정 이벤트 데이터만 동기화하거나 두 가지 유형의 데이터를 모두 동기화하도록 선택할 수 있습니다.

제외할 통합

제외할 연동 서비스 필드에서 데이터 웨어하우스 동기화에서 제외할 특정 연동 서비스를 선택할 수 있습니다. 이미 클라비요에 연결한 특정 연동 서비스의 데이터도 동기화에서 제거하려는 경우 유용합니다.

선택적 동기화

선택적 동기화 필드에서 클라비요에서 데이터 웨어하우스에 동기화할 특정 이벤트를 선택합니다. 기본적으로 모든 이벤트가 포함됩니다. 이 필드와 동기화하도록 특정 이벤트를 설정하면 선택한 이벤트만 동기화됩니다. 

데이터 동기화 빈도 선택

데이터 동기화 빈도 선택 섹션의 주기적 동기 화 주기 필드에 설정된 값은 클라비요에서 데이터 웨어하우스로 동기화할 빈도를 정의합니다. 

동기화할 기록 데이터의 양을 선택합니다. 

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

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

동기화 검토

연동 서비스를 연결한 후 설정이 성공하면 연결이 사용됨이라는 최종 화면과 함께 연결이 활성화되었음을 알리는 메시지가 표시됩니다: 

• 설정한 동기화 세부 정보
• 공유되는 데이터(프로필, 이벤트 또는 둘 다)
• 제외된 모든 연동

동기화가 성공적으로 연결되지 않으면 연결할 수 없음 상태와 함께 연결을 다시 시도하거나 자격증명 정보를 수정할 수 있는 옵션이 표시됩니다.

데이터 웨어하우스 연결에 성공하면 기본 데이터 동기화 목록 페이지로 돌아옵니다. 여기에 표시됩니다:

• 창고 목적지 
• 사용 상태
• 지난 24시간 동안 동기화에서 발생했을 수 있는 모든 잠재적 오류
• 이 이벤트의 타임스탬프와 함께 발생한 마지막 동기화입니다.

하나의 목적지만 연결할 수 있으므로 이 리스트 보기에는 하나의 목적지만 반영됩니다.

데이터 동기화 대시보드

연결에 성공하면 데이터 동기화 목록 페이지에서 통합을 클릭합니다. 여기에서 실행된 데이터 동기화에 대한 기록 및 현재 정보를 제공하는 데이터 동기화 대시보드로 이동합니다.

여기에서 동기화 정보가 두 개의 탭으로 나뉘어져 있는 것을 볼 수 있습니다:

• 역사
• 정기

역사 

기록 탭에는 기록 데이터 동기화 상태를 보여주는 로그가 있습니다. 기록 동기화는 연결을 설정할 때 기존 데이터를 클라비요에서 데이터 웨어하우스로 동기화하는 것을 말합니다. 

각 동기화에 대해 다음 정보가 표시됩니다: 

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

정기

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

각 동기화에 대해 다음 정보가 표시됩니다: 

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

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

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

데이터 웨어하우스 연동 옆의 메뉴를 열고 '연동 제거'를 선택하여 연결을 제거합니다.

오류 로그 보기 

클라비요와 데이터 웨어하우스 간의 데이터 동기화에 문제가 있는 경우 관련 오류 로그를 확인하면 문제의 원인에 대한 추가 정보를 얻을 수 있습니다. 

오류를 보려면 동기화 페이지에서 창고 대상을 클릭합니다. 기록 동기화 및 주기적 동기화 탭 모두에서 내보내기 목록과 해당 상태, 그리고 활성 오류 여부를 보여주는 표시기를 볼 수 있습니다.

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

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

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

• 요약
  데이터 웨어하우스에서 반환된 오류에 대한 간략한 설명입니다. 
• 코드
  오류에 대한 오류 코드입니다.
• 외부 메시지
  데이터 웨어하우스에서 반환되는 실제 오류 메시지
• 날짜
  오류가 발생한 날짜와 시간

추가 자료 

클라비요와 앱 간에 정보가 교환되는 방식 이해하기

클라비요와 앱 간에 교환되는 정보 유형 이해하기