Square 데이터 참조

학습 내용

Square에서 Klaviyo로 동기화되는 데이터, 이를 확인하는 방법, 그리고 Square 이벤트에 포함된 속성을 알아보세요. 또한 Klaviyo에서 Square 데이터를 확인하는 방법을 알아보세요.

시작하기 전에 알아야 할 것

아직 연동을 위한 단계별 지침을 확인하지 않았다면 이 문서를 계속 읽기 전에 Square 시작하기 문서를 읽어보시기 바랍니다.

데이터를 확인하는 방법

Square에서 Klaviyo로의 데이터 동기화를 확인하려면:

1. Klaviyo 계정에서 연동 탭을 선택해 주세요.
2. 활성화된 연동 목록에서 Square 를 선택하세요.
3. 상단에서 데이터 탭을 선택하세요.

여기에서 Square에서 Klaviyo로 동기화된 최근 데이터와 과거 데이터 동기화의 동기화 진행률 표시줄을 확인할 수 있어요.

동기화에 문제가 발생하면 여기에서 가져오기 재시작을 선택하여 과거 데이터 동기화를 다시 시작할 수 있어요.

Square에서 동기화된 데이터

Square Online의 이벤트는 실시간으로 Klaviyo에 동기화되며, Square POS의 이벤트는 30분마다 동기화돼요.

Square에서 Klaviyo로 동기화되는 데이터에는 다음이 포함돼요:

• 알려진 사이트 방문자가 사이트에서 활성 이벤트로 추적돼요(온사이트 JavaScript 설정을 선택된 상태로 두었다면).
• 이메일 구독 취소
• 주문 이벤트와 연결된 고객 정보
• Square 카탈로그(POS 전용 항목 포함)
• 다음 이벤트:
  • 중단된 결제
  • '완료된 주문'
  • '주문한 제품'
  • '환불된 주문'
  • '취소된 주문'
  • 주문 부분 처리
  • '처리된 주문'

Square POS 주문 이벤트는 고객이 회사에 직접 공유한 이메일 주소 및/또는 전화번호가 주문에 연결되어 있는 경우 Klaviyo로 동기화되며(Klaviyo 프로필이 생성됩니다).

Square 이벤트에는 소스 이름 이라는 속성이 있어 이벤트가 POS에서 발생했는지 또는 온라인/웹에서 발생했는지를 표시하므로, Klaviyo에서 이러한 이벤트를 세그먼트로 나눌 수 있어요.

고객 정보 세부 정보

고객이 회사에 직접 공유한 이메일 주소 및/또는 전화번호가 고객과 연결되어 있는 경우 고객 프로필이 Square에서 Klaviyo로 동기화돼요. Square에서 Klaviyo로 동기화된 프로필은 다음 속성과 함께 생성돼요.

• 이메일
  고객의 이메일 주소
• 이름
  고객 이름(필수)
• 성
  고객의 성
• 도시
  고객의 도시
• 주/지역
  고객의 주
• 우편번호
  고객의 우편번호
• 국가
  고객 국가
• 전화번호
  고객의 전화번호예요. Klaviyo는 Klaviyo SMS를 설정한 경우에만 전화번호 전용 프로필을 만들어요.
• 생일
  제공된 경우 고객의 생년월일
• Square 그룹
  고객과 연결된 Square 그룹입니다. 여기에는 현재 Square 세그먼트가 포함되지 않아요.

이메일 동의

Square 플랫폼은 “옵트아웃” 마케팅 동의 플랫폼이에요. 즉, 이메일 주소를 제공한 사람에게 이메일 마케팅에 명시적으로 동의할 기회가 주어지지 않았다는 뜻이에요. 대신 Klaviyo는 Square에서 email_unsubscribed가 false로 설정된 사용자를 Klaviyo에서 “Never Subscribed”로 표시하고, Square에서 email_unsubscribed가 true로 설정된 사용자를 Klaviyo에서 “구독 취소”로 표시해요.

SMS 동의

Square Online에서 수집된 SMS 구독자는 현재 Klaviyo로 동기화할 수 없어요. Square 사이트에서 Klaviyo 양식을 통해 SMS 동의를 수집할 수 있어요.

카탈로그 항목 세부 정보

카탈로그 항목은 다음 속성과 함께 Square에서 Klaviyo로 동기화돼요.

• 항목 이름
• 항목 ID
• 항목 설명
• 항목 가격
• SKU
• URL
• 이미지 URL
• 재고 수량
• 재고 정책
• 카테고리
• 게시 완료
• 변형

동기화된 이벤트 및 해당 속성

중단된 결제

이 이벤트는 Square Online 스토어에서 장바구니가 이탈된 후 1시간 뒤에 트리거되며, 장바구니 이탈 플로우에서 사용할 수 있어요.

이 이벤트가 Klaviyo에 동기화되려면 먼저 Square에서 장바구니 이탈 이메일을 꺼야 해요. 그렇게 하려면:

1. Square에 로그인한 다음 개요 페이지로 이동해 주세요.
2. 커뮤니케이션 > 장바구니 이탈을 선택해 주세요.
3. 비활성화를 선택해 주세요.

Klaviyo에서 이 이벤트의 최상위 속성은 다음과 같아요:

• $value
  장바구니 총액
• 항목
  주문에 포함된 항목
• 컬렉션
  주문에 포함된 항목에 연결된 컬렉션
• 품목 수
  주문에 포함된 총 품목 수

'완료된 주문'

이 이벤트는 Square Online 스토어 또는 POS 단말기에서 주문 이벤트가 발생할 때 트리거돼요.

Klaviyo에서 이 이벤트의 최상위 속성은 다음과 같아요:

• $value
  주문의 총액
• 항목
  주문에 포함된 항목
• 컬렉션
  주문에 포함된 항목에 연결된 컬렉션
• 품목 수
  주문에 포함된 총 품목 수
• 할인 코드
  주문에 적용된 할인 코드
• 총 할인
  총 할인 금액
• 소스 이름
  주문의 출처(Square Online, POS)
• 위치 이름
  Square 위치 이름

'주문한 제품'

이 이벤트는 Square Online 스토어 또는 POS 단말기에서 주문 이벤트가 생성될 때 트리거됩니다. 주문한 제품 이벤트는 주문 생성의 각 품목에 대해 트리거됩니다.

Klaviyo에서 이 이벤트의 최상위 속성은 다음과 같아요:

• $value
  주문의 총액
• 이름
  주문한 제품의 이름
• 같은 이메일의 다른 버전 이름
  제품 같은 이메일의 다른 버전의 이름
• SKU
  제품 SKU
• 제품 ID
  제품 식별자
• 같은 이메일의 다른 버전 ID
  같은 이메일의 다른 버전 식별자
• 수량
  제품 수
• 컬렉션
  제품에 연결된 컬렉션
• 같은 이메일의 다른 버전 옵션
  주문한 제품의 같은 이메일의 다른 버전 옵션
• 수정자 옵션
  주문에 적용된 수정자 옵션

'환불된 주문'

이 이벤트는 Square Online 스토어 또는 POS 단말기에서 주문이 환불될 때 트리거돼요.

Klaviyo에서 이 이벤트의 최상위 속성은 다음과 같아요:

• $value
  주문의 총액
• 영수증 URL
  주문 영수증의 URL
• 소스 이름
  주문의 출처(Square Online, POS)
• 위치 이름
  Square 위치 이름

'취소된 주문'

이 이벤트는 고객이 스토어에서 주문을 생성한 다음 주문 전체를 취소할 때 트리거돼요. Klaviyo가 추적하는 이벤트에는 제품 이름과 이미지를 포함해, 누군가 구매한 항목에 대한 모든 제품 정보가 포함돼요. 부분 취소는 지원되지 않아요.

Klaviyo에서 이 이벤트의 최상위 속성은 다음과 같아요:

• $value
  주문의 총액
• 항목
  주문에 포함된 항목
• 컬렉션
  주문에 포함된 항목에 연결된 컬렉션
• 품목 수
  주문에 포함된 총 품목 수
• 할인 코드
  주문에 적용된 할인 코드
• 총 할인
  총 할인 금액
• 소스 이름
  주문의 출처(Square Online, POS)
• 위치 이름
  Square 위치 이름

주문 부분 처리

주문이 여러 번에 걸쳐 배송되는 경우 부분 주문 처리 완료 이벤트가 기록되며, 각 부분 처리 완료마다 이벤트가 1개씩 기록돼요.

Klaviyo에서 이 이벤트의 최상위 속성은 다음과 같아요:

• $value
  이행의 총 금액
• 품목
  이행에 포함된 품목
• 컬렉션
  이행에 포함된 항목에 연결된 컬렉션
• 항목 수
  풀필먼트에 포함된 항목의 총 개수
• 할인 코드
  주문에 적용된 할인 코드
• 총 할인
  총 할인 금액
• 소스 이름
  주문의 출처(Square Online, POS)
• 위치 이름
  Square 위치 이름

'처리된 주문'

이 이벤트는 Square Online 스토어 또는 POS 단말기에서 주문이 이행될 때 트리거돼요. 주문에 연결된 이행이 여러 개라면 마지막 이행에서 이행된 주문 이벤트가 기록돼요.

Klaviyo에서 이 이벤트의 최상위 속성은 다음과 같아요:

• $value
  주문의 총액
• 항목
  주문에 포함된 항목
• 컬렉션
  주문에 포함된 항목에 연결된 컬렉션
• 품목 수
  주문에 포함된 총 품목 수
• 할인 코드
  주문에 적용된 할인 코드
• 총 할인
  총 할인 금액
• FulfillmentStatus
  이행 상태
• 소스 이름
  주문의 출처(Square Online, POS)
• 위치 이름
  Square 위치 이름

추가 자료