---
title: "Square 데이터 참조"
description: "Square에서 Klaviyo로 동기화되는 데이터, 이를 확인하는 방법, 그리고 Square 이벤트에 포함된 속성을 알아보세요. 또한 Klaviyo에서 Square 데이터를 확인하는 방법을 알아보세요."
canonical_url: "https://help.klaviyo.com/hc/ko-kr/articles/11117271030555"
markdown_url: "https://help.klaviyo.com/hc/ko-kr/articles/11117271030555.md"
locale: "ko-kr"
category: "연동"
section: "Square"
updated: "2025-10-27"
---

# Square 데이터 참조

## 학습 내용

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

## 시작하기 전에 알아야 할 것

아직 연동을 위한 단계별 지침을 확인하지 않았다면 이 문서를 계속 읽기 전에 [Square 시작하기](https://help.klaviyo.com/hc/ko-kr/articles/11117215837211.md) 문서를 읽어보시기 바랍니다.

## 데이터를 확인하는 방법

Square 연동이 활성화되어 있는지 확인해 주세요. Square에서 Klaviyo로 데이터가 동기화되는지 확인하려면:

1. Klaviyo 계정 왼쪽 탐색 메뉴에서 **연동**을 선택해 주세요.

2. 리스트에서 **Square**를 선택합니다.

3. 상단에서 **데이터** 탭을 선택하세요.



여기에서 Square에서 Klaviyo로 동기화된 최신 데이터를 확인할 수 있으며, 과거 데이터 동기화가 진행되는 동안 진행률 표시줄이 표시돼요.

![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/f92fe79dbcf9c617a46291d8d43bbdbfbbcb88ac-1142x394.png?auto=format)

동기화에 문제가 발생하는 경우 **과거 데이터** 섹션에서 **가져오기 다시 시작**을 선택해 완료되지 않은 과거 동기화를 다시 시작하거나, 완료된 후 다시 실행하려면 **다시 가져오기**를 선택해 주세요. 이 컨트롤을 사용하려면 연동을 관리할 권한이 필요해요.

## Square에서 동기화된 데이터

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

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

- [알려진 사이트 방문자](https://help.klaviyo.com/hc/ko-kr/articles/115005076767.md#who-klaviyo-tracks5)가 *사이트에서 활성* 이벤트로 추적돼요(온사이트 JavaScript 설정을 선택된 상태로 두었다면).

- 이메일 구독 취소

- 주문 이벤트와 연결된 고객 정보

- Square 카탈로그(POS 전용 항목 포함)

- 다음 이벤트:

  - 중단된 결제

  - '완료된 주문'

  - '주문한 제품'

  - '환불된 주문'

  - '취소된 주문'

  - 주문 부분 처리

  - '처리된 주문'



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

*Placed Order* 및 *Refunded Order* 같은 주문 수준 이벤트에는 Square Online 또는 POS 같은 소스를 식별하는 **Source Name** 속성이 포함되어 있어, [Klaviyo에서 이러한 이벤트를 세그먼트로 나눌 수 있어요](https://help.klaviyo.com/hc/ko-kr/articles/115005237908.md). 이 속성은 *Ordered Product* 또는 *Abandoned Checkout* 이벤트에 포함되지 않아요.

## 고객 정보 세부 정보

고객이 회사에 직접 공유한 이메일 주소 및/또는 전화번호가 고객과 연결되어 있는 경우, 고객 프로필이 Square에서 Klaviyo로 동기화돼요. Square에서 사용할 수 있는 데이터에 따라 Square에서 Klaviyo로 동기화된 프로필에는 다음과 같은 속성이 포함될 수 있어요:

- **이메일**
고객의 이메일 주소

- **이름**
고객의 이름(이름과 성이 모두 있는 경우)

- **성**
이름과 성이 모두 있는 경우 고객의 성입니다

- **도시**
고객의 도시

- **주/지역**
고객의 주

- **우편번호**
고객의 우편번호

- **국가**
고객 국가

- **전화번호**
고객의 전화번호예요. Klaviyo는 [Klaviyo SMS를 설정](https://help.klaviyo.com/hc/ko-kr/articles/4404274419355.md)한 경우에만 전화번호 전용 프로필을 만들어요.

- **생일**
제공된 경우 고객의 생년월일

- **Square 그룹**
고객과 연결된 Square 그룹입니다. 여기에는 현재 Square 세그먼트가 포함되지 않아요.



### 이메일 동의

Square 연동은 이메일 구독 취소 상태는 동기화하지만, 이메일 수신 동의는 동기화하지 않습니다. Square에서 email_unsubscribed가 true이면 Klaviyo가 고객을 **구독 취소**로 표시합니다. false이면 동기화가 기존 프로필의 이메일 구독 상태를 변경하지 않습니다. 이메일 수신 동의가 없는 새 프로필은 **구독한 적 없음**으로 표시됩니다.

### SMS 동의

Square Online에서 수집한 SMS 동의는 현재 Klaviyo로 동기화할 수 없어요. Square 사이트에서 [Klaviyo 양식](https://help.klaviyo.com/hc/ko-kr/articles/360026474752.md)을 통해 SMS 동의를 수집할 수 있어요.

## 카탈로그 항목 세부 정보

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

- 항목 이름

- 항목 ID

- 항목 설명

- 항목 가격

- SKU

- URL

- 이미지 URL

- 재고 수량

- 재고 정책

- 카테고리

- 게시 완료

- 변형



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

### 중단된 결제

이 이벤트는 Square Online 스토어에서 장바구니 이탈이 발생한 후 1시간 뒤에 트리거되며, [장바구니 이탈 플로우](https://help.klaviyo.com/hc/ko-kr/articles/115002779411.md)에서 사용할 수 있어요. 이 이벤트가 동기화되려면 Square에서 유효한 이메일 주소 또는 전화번호가 포함된 고객 기록을 제공해야 해요.

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

1. Square에 로그인한 다음 [개요 페이지](https://square.online/)로 이동해 주세요.

2. **커뮤니케이션 > 장바구니 이탈**을 선택해 주세요.

3. **비활성화**를 선택해 주세요.



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

- **$value**
장바구니 총액

- **품목**
장바구니에 포함된 품목

- **컬렉션**
장바구니에 포함된 항목에 연결된 컬렉션



*Abandoned Checkout* 이벤트에는 최상위 **Item Count** 속성이 포함되지 않아요.

### '완료된 주문'

이 이벤트는 Square Online 스토어나 POS 단말기에서 주문이 접수되면 트리거돼요.

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

- **$value**
주문의 총액

- **항목**
주문에 포함된 항목

- **컬렉션**
주문에 포함된 항목에 연결된 컬렉션

- **품목 수**
주문에 포함된 총 품목 수

- **할인 코드**
주문에 적용된 할인 이름

- **총 할인**
총 할인 금액

- **소스 이름**
주문의 출처(Square Online, POS)

- **위치 이름**
Square 위치 이름



### '주문한 제품'

이 이벤트는 Square 온라인 스토어 또는 POS 단말기에서 주문이 접수되면 트리거돼요. 전체 단위로 판매되는 카탈로그 제품의 경우, 구매한 각 단위마다 *주문한 제품* 이벤트가 트리거되며 주문 라인당 최대 100개 이벤트까지 생성돼요. 무게 또는 다른 분수 단위로 판매되는 제품의 경우, 이벤트 1회는 구매한 전체 수량을 의미해요.

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

- **$value**
수정 항목을 포함하고 세금을 제외한, 이 이벤트로 표시되는 제품 수량의 값

- **이름**
주문한 제품의 이름

- **같은 이메일의 다른 버전**
제품 같은 이메일의 다른 버전의 이름

- **SKU**
제품 SKU

- **ProductID**
제품 식별자

- **같은 이메일의 다른 버전 ID**
같은 이메일의 다른 버전 식별자

- **수량**
전체 단위 이벤트당 1 또는 분할 단위로 판매되는 제품의 경우 구매한 전체 수량

- **컬렉션**
제품에 연결된 컬렉션

- **같은 이메일의 다른 버전 옵션: [option name]**
주문한 제품의 지정된 같은 이메일의 다른 버전 옵션 값

- **수정 옵션: [modifier list name]**
주문한 제품의 지정된 수정 목록에서 선택한 수정 옵션



### '환불된 주문'

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

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

- **$value**
환불된 금액

- **영수증 URL**
주문 영수증의 URL

- **소스 이름**
주문의 출처(Square Online, POS)

- **위치 이름**
Square 위치 이름



### '취소된 주문'

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

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

- **$value**
주문의 총액

- **항목**
주문에 포함된 항목

- **컬렉션**
주문에 포함된 항목에 연결된 컬렉션

- **품목 수**
주문에 포함된 총 품목 수

- **할인 코드**
주문에 적용된 할인 이름

- **총 할인**
총 할인 금액

- **소스 이름**
주문의 출처(Square Online, POS)

- **위치 이름**
Square 위치 이름



### 주문 부분 처리

다른 이행이 아직 완료되지 않은 상태에서 발송, 배송 또는 픽업이 완료될 때마다 *Fulfilled Partial Order* 이벤트가 기록돼요. 모든 이행이 완료되면 마지막 이행이 *Fulfilled Order*로 기록돼요. Square에서 부분 이행에 대한 상품 세부 정보를 제공하지 않으면, 이벤트에는 전체 주문에 대한 세부 정보가 포함돼요.

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

- **$value**
이행의 총 금액

- **품목**
이행에 포함된 품목

- **컬렉션**
이행에 포함된 항목에 연결된 컬렉션

- **항목 수**
풀필먼트에 포함된 항목의 총 개수예요

- **할인 코드**
주문에 적용된 할인 이름

- **총 할인**
총 할인 금액

- **소스 이름**
주문의 출처(Square Online, POS)

- **위치 이름**
Square 위치 이름



### '처리된 주문'

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

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

- **$value**
주문의 총액

- **항목**
주문에 포함된 항목

- **컬렉션**
주문에 포함된 항목에 연결된 컬렉션

- **품목 수**
주문에 포함된 총 품목 수

- **할인 코드**
주문에 적용된 할인 이름

- **총 할인**
총 할인 금액

- **주문 처리 상태**
Square에서 보고한 주문 상태

- **소스 이름**
주문의 출처(Square Online, POS)

- **위치 이름**
Square 위치 이름

## 추가 자료

- [Square 시작하기](https://help.klaviyo.com/hc/ko-kr/articles/11117215837211.md)
  Klaviyo와 Square Online 사이트를 쉽게 통합하여 고객 프로필, 주문 및 카탈로그 정보를 Klaviyo에 동기화하는 방법과 Square Point of Sale(POS)의 주문 데이터를 함께 동기화하는 방법을 알아보세요. 이 데이터를 사용하면 세분화, 자동화된 플로우, 캠페인을 통해 타겟 메시지로 고객에게 도달할 수 있어요. 
- [세그먼트 시작하기](https://help.klaviyo.com/hc/ko-kr/articles/115005237908.md)
  잠재고객을 이해하고 타겟 메시지를 보내는 강력한 도구인 Klaviyo의 세그먼트를 생성하고 사용하는 방법을 알아보세요. 
- [플로우 시작하기](https://help.klaviyo.com/hc/ko-kr/articles/115002774932.md)
  Klaviyo에서 자동화 또는 드립 캠페인이라고도 하는 플로우를 사용하여 Klaviyo 내에서 개인화되고 자동화된 고객 커뮤니케이션 방법을 알아보고, 첫 번째 플로우를 라이브로 설정하는 방법을 알아보세요.
