Klaviyo

Sami B2B Onboarding은 신청하는 구매자 또는 승인된 구매자를 Klaviyo 목록에 추가할 수 있습니다. 앱은 선택한 답변으로 구매자의 Klaviyo 프로필을 만들거나 업데이트한 다음 목록에 구독시킵니다. Klaviyo 키는 스토어에 한 번만 추가하며, 각 양식에서 자체 목록을 선택합니다.

앱은 Klaviyo로 프로필과 목록 구독을 보냅니다. Klaviyo 이벤트는 보내지 않습니다.

참고

시작하기 전에 목록이 하나 이상 있는 Klaviyo 계정과 앱의 관리자 역할이 필요합니다.

Klaviyo에서 비공개 API 키 만들기

1. API 키 열기

   Klaviyo에서 Settings › API keys를 엽니다.

2. 비공개 키 만들기

   Create Private API Key를 클릭하고 알아보기 쉬운 이름을 지정합니다(예: “Sami B2B Onboarding”).

   앱은 목록을 읽고, 프로필을 만들고 업데이트하며, 프로필을 목록에 구독시킵니다. Full Access Key를 선택하거나, Lists, Profiles, Subscriptions에 대한 전체 액세스 권한이 있는 Custom Key를 선택하세요.

3. 키 복사하기

   키를 만들고 복사합니다. 비공개 키는 pk_로 시작합니다.

앱에 키 추가하기

1. Klaviyo 패널 열기

   Forms로 이동해 양식 옆의 Edit을 클릭합니다. 왼쪽 레일에서 Integrations를 클릭합니다. Connected apps에서 Klaviyo 행의 Connect를 클릭합니다.

   Klaviyo 패널이 열리며 Account, This form, Field mapping의 세 섹션이 표시됩니다.

   

   Account에 API 키를 추가하기 전에는 목록을 선택하거나 답변을 매핑할 수 없지만, 구매자가 목록에 추가되는 시점과 더블 옵트인 설정은 미리 선택할 수 있습니다.

2. 키 붙여넣기

   Account에서 Set up을 클릭합니다. Klaviyo 대화상자의 Private API key에 키를 붙여넣고 Save를 클릭합니다.

   Keys saved가 표시됩니다. 이제 Account 행에 키의 앞부분과 끝부분이 표시되고, 그 아래에 **Used by every form in this store.**라고 표시됩니다.

목록과 구매자 추가 시점 선택하기

아래 항목은 모두 This form에 있습니다.

1. List에서 Klaviyo 목록을 선택합니다. 앱이 목록을 읽는 동안에는 상자에 **Checking your keys…**가 표시됩니다.
2. Add the buyer to the list에서 When the application is submitted(기본값) 또는 When the application is approved를 선택합니다. 승인한 구매자만 목록에 두려면 승인 시점을 선택하세요.
3. **Ask for consent before subscribing (double opt-in)**을 체크한 상태로 두거나 체크를 해제합니다. 아래 표를 참고하세요.

Ask for consent before subscribing (double opt-in)	앱의 동작
체크됨(기본값)	Klaviyo에 구매자를 목록에 구독시키도록 요청합니다. Klaviyo에서 해당 목록이 더블 옵트인을 사용하는 경우, Klaviyo가 먼저 구매자에게 확인 이메일을 보냅니다.
해제됨	동의 요청 없이 구매자의 프로필을 목록에 바로 추가합니다.

주의

구매자로부터 마케팅 이메일 수신에 대한 동의를 이미 받은 경우에만 체크를 해제하세요.

List를 채울 수 없는 경우 패널에 이유가 표시됩니다.

메시지	조치 방법
Klaviyo would not accept that API key. Change it above and try again.	키가 잘못되었거나 Klaviyo에서 삭제되었거나 목록을 읽을 수 없는 키입니다. 새 키를 만들어 Change로 붙여넣으세요.
Klaviyo didn’t answer. Close this panel and open it again to retry.	Klaviyo에 연결할 수 없었습니다. 패널을 닫았다가 다시 여세요.
This Klaviyo account has no lists yet. Create one in Klaviyo, then reopen this panel.	Klaviyo에서 목록을 만든 다음 패널을 다시 여세요.

답변을 Klaviyo 필드에 매핑하기

목록을 선택하면 Field mapping에 양식의 질문이 표시됩니다. 각 질문에는 Don’t send로 시작하는 드롭다운이 있습니다. 답변이 채울 Klaviyo 필드(Email, Phone, First name, Last name, Title, Organization, Address line 1, Address line 2, City, Region, Postal code, Country)를 선택하세요.

Wholesale application 양식에서는 다음과 같이 시작하면 좋습니다.

양식의 질문	Klaviyo 필드
Company name	Organization
First name	First name
Last name	Last name
Email	Email
Job title	Title
Address line 1, City, State or province, ZIP or postal code, Country	Address line 1, City, Region, Postal code, Country

양식에는 질문 이름이 같은 배송 주소와 청구 주소가 있습니다. 둘 다 매핑하지 말고 하나만 매핑하세요. 목록에는 Company information 같은 양식의 제목도 표시됩니다. 제목에는 답변이 없으므로 Don’t send로 두세요.

패널에 표시되듯이 An answer with no Klaviyo field is not sent. Email is what Klaviyo keys a profile by. Email에 매핑된 질문이 없으면 앱은 신청서의 이메일을 사용합니다. 같은 구매자가 두 번 신청하면 같은 프로필이 업데이트됩니다.

연결하고 저장하기

1. 양식 연결하기

   패널 하단에서 Connect를 클릭합니다. 버튼이 Disconnect로 바뀌고, Connected apps의 Klaviyo 행에 Connected가 표시됩니다.

   키가 아직 저장되지 않았다면 **Add your Klaviyo private API key first.**라는 배너가 표시됩니다.

2. 양식 저장하기

   저장 바에서 Save를 클릭합니다. Form saved가 표시됩니다. 저장하기 전에는 Klaviyo로 아무것도 전송되지 않습니다.

작동 확인하기

1. 테스트 신청서 보내기

   Forms로 이동해 양식 옆의 Copy link를 클릭합니다. 시크릿 브라우저 창에서 링크를 열고 확인할 수 있는 이메일 주소로 신청서를 제출합니다(예: Acme Supply Co.). When the application is approved를 선택했다면 Companies › Applications에서 신청을 승인하세요.

2. 앱에서 결과 확인하기

   신청서를 엽니다. Timeline에서 Klaviyo · Acme Supply Co. 항목을 클릭하면 Added to the Klaviyo list가 표시됩니다. 같은 항목이 Automation의 Automations 탭에 있는 Recent runs와 Settings › Activity log의 Emails 보기에도 나타납니다.

3. Klaviyo에서 목록 확인하기

   Klaviyo에서 목록을 엽니다. 구매자의 프로필이 목록에 있습니다. 목록에 더블 옵트인이 켜져 있으면 구매자가 Klaviyo가 보낸 이메일을 확인한 후에 목록에 추가됩니다.

항목에 다른 내용이 표시되면 다음을 참고하세요.

결과	의미
Skipped — the answers have no email to subscribe	Email에 매핑된 답변에 값이 없었고 신청서에도 이메일 주소가 없었습니다. 양식에 이메일 필드가 그대로 있는지 확인하세요.
Klaviyo refused the profile, with a number such as (400)	401 또는 403이면 Klaviyo가 키를 거부한 것이므로 Account의 Change로 유효한 키를 붙여넣으세요. 다른 번호라면 Klaviyo가 매핑된 답변 중 하나를 받아들이지 않은 것입니다. Phone 등 매핑한 항목을 확인하세요.
Klaviyo didn’t answer	Klaviyo에 연결할 수 없었거나 구독이 거부되었습니다. 패널에서 키와 목록을 확인하세요.

참고

When the application is approved는 팀이 승인한 경우, 이미 있는 회사에 구매자를 추가해 승인한 경우, Shopify Flow 워크플로가 승인한 경우를 포함합니다. 규칙이 자동으로 승인한 신청은 Klaviyo로 전송되지 않습니다.

양식 연결 해제 또는 키 제거하기

• 양식 하나만 중단: 해당 양식의 Klaviyo 패널을 열고 Disconnect를 클릭한 다음 Save를 클릭합니다. 목록과 매핑은 유지되므로 나중에 다시 연결할 수 있습니다.
• 키 변경: Account에서 Change를 클릭하고 새 키를 붙여넣은 다음 Save를 클릭합니다. 상자를 비워 두면 이미 저장한 키가 유지됩니다.
• 모든 양식의 키 제거: Account에서 Change를 클릭한 다음 Remove keys를 클릭합니다. 대화상자에 **Every form in this store stops using Klaviyo until you add keys again.**라는 경고가 표시됩니다. Remove keys를 클릭해 확인하거나 Keep keys를 클릭합니다. Keys removed가 표시됩니다. 저장하지 않아도 즉시 적용됩니다.

다음 단계

• 웹훅(Zapier, Make, n8n) — 신청 이벤트를 다른 도구로 보냅니다.
• 답변을 Shopify에 매핑하기 — 어떤 답변이 Shopify 고객과 회사를 채울지 선택합니다.
• 활동 로그 — 앱이 수행한 모든 전달 내역을 확인합니다.