---
title: "Recurly와 연동하는 방법"
description: "고객의 인보이스 및 결제 데이터를 기반으로 이메일을 개인화하고 타겟팅할 수 있도록 Recurly를 Klaviyo와 연동하는 방법을 알아보세요. Klaviyo는 Recurly에서 다음 데이터를 동기화합니다:"
canonical_url: "https://help.klaviyo.com/hc/ko-kr/articles/115005082207"
markdown_url: "https://help.klaviyo.com/hc/ko-kr/articles/115005082207.md"
locale: "ko-kr"
category: "연동"
section: "Recurly"
updated: "2025-07-30"
---

# Recurly와 연동하는 방법

## 학습 내용

고객의 인보이스 및 결제 데이터를 기반으로 이메일을 개인화하고 타겟팅할 수 있도록 Recurly를 Klaviyo와 연동하는 방법을 알아보세요. Klaviyo는 Recurly에서 다음 데이터를 동기화합니다:

- 인보이스가 발행될 때와 각 인보이스에 포함된 항목

- 고객이 결제에 실패하거나, 환불을 받거나, 결제를 성공적으로 완료했을 때의 결제 정보

- Recurly 정보와 연결된 프로필 속성



## Recurly를 Klaviyo와 연동

비공개 API 키를 가져오려면 Klaviyo에서 연동을 관리할 수 있는 권한과 Recurly에서 개발자 또는 관리자 액세스 권한이 필요해요.

1. Recurly를 Klaviyo와 통합하려면 Recurly API 키가 필요하므로 먼저 Recurly 계정에 로그인하세요.

2.  **연동 > API 자격 증명**으로 이동하세요.

3. 나중에 사용할 수 있도록 **기본 API 키** 아래의 비공개 API 키를 복사해 주세요.




![Default API Key section in Recurly with private API key blurred out](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/c0841d1ca32e6651a9e87a9b34e94971c12eea94-1668x454.jpg?auto=format)

**📝 Note:** 여기에서 사용하는 기본 키와 같은 비공개 API 키는 비밀번호처럼 취급해야 해요. 안전한 곳에 보관하고 절대 공개하지 마세요.

1. 기본 API 키가 이미 다른 타사 연동에서 사용 중인 경우, **비공개 API 키 추가**를 클릭해 Klaviyo 연동에 사용할 새 비공개 API 키를 생성할 수 있어요. 




![Private API Keys in Recurly showing Default API Key blurred out and Add Private API Key with gray background at the bottom](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/5c3158171eced03aff03deebcdba6f20ffe9f8db-1698x920.jpg?auto=format)

**📝 Note:** Recurly는 타사 애플리케이션과 통합하기 위한 비공개 API 키를 5개만 생성해요.

1. 새 API 키를 만들었다면 Klaviyo 계정에서 사용할 수 있도록 복사해 주세요.

2. Klaviyo 계정에서 **연동** 탭을 선택합니다.

3. **앱 탐색**을 클릭해 새 탭에서 앱 마켓플레이스를 여세요. **Recurly**를 검색한 후 카드를 선택하고 **설치**를 클릭하세요.

4. Recurly **서브도메인**과 앞에서 복사한 **API 키**를 입력한 다음 **Recurly에 연결**을 클릭해 주세요. 예를 들어 https://yoursubdomain.recurly.com에는 “yoursubdomain”을 입력해 주세요.



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

5. 연동이 성공하면 성공 메시지가 표시되고 과거 데이터 동기화가 시작돼요. Recurly 연동의 **데이터** 탭에서 동기화 진행 상황을 확인할 수 있어요.



## Recurly 동기화를 모니터링하세요.

Recurly를 연결하면 Klaviyo가 이전 1,825일(약 5년) 동안의 인보이스와 결제 내역을 가져옵니다. 새 인보이스와 결제 내역은 약 5분마다 동기화됩니다. 유효한 이메일 주소가 없는 Recurly 계정의 인보이스와 결제 내역은 건너뜁니다.

1. Klaviyo에서 **분석** 드롭다운을 클릭한 다음 **지표**를 선택해 주세요.

2. Recurly 아이콘이 있는 **발행된 인보이스**를 검색하고 지표 이름을 클릭한 다음, **활동 피드** 탭을 선택해 주세요.



![Page showing list of Issued Invoice via Recurly metrics in Klaviyo with timestamps](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/7db87fcbd683ad92b858dbbc9b11257420d25e58-1000x581.jpg?auto=format)

3. 연동이 데이터 동기화를 시작하면, Recurly 아이콘이 있는 *Issued Invoice* 이벤트가 이 활동 피드에 추가되는 것을 확인할 수 있어요.

4. 결제 총액을 비교하려면 **애널리틱스 > 지표**로 돌아간 다음 Recurly 아이콘이 있는 **결제 완료**를 여세요.

5. **차트** 탭에서 확인하려는 날짜가 포함되도록 **기간**을 선택하세요. **보기 기준**을 **일별**로, **측정 항목**을 **합계**로 설정하세요.

6. 해당 날짜의 총계를 같은 날짜의 Recurly 내 결제 성공 건수와 비교해 보세요. 이전 날짜를 확인하기 전에 과거 동기화가 완료될 때까지 기다려 주세요.

7. 합계가 다르면 동기화가 완료되었는지, 결제에 유효한 고객 이메일 주소가 있는지, 그리고 Klaviyo 및 Recurly 계정에서 동일한 시간대를 사용하는지 확인해 주세요.

8. Klaviyo에서 표준 시간대 설정을 확인하려면:

   - 왼쪽 하단에 있는 계정 이름을 클릭합니다.

   - **설정**을 선택합니다.

   - **계정**을 선택한 다음 **시간대**까지 아래로 스크롤해 주세요.



## Recurly에서 Klaviyo로 동기화된 데이터

### 지표

Recurly는 다음 지표를 Klaviyo로 동기화해요:

- **결제 실패**
Recurly를 통해 이루어진 결제가 실패로 표시될 때마다 기록돼요.

- **발행된 인보이스**
Recurly를 통해 고객에게 인보이스가 발행될 때마다 기록됩니다.

- **주문한 제품**
고객이 Recurly를 통해 결제에 성공하면 인보이스의 항목에 대해 기록돼요. 결제 1건에서 여러 개의 Ordered Product 이벤트가 생성될 수 있어요.

- **환불된 결제**
Recurly를 통해 결제를 환불할 때 기록돼요.

- **결제 성공**
고객이 Recurly를 통해 인보이스를 성공적으로 결제할 때마다 기록돼요.




![Metrics tab in Klaviyo filtered by Recurly with metrics such as Failed Payment and Issues Invoice](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/9c7829de22c9b6561e3a49f20262e87f4fd9ea8b-1676x590.jpg?auto=format)

### 프로필 속성

다음 속성은 Recurly에서 Klaviyo 프로필로 동기화됩니다.

- Recurly 계정 코드

- Recurly 카드 만료일

- Recurly 플랜 코드

- Recurly 요금제



결제 데이터가 동기화되면 **Recurly 요금제** 및 **Recurly 요금제 코드**는 활성 구독에서 가져와 채워져요. 청구 세부 정보에 만료 월과 연도가 포함되어 있으면 **Recurly 카드 만료일**이 채워져요.

## 결과

Recurly를 Klaviyo와 통합하는 작업을 완료했으며 동기화된 데이터를 확인했어요. 이제 고객의 인보이스 및 결제 데이터를 기반으로 이메일을 개인화하고 타겟팅할 수 있어요.

## 추가 자료

- [플로우 시작하기](https://help.klaviyo.com/hc/ko-kr/articles/115002774932.md)
  Klaviyo에서 자동화 또는 드립 캠페인이라고도 하는 플로우를 사용하여 Klaviyo 내에서 개인화되고 자동화된 고객 커뮤니케이션 방법을 알아보고, 첫 번째 플로우를 라이브로 설정하는 방법을 알아보세요.
- [세그먼트 시작하기](https://help.klaviyo.com/hc/ko-kr/articles/115005237908.md)
  잠재고객을 이해하고 타겟 메시지를 보내는 강력한 도구인 Klaviyo의 세그먼트를 생성하고 사용하는 방법을 알아보세요. 
- [Klaviyo 및 앱 간에 교환되는 정보 유형 이해](https://help.klaviyo.com/hc/ko-kr/articles/360030696012.md)
  Klaviyo와 외부 앱 간에 어떤 유형의 데이터가 교환되는지, 그리고 해당 데이터를 Klaviyo 계정의 어디에서 확인할 수 있는지 알아보세요. 타사 애플리케이션을 Klaviyo와 통합하면 두 플랫폼 간에 정보가 교환돼요. Klaviyo와의 대부분의 데이터 교환은 단방향으로 이루어져요. Klaviyo 내에서 고객 데이터의 폭넓은 범위를 활용할 수 있도록 데이터가 Klaviyo 계정으로 가져와져요. 
