Klaviyo 전송 소개

Klaviyo용 BigQuery Data Transfer Service 커넥터를 사용하여 Klaviyo에서 BigQuery로 데이터를 로드할 수 있습니다. BigQuery Data Transfer Service를 사용하면 Klaviyo의 최신 데이터를 BigQuery에 추가하는 반복 전송 작업을 예약할 수 있습니다.

Klaviyo 전송을 예약하는 방법을 알아보려면 BigQuery로 Klaviyo 데이터 로드를 참고하세요.

제한사항

증분 Klaviyo 전송에는 다음과 같은 제한사항이 적용됩니다.

  • TIMESTAMP 열만 워터마크 열로 선택할 수 있습니다.
  • 증분 수집은 유효한 워터마크 열이 있는 애셋에만 지원됩니다.
  • 워터마크 열의 값은 단조 증가해야 합니다.
  • 증분 전송은 소스 테이블의 삭제 작업을 동기화할 수 없습니다.
  • 단일 전송 구성은 증분 수집 또는 전체 수집만 지원할 수 있습니다.
  • 첫 번째 증분 수집 실행 후에는 asset 목록의 객체를 업데이트할 수 없습니다.
  • 첫 번째 증분 수집 실행 후에는 전송 구성에서 쓰기 모드를 변경할 수 없습니다.
  • 첫 번째 증분 수집 실행 후에는 워터마크 열 또는 기본 키를 변경할 수 없습니다.
  • 대상 BigQuery 테이블은 제공된 기본 키를 사용하여 클러스터링되며 클러스터링된 테이블 제한사항이 적용됩니다.
  • 기존 전송 구성을 증분 수집 모드로 처음 업데이트하면 업데이트 후 첫 번째 데이터 전송에서 데이터 소스의 사용 가능한 모든 데이터가 전송됩니다. 이후의 증분 데이터 전송에서는 데이터 소스의 새 행과 업데이트된 행만 전송됩니다.

데이터 수집 옵션

이 섹션에서는 Klaviyo 데이터 전송을 설정하기 위한 데이터 수집 옵션을 설명합니다.

전체 또는 증분 전송

Klaviyo 전송을 설정할 때 전송 구성에서 전체 또는 증분 쓰기 환경설정을 선택하여 데이터가 BigQuery에 로드되는 방법을 지정합니다. 증분 전송은 미리보기에서 지원됩니다.

각 데이터 전송으로 전체 데이터 전송을 구성하여 Klaviyo 데이터 세트의 모든 데이터를 전송할 수 있습니다.

또는 각 데이터 전송으로 전체 데이터 세트를 로드하는 대신 마지막 데이터 전송 이후 변경된 데이터만 전송하도록 증분 데이터 전송([미리보기](https://cloud.google.com/products#product-launch-stages))을 구성할 수 있습니다. 데이터 전송에 대해 증분 을 선택하는 경우 증분 데이터 전송 중에 BigQuery에 데이터가 기록되는 방법을 정의하려면 추가 또는 삽입/업데이트 쓰기 모드를 지정해야 합니다. 다음 섹션에서는 사용 가능한 쓰기 모드를 설명합니다.

추가 쓰기 모드

추가 쓰기 모드는 대상 테이블에 새 행만 삽입합니다. 이 옵션은 기존 레코드를 확인하지 않고 전송된 데이터를 엄격하게 추가하므로 이 모드는 대상 테이블에서 데이터 중복을 일으킬 수 있습니다.

추가 모드를 선택할 때는 워터마크 열을 선택해야 합니다. Klaviyo 커넥터가 소스 테이블의 변경사항을 추적하려면 워터마크 열이 필요합니다.

Klaviyo 전송의 경우 레코드가 생성될 때만 업데이트되고 후속 업데이트로 변경되지 않는 열(예: CREATED_AT 열)을 선택하는 것이 좋습니다.

삽입/업데이트 쓰기 모드

삽입/업데이트 쓰기 모드는 기본 키를 확인하여 대상 테이블에서 행을 업데이트하거나 새 행을 삽입합니다. 기본 키를 지정하여 Klaviyo 커넥터가 대상 테이블을 소스 테이블과 최신 상태로 유지하는 데 필요한 변경사항을 결정하도록 할 수 있습니다. 데이터 전송 중에 지정된 기본 키가 대상 BigQuery 테이블에 있으면 Klaviyo 커넥터가 소스 테이블의 새 데이터로 해당 행을 업데이트합니다. 데이터 전송 중에 기본 키가 없으면 Klaviyo 커넥터가 새 행을 삽입합니다.

삽입/업데이트 모드를 선택할 때는 워터마크 열과 기본 키를 선택해야 합니다.

  • Klaviyo 커넥터가 소스 테이블의 변경사항을 추적하려면 워터마크 열이 필요합니다.
    • 행이 수정될 때마다 업데이트되는 워터마크 열을 선택합니다. UPDATED_AT 또는 LAST_MODIFIED 열과 유사한 열을 사용하는 것이 좋습니다.

  • 기본 키는 Klaviyo 커넥터가 행을 삽입하거나 업데이트해야 하는지 결정하는 데 필요한 테이블의 하나 이상의 열일 수 있습니다.

    테이블의 모든 행에서 고유한 null이 아닌 값을 포함하는 열을 선택합니다. 시스템 생성 식별자, 고유 참조 코드 (예: 자동 증가 ID) 또는 변경 불가능한 시간 기반 시퀀스 ID를 포함하는 열을 사용하는 것이 좋습니다.

    데이터 손실 또는 데이터 손상을 방지하려면 선택한 기본 키 열에 고유한 값이 있어야 합니다. 선택한 기본 키 열의 고유성에 의문이 있는 경우 추가 쓰기 모드를 대신 사용하는 것이 좋습니다.

데이터 유형 매핑

다음 표는 Klaviyo 데이터 유형을 해당하는 BigQuery 데이터 유형에 매핑합니다.

Klaviyo 데이터 유형 BigQuery 데이터 유형
String STRING
Text STRING
Integer INTEGER
Boolean BOOLEAN
Date (YYYY-MM-DD HH:MM:SS) TIMESTAMP
List ARRAY

가격 책정

이 기능이 미리보기 상태인 동안에는 Klaviyo 데이터를 BigQuery로 전송하는 데 비용이 들지 않습니다.

다음 단계