---
title: "Klaviyo 연결하기"
description: "Klaviyo에서 올바른 범위의 비공개 API 키를 만들어 연결하고, 새 가입자를 Klaviyo 목록에 구독시키세요."
url: https://scratcher.io/ko/help/integrations/klaviyo
language: ko
---

1. [도움말 센터](https://scratcher.io/ko/help)
2. [통합](https://scratcher.io/ko/help/integrations)
3. Klaviyo 연결하기

# Klaviyo 연결하기

Klaviyo에서 올바른 범위의 비공개 API 키를 만들어 연결하고, 새 가입자를 Klaviyo 목록에 구독시키세요.

Klaviyo 통합을 사용하면 가입한 모든 사람이 Klaviyo 프로필로 생성되거나 업데이트되고, 선택한 목록에 추가되며, 이메일 마케팅에 구독됩니다.

## 준비 사항

- Klaviyo 계정. 무료 요금제도 사용할 수 있습니다.
- 비공개 API 키를 만들 수 있는 Klaviyo 사용자(Klaviyo에서는 보통 **Owner**, **Admin**, **Manager**).

## 1단계: Klaviyo에서 비공개 API 키 만들기

1. Scratcher에서 **설정** > **통합**으로 이동해 **Klaviyo**를 클릭하고 **설정 가이드**를 확인합니다: “비공개 API 키를 만드세요. 올바른 권한이 미리 선택되어 있습니다.”
2. **비공개 API 키 만들기** 링크를 클릭합니다. 올바른 범위가 미리 선택된 상태로 Klaviyo가 열립니다. 요청이 있으면 Klaviyo에 로그인하세요.
3. 알아보기 쉬운 이름을 키에 붙입니다. 예: “Scratcher”
4. 범위(아래 목록 참고)를 확인하고 키를 생성합니다.
5. 키를 복사합니다. 키는 “pk\_”로 시작합니다. Klaviyo는 전체 키를 한 번만 보여 주므로 붙여 넣을 때까지 탭을 열어 두세요.

키를 직접 만들고 싶다면 Klaviyo에서 계정 이름 아래의 메뉴를 열고 **Settings** > **API keys**로 이동해 **Create Private API Key**를 클릭합니다. **Custom Key**를 선택하고 아래 범위를 설정하세요.

## 키에 필요한 범위

키에는 정확히 다음 범위가 필요합니다(Scratcher 도움말 문구: “API 키에는 ‘Lists’와 ‘Profiles’에 대한 읽기/쓰기 권한과 ‘Subscriptions’에 대한 쓰기 권한이 필요합니다”).

- **Lists**: 읽기 및 쓰기. 목록을 표시하고 사람을 목록에 추가하기 위해.
- **Profiles**: 읽기 및 쓰기. 프로필을 생성하고 업데이트하기 위해.
- **Subscriptions**: 쓰기. 사람을 이메일 마케팅에 구독시키기 위해.

나머지 범위는 모두 **No Access**로 두면 됩니다.

## 2단계: Klaviyo를 Scratcher에 연결하기

1. Scratcher의 Klaviyo 대화 상자에서 **비공개 API 키**에 키를 붙여 넣습니다. **액세스 권한** 상자에는 Scratcher가 할 수 있는 작업이 나열되어 있습니다: “연락처 및 목록 읽기/쓰기 권한”, “캠페인 참여자 자동 백그라운드 동기화”.
2. **통합 설치**를 클릭합니다. Scratcher가 키로 목록을 읽을 수 있는지 확인합니다.

## 3단계: 캠페인에서 켜기

1. 편집기에서 **연결** > **통합** > **Klaviyo**로 이동해 **활성화**를 클릭합니다.
2. Klaviyo 계정을 둘 이상 연결했다면 **계정 선택**에서 계정을 고릅니다.
3. **외부 목록**에서 Klaviyo 목록을 선택합니다.
4. **필드 매핑**에서 프로필에 담을 추가 데이터를 추가합니다. 여기서는 Klaviyo의 속성 이름을 직접 입력합니다(**외부 필드 이름**). 예: “favourite\_product” 또는 “Campaign”
5. \*\*권한으로 필터링(선택 사항)\*\*에서 마케팅 동의 체크박스를 선택합니다.
6. **저장**을 클릭한 다음 **테스트**를 클릭합니다.

## 필드 매핑

- 이메일, 전화번호, 이름, 성은 Klaviyo 자체 프로필 필드로 자동 전송됩니다. 따로 매핑할 필요가 없습니다.
- 매핑한 모든 항목은 입력한 이름으로 프로필에 맞춤 속성으로 저장됩니다. 속성이 아직 없으면 Klaviyo가 생성합니다.
- Klaviyo는 +와 국가 코드가 포함된 전화번호만 받습니다. 양식의 전화번호 필드에 국가 코드가 있는지 확인하세요.

## 동의

Scratcher는 전송하는 모든 사람을 출처 “Scratcher”로 Klaviyo 이메일 마케팅에 구독시킵니다. 그래서 동의 필터가 중요합니다. 양식에서 마케팅 체크박스가 선택 사항이라면 \*\*권한으로 필터링(선택 사항)\*\*에서 해당 체크박스를 선택하세요.

Klaviyo 목록이 이중 수신 동의를 사용한다면 Klaviyo가 자체 확인 이메일을 보내며, 확인한 사람만 구독됩니다. 그런 다음 목록에 사람이 추가될 때 Klaviyo에서 환영 플로우를 시작할 수 있습니다.

## 전송 대상과 시점

새 가입자는 1~2분 안에 전송됩니다. 통합을 활성화하면 캠페인의 기존 리드도 함께 전송됩니다. 같은 사람이 다시 참여하면 프로필이 업데이트됩니다.

## 문제 해결

전송에 실패한 내역은 **설정** > **통합** > **전송 상태**에 표시됩니다.

- “사용된 API 키에 올바른 API 범위가 없습니다.”: 키에 위 범위 중 하나가 빠져 있습니다. Klaviyo에서 키를 편집하거나, 설정 링크로 새 키를 만들어 **새 계정 추가**로 연결하세요.
- “충돌: 중복 프로필이 감지되었습니다.”: Klaviyo가 일치하는 프로필 두 개를 찾았습니다. 예를 들어 하나는 이메일로, 다른 하나는 같은 전화번호로 일치하는 경우입니다. Klaviyo에서 프로필을 병합하거나 수정한 뒤 다시 보내세요.
- 전화번호가 거부되는 경우: 번호에 국가 코드가 없습니다. 양식의 전화번호 필드에 국가 선택기를 추가하세요.
- 설치 후 아무것도 도착하지 않는 경우: 캠페인의 **외부 목록**에서 목록을 선택했는지, **저장**을 클릭했는지 확인하세요.

통합

- [통합의 작동 방식](https://scratcher.io/ko/help/integrations/how-integrations-work)
- [모든 통합](https://scratcher.io/ko/help/integrations/other-integrations)
- [전송 상태 확인 및 리드 재전송](https://scratcher.io/ko/help/integrations/delivery-status)
- [HubSpot 연결하기](https://scratcher.io/ko/help/integrations/hubspot)
- [Salesforce Marketing Cloud 연결하기](https://scratcher.io/ko/help/integrations/salesforce-marketing-cloud)
- [Zapier로 Microsoft Dynamics 365 연결하기](https://scratcher.io/ko/help/integrations/microsoft-dynamics-365)
- [Emarsys 연결하기](https://scratcher.io/ko/help/integrations/emarsys)
- [Klaviyo 연결하기](https://scratcher.io/ko/help/integrations/klaviyo)
- [Mailchimp 연결하기](https://scratcher.io/ko/help/integrations/mailchimp)
- [ActiveCampaign 연결하기](https://scratcher.io/ko/help/integrations/activecampaign)
- [Apsis One 연결하기](https://scratcher.io/ko/help/integrations/apsis-one)
- [Drip 연결하기](https://scratcher.io/ko/help/integrations/drip)
- [HeyLoyalty 연결하기](https://scratcher.io/ko/help/integrations/heyloyalty)
- [Peytz 연결하기](https://scratcher.io/ko/help/integrations/peytz)
- [Marketingplatform 연결하기](https://scratcher.io/ko/help/integrations/marketingplatform)
- [Zapier로 Campaign Monitor 연결하기](https://scratcher.io/ko/help/integrations/campaign-monitor)
- [Zapier로 ActiveTrail 연결하기](https://scratcher.io/ko/help/integrations/activetrail)
- [Bloomreach 연결하기](https://scratcher.io/ko/help/integrations/bloomreach)
- [Iterable 연결하기](https://scratcher.io/ko/help/integrations/iterable)
- [Mapp 연결하기](https://scratcher.io/ko/help/integrations/mapp)
- [Agillic 연결하기](https://scratcher.io/ko/help/integrations/agillic)
- [Ortto 연결하기](https://scratcher.io/ko/help/integrations/ortto)
- [Emarketeer 연결하기](https://scratcher.io/ko/help/integrations/emarketeer)
- [Shopify 연결하기](https://scratcher.io/ko/help/integrations/shopify)
- [Hello Retail 연결하기](https://scratcher.io/ko/help/integrations/hello-retail)
- [Zapier로 8,000개 이상의 앱 연결하기](https://scratcher.io/ko/help/integrations/zapier)
- [Zapier로 monday.com 연결하기](https://scratcher.io/ko/help/integrations/monday-com)
- [Zapier로 Asana 연결하기](https://scratcher.io/ko/help/integrations/asana)
- [Zapier로 Podio 연결하기](https://scratcher.io/ko/help/integrations/podio)
- [Zapier로 Intercom 연결하기](https://scratcher.io/ko/help/integrations/intercom)

더 알아보기

## 관련 글

- [통합의 작동 방식](https://scratcher.io/ko/help/integrations/how-integrations-work): 이메일 도구나 CRM을 한 번 연결하고, 캠페인마다 켜고, 목록을 선택하고, 필드를 매핑하고, 동의한 사람만 보내세요.
- [전송 상태 확인 및 리드 재전송](https://scratcher.io/ko/help/integrations/delivery-status): 어떤 리드가 도구로 전송되었는지 확인하고, 오류 메시지를 이해하고, 문제를 해결한 뒤 다시 보내세요.
- [동의 요청 및 이용 약관 추가하기](https://scratcher.io/ko/help/forms/consent-and-permissions): 뉴스레터 동의 체크박스를 추가하고, 약관을 연결하고, 구독 처리할 체크박스를 고르고, 동의한 사람만 이메일 도구로 보내세요.

도움이 필요하신가요?

## 아직 도움이 필요하신가요?

실제 담당자가 도와드립니다. 이미 Scratcher를 사용 중이라면 플랫폼 안의 채팅이 가장 빠릅니다.

- **[채팅 문의](https://platform.scratcher.io/ko/login)**

    로그인한 뒤 오른쪽 아래의 채팅 버튼을 클릭하세요. Rex가 바로 답하고, 팀과도 클릭 한 번으로 연결됩니다.
- **[미팅 예약](https://scratcher.io/ko/book-a-meeting)**

    팀과의 무료 30분 화상 통화: 둘러보기, 캠페인 아이디어, 설정 지원.
- **[이메일 문의](mailto:contact@scratcher.io)**

    contact@scratcher.io로 연락 주시면 답변드리겠습니다.
