Klaviyo 통합을 사용하면 가입한 모든 사람이 Klaviyo 프로필로 생성되거나 업데이트되고, 선택한 목록에 추가되며, 이메일 마케팅에 구독됩니다.
준비 사항
- Klaviyo 계정. 무료 요금제도 사용할 수 있습니다.
- 비공개 API 키를 만들 수 있는 Klaviyo 사용자(Klaviyo에서는 보통 Owner, Admin, Manager).
1단계: Klaviyo에서 비공개 API 키 만들기
- Scratcher에서 설정 > 통합으로 이동해 Klaviyo를 클릭하고 설정 가이드를 확인합니다: “비공개 API 키를 만드세요. 올바른 권한이 미리 선택되어 있습니다.”
- 비공개 API 키 만들기 링크를 클릭합니다. 올바른 범위가 미리 선택된 상태로 Klaviyo가 열립니다. 요청이 있으면 Klaviyo에 로그인하세요.
- 알아보기 쉬운 이름을 키에 붙입니다. 예: “Scratcher”
- 범위(아래 목록 참고)를 확인하고 키를 생성합니다.
- 키를 복사합니다. 키는 “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에 연결하기
- Scratcher의 Klaviyo 대화 상자에서 비공개 API 키에 키를 붙여 넣습니다. 액세스 권한 상자에는 Scratcher가 할 수 있는 작업이 나열되어 있습니다: “연락처 및 목록 읽기/쓰기 권한”, “캠페인 참여자 자동 백그라운드 동기화”.
- 통합 설치를 클릭합니다. Scratcher가 키로 목록을 읽을 수 있는지 확인합니다.
3단계: 캠페인에서 켜기
- 편집기에서 연결 > 통합 > Klaviyo로 이동해 활성화를 클릭합니다.
- Klaviyo 계정을 둘 이상 연결했다면 계정 선택에서 계정을 고릅니다.
- 외부 목록에서 Klaviyo 목록을 선택합니다.
- 필드 매핑에서 프로필에 담을 추가 데이터를 추가합니다. 여기서는 Klaviyo의 속성 이름을 직접 입력합니다(외부 필드 이름). 예: “favourite_product” 또는 “Campaign”
- **권한으로 필터링(선택 사항)**에서 마케팅 동의 체크박스를 선택합니다.
- 저장을 클릭한 다음 테스트를 클릭합니다.
필드 매핑
- 이메일, 전화번호, 이름, 성은 Klaviyo 자체 프로필 필드로 자동 전송됩니다. 따로 매핑할 필요가 없습니다.
- 매핑한 모든 항목은 입력한 이름으로 프로필에 맞춤 속성으로 저장됩니다. 속성이 아직 없으면 Klaviyo가 생성합니다.
- Klaviyo는 +와 국가 코드가 포함된 전화번호만 받습니다. 양식의 전화번호 필드에 국가 코드가 있는지 확인하세요.
동의
Scratcher는 전송하는 모든 사람을 출처 “Scratcher”로 Klaviyo 이메일 마케팅에 구독시킵니다. 그래서 동의 필터가 중요합니다. 양식에서 마케팅 체크박스가 선택 사항이라면 **권한으로 필터링(선택 사항)**에서 해당 체크박스를 선택하세요.
Klaviyo 목록이 이중 수신 동의를 사용한다면 Klaviyo가 자체 확인 이메일을 보내며, 확인한 사람만 구독됩니다. 그런 다음 목록에 사람이 추가될 때 Klaviyo에서 환영 플로우를 시작할 수 있습니다.
전송 대상과 시점
새 가입자는 1~2분 안에 전송됩니다. 통합을 활성화하면 캠페인의 기존 리드도 함께 전송됩니다. 같은 사람이 다시 참여하면 프로필이 업데이트됩니다.
문제 해결
전송에 실패한 내역은 설정 > 통합 > 전송 상태에 표시됩니다.
- “사용된 API 키에 올바른 API 범위가 없습니다.”: 키에 위 범위 중 하나가 빠져 있습니다. Klaviyo에서 키를 편집하거나, 설정 링크로 새 키를 만들어 새 계정 추가로 연결하세요.
- “충돌: 중복 프로필이 감지되었습니다.”: Klaviyo가 일치하는 프로필 두 개를 찾았습니다. 예를 들어 하나는 이메일로, 다른 하나는 같은 전화번호로 일치하는 경우입니다. Klaviyo에서 프로필을 병합하거나 수정한 뒤 다시 보내세요.
- 전화번호가 거부되는 경우: 번호에 국가 코드가 없습니다. 양식의 전화번호 필드에 국가 선택기를 추가하세요.
- 설치 후 아무것도 도착하지 않는 경우: 캠페인의 외부 목록에서 목록을 선택했는지, 저장을 클릭했는지 확인하세요.