Shopify 연동

연동 개요

Pushwoosh는 기업이 온라인 스토어를 생성, 관리 및 확장할 수 있게 해주는 선도적인 전자상거래 플랫폼인 Shopify와 원활하게 연동됩니다. 이 가이드는 Shopify 스토어에 Pushwoosh 앱을 설치 및 구성하고, 사용자 식별을 설정하며, 푸시, 이메일, SMS, WhatsApp과 같은 채널을 통해 고객과 소통하기 위한 알림 및 자동화 도구를 사용하는 방법을 안내합니다.

연동 유형

• 대상: Shopify는 고객 데이터를 Pushwoosh로 전송하며, 이 데이터는 타겟팅 및 메시징에 사용됩니다.

사전 요구 사항

• Pushwoosh 계정
• Shopify 관리자 패널에 대한 접근 권한
• Pushwoosh Device API Access Token 및 애플리케이션 코드
• 고객 및 주문 데이터가 있는 Shopify 스토어
• 주문/장바구니 이벤트, 결제 단계 추적, 스토어프론트 행동 이벤트에 필요한 앱이 요청하는 read_orders, write_pixels, read_customer_events 접근 범위 승인

이미 연결하셨나요? 접근 권한을 다시 승인하라는 요청을 받게 됩니다

주문, 장바구니, 결제 추적 기능이 존재하기 전에 Pushwoosh 앱을 연결했다면, 다음에 앱을 열 때 Shopify에서 새로운 범위에 대한 승인을 요청할 것입니다. 이는 Shopify가 추가 권한을 배포하는 예상된 방식이며 오류가 아닙니다. 승인하면 주문, 장바구니, 결제 이벤트를 수신하기 시작합니다.

동기화되는 엔티티

• 고객: Shopify 메타필드를 통해 Pushwoosh UserID를 할당하고 식별하는 데 사용됩니다.

참고

Pushwoosh의 고객 동기화 접근 방식

기술적 한계로 인해 Pushwoosh는 알림에 사용되는 통신 채널에 따라 여러 고객 동기화 방법을 제공합니다:

• 이메일, 웹, SMS & WhatsApp: 기기/사용자가 Pushwoosh 애플리케이션에 자동으로 등록됩니다.
• 모바일 & 데스크톱 앱: 기기/사용자는 Pushwoosh 및 Shopify 관리자 패널을 통해 수동으로 동기화할 수 있습니다.
• 웹 플랫폼 (Chrome, Firefox, Safari): 기기/사용자는 Shopify 테마 임베드 자체에서 관리됩니다.

어떻게 작동하나요?

동기화 프로세스는 다음과 같이 작동합니다:

1. 시스템은 현재 사용자 세션을 검색하여 이메일 또는 전화번호(추가 구성 없이 작동하는 식별자)를 얻으려고 시도합니다.
2. 성공하면 이메일 또는 전화번호가 Pushwoosh와 고객 데이터의 pushwoosh_userid 속성 모두에 대한 userID 식별자로 설정됩니다.
3. 이것이 불가능한 경우, 기본 Pushwoosh SDK userID가 Pushwoosh와 pushwoosh_userid 속성 모두에 대한 식별자로 할당됩니다.
4. 어떤 경우든 양쪽에 userID가 할당되어 일관된 동기화를 보장합니다.

• 고객 세그먼트: 그룹 기반 타겟팅 및 메시징에 사용됩니다.
• 이벤트 및 트리거 (예: 주문 접수, 태그 적용): Shopify Flow에서 채널 간 메시징을 자동화하는 데 사용됩니다.
• 스토어프론트: 임베드된 스크립트를 통해 웹 푸시 옵트인을 캡처하는 데 사용됩니다.
• 제품 피드: 스토어의 스토어프론트 피드(products.json)는 앱을 연결할 때 Pushwoosh 제품 카탈로그에 자동으로 연결되고, 앱을 제거하면 자동으로 연결이 끊어집니다.
• 주문 및 장바구니: Shopify의 orders/paid 및 checkouts/create 웹훅에서 오는 서버 간 이벤트입니다. 5부. 주문, 장바구니 및 결제 단계 추적을 참조하세요.
• 스토어프론트 브라우징 행동: 웹 푸시 옵트인에 사용되는 동일한 테마 임베드에 의해 수집되는 제품 조회 및 장바구니 추가 활동입니다.
• 결제 단계: Shopify 웹 픽셀을 통해 수집되는 연락처 정보 입력 및 결제 정보 제출입니다.

용어집 (엔티티 이름이 다른 경우 매핑)

Shopify	Pushwoosh
Customer	UserID
orders/paid webhook	이벤트 PW_OrderCreated — 다른 전자상거래 연동(예: Magento)과 공유됨
checkouts/create webhook	이벤트 PW_AbandonedCart — 동일한 공유 이벤트이며, 제품 블록의 장바구니 소스에서도 사용됨
Product page view	이벤트 PW_ProductViewed

연동 작동 방식

Pushwoosh는 Shopify의 메시징 대상으로 작동합니다. 연동되면 Shopify는 고객 및 행동 데이터를 Pushwoosh로 전송하며, 이 데이터는 실시간 알림, 고객 세분화, 채널 간 개인화된 메시징을 지원합니다.

연동의 주요 구성 요소

1. 메타필드를 통한 고객 식별 각 Shopify 고객에게는 고유한 UserID가 할당되어 메타필드(custom.pushwoosh_userid)에 저장됩니다. 이 ID를 통해 Pushwoosh는 플랫폼 전반에서 사용자를 일관되게 인식하고 메시지를 보낼 수 있습니다.

2. Shopify Flow를 통한 이벤트 기반 자동화 Pushwoosh는 다음과 같은 Shopify 이벤트를 기반으로 메시징(푸시, 이메일, SMS, WhatsApp)을 자동화할 수 있는 Flow 액션을 제공합니다:

   • 신규 주문 접수
   • 고객에게 태그 적용
   • 장바구니 포기

3. 세그먼트 기반 타겟팅 Shopify의 고객 세그먼트를 사용하여 첫 구매자 프로모션이나 휴면 사용자 재활성화 캠페인과 같은 그룹별 알림을 채널 전반에 보낼 수 있습니다.

4. 수동 및 실시간 메시징 Shopify 고객 또는 세그먼트 보기에서 Pushwoosh 확장 프로그램을 사용하여 수동으로 알림을 트리거할 수 있습니다:

   • 고객별 알림: 개인적인 후속 조치 또는 테스트용
   • 세그먼트별 알림: 캠페인 기반 메시지용

스토어프론트 임베드를 통한 웹 푸시 알림

Shopify 테마에서 Pushwoosh 임베드를 활성화하면 웹사이트 방문자에게 브라우저 기반 푸시 알림에 옵트인하도록 유도할 수 있습니다. 모바일 앱이 필요 없습니다.

데이터 흐름 개요

Shopify 고객 및 이벤트 데이터
         ↓
Pushwoosh API (앱을 통해)
         ↓
UserID → 세분화 → 트리거 또는 수동 알림

이 연동을 통해 시기적절하고 관련성 있는 메시지를 전달하여 사용자 유지율을 높이고, 전환율을 높이며, 고객 경험을 향상시킬 수 있습니다. 자동 또는 온디맨드로 가능합니다.

1부. 설치

Shopify에 로그인

1. Shopify 관리자로 이동합니다.
2. 대시보드에서 스토어를 선택합니다.

참고

이 가이드는 이미 Pushwoosh 계정이 있다고 가정합니다. 없다면 계정을 만드세요

Pushwoosh 앱 설치

1. Pushwoosh 앱 스토어 페이지를 방문합니다.
2. 설치를 클릭합니다.
3. Shopify 대화 상자에서 설치를 확인합니다.

Pushwoosh 앱 연결

설치 후 Shopify 내의 Pushwoosh 앱으로 리디렉션됩니다.

1. 연결을 클릭합니다.

2. Pushwoosh 제어판 → 설정 → API 접근에서 찾을 수 있는 애플리케이션 코드와 Device API Access Token을 입력합니다.

연결되면 “Pushwoosh 앱이 연결되었습니다.”라는 성공 메시지가 나타납니다.

자동 제품 카탈로그 연결

앱을 연결하면 스토어의 스토어프론트 피드가 Pushwoosh 제품 카탈로그에 자동으로 연결됩니다. 별도의 피드 설정이 필요 없습니다. 스토어의 통화도 동시에 캡처되며, 나중에 스토어 통화를 변경하면 자동으로 업데이트됩니다.

플랜 구독

1. 구독 업그레이드를 클릭합니다.
2. 단일 사용량 기반 플랜이 표시됩니다.
3. 청구를 확인합니다.

참고

메시지 전송 및 세분화 기능을 사용하려면 청구가 필요합니다.

2부. 설정: 메타필드를 통한 고객 User ID

Pushwoosh는 채널(푸시, 이메일, SMS, WhatsApp) 전반에 걸쳐 식별된 사용자에게 알림을 전달하기 위해 고객별로 고유한 User ID를 사용합니다. Shopify는 이 값을 Shopify의 고객 메타필드 내에 저장합니다.

1. 설정 → 메타필드 및 메타오브젝트 → 고객으로 이동합니다.

2. 정의 추가를 클릭하고 다음 값을 사용합니다:

필드	값
네임스페이스 및 키	custom.pushwoosh_userid
네임스페이스	custom
유형	한 줄 텍스트
유효성 검사	없음
고객 계정 접근	읽기 및 쓰기
스토어프론트 API 접근	활성화됨

이것이 왜 중요한가

이 메타필드는 알림 및 세분화를 위해 모바일/웹 기기 전반에서 지속적인 사용자 식별자 역할을 합니다.

3부. Pushwoosh 확장 프로그램 사용

Pushwoosh에는 세그먼트 타겟팅, 자동화(Flow) 및 고객별 알림을 위한 Shopify 확장 프로그램이 포함되어 있습니다.

확장 프로그램 1. 고객별 알림 보내기

사용 사례

특정 사용자에게 개인화된 메시지를 수동으로 보내거나 테스트 알림을 보냅니다.

단계

1. 고객 → 고객 선택을 엽니다.
2. 추가 작업 → 고객별 알림을 클릭합니다.
3. 메시징 플랫폼(예: 이메일)과 콘텐츠 프리셋을 선택합니다.
4. 보내기를 클릭합니다.

팁

구매 후 알림, 개인적인 감사 메시지 또는 재활성화 프롬프트에 사용하세요.

확장 프로그램 2. 세그먼트별 알림

사용 사례

장바구니 포기, 첫 구매자, 고액 구매자와 같은 고객 그룹을 타겟팅합니다.

단계

1. 고객 → 세그먼트로 이동합니다.

2. 세그먼트 선택 → 세그먼트 사용 클릭

3. 세그먼트별 알림을 선택합니다.
4. 원하는 통신 채널과 메시지 프리셋을 선택합니다. 보내기를 클릭합니다.

팁

세그먼트는 구매 내역, 위치, 활동 또는 태그를 기반으로 생성할 수 있습니다.

확장 프로그램 3. Shopify Flow에서 Pushwoosh 사용

사용 사례

주문, 태그 또는 행동과 같은 트리거를 사용하여 고객 여정에서 메시징을 자동화합니다.

단계

1. Shopify Flow에서 새 Flow를 생성합니다.
2. 작업 추가 → Pushwoosh 알림 선택

3. 메시지 및 동적 필드 구성

예를 들어:

• 주문 접수 후 메시지 보내기

• 장바구니 포기 시 사용자에게 알림

• 30일 비활성 후 재활성화 푸시 보내기

4부. 웹 푸시 활성화 (선택 사항이지만 권장)

스토어프론트에서 브라우저 기반 웹 푸시 알림을 지원하려면 다음을 수행하세요:

1. 온라인 스토어 → 테마 → 사용자 지정으로 이동합니다.
2. 왼쪽 메뉴에서 앱 임베드를 엽니다.
3. Push Init Embed를 켭니다.

참고

이제 스토어에서 사용자에게 스토어프론트에서 직접 웹 푸시에 옵트인하도록 유도할 수 있습니다.

5부. 주문, 장바구니 및 결제 단계 추적

read_orders, write_pixels, read_customer_events 범위를 승인하면(사전 요구 사항 참조), Pushwoosh는 스토어에서 세 가지 종류의 상거래 이벤트를 수신하기 시작합니다. 이들은 서로 다른 곳에서 오며 서로 독립적으로 중지되므로 하나의 피드로 취급하지 마세요.

서버 측 주문 및 장바구니 이벤트

Shopify는 주문 결제 완료 (orders/paid 웹훅, 이벤트 PW_OrderCreated) 및 결제 생성 (checkouts/create 웹훅, 이벤트 PW_AbandonedCart) 이벤트를 Pushwoosh로 직접 서버 간에 전송합니다. 두 이벤트 모두 다른 전자상거래 연동과 공유됩니다. Magento는 동일한 두 이벤트 이름을 사용합니다. 다른 인바운드 웹훅 이벤트(Stripe도 동일하게 작동)와 마찬가지로, 세그먼트를 생성하거나 고객 여정 트리거를 설정할 때 이벤트 드롭다운에 나타나며, 둘 중 하나를 전환 이벤트의 소스로 매핑하여 Shopify 수익을 RFM 세분화, 여정 기여도 및 이메일로 보내는 제품 블록 통계에 반영할 수 있습니다.

이러한 이벤트는 구매자의 브라우저가 아닌 Shopify의 서버에서 오기 때문에, 추적기를 차단하거나 광고 차단기를 사용하는 구매자의 경우에도 계속 수신됩니다.

여기서 장바구니 포기는 세 가지 다른 의미를 가집니다

• Shopify Flow의 장바구니 포기 트리거(Shopify Flow를 통한 이벤트 기반 자동화 참조)는 Pushwoosh 이벤트와 관련 없는 기본 Shopify 조건입니다.
• 위의 checkouts/create 웹훅은 단지 결제가 시작되었음을 의미합니다. Shopify가 이를 “포기된” 것으로 결정한 것도 아니고, 주문이 확정된 것도 아닙니다.
• 제품 블록의 장바구니 소스는 이러한 이벤트와 독립적으로 PW_AbandonedCartID 태그를 통해 수신자의 장바구니를 읽습니다.

가장 비슷하게 들리는 이름이 아니라 실제로 구축하려는 것과 일치하는 것을 선택하세요.

스토어프론트 브라우징 이벤트

제품 조회(이벤트 PW_ProductViewed) 및 장바구니 추가 활동은 웹 푸시 옵트인을 위해 이미 설치한 동일한 테마 임베드에 의해 수집됩니다. 테마에 새로 추가할 것은 없지만, 이러한 이벤트가 도착하려면 임베드가 ON으로 설정되어 있어야 합니다(웹 푸시 활성화 참조). 이 토글을 건너뛰면 웹 푸시 옵트인도 스토어프론트 이벤트도 받지 못합니다.

스토어프론트 이벤트는 테마 임베드가 활성화되어야 합니다

제품 조회 및 장바구니 추가 이벤트는 구매자의 브라우저에서 옵니다. 구매자가 임베드 스크립트를 차단하거나 테마 임베드를 꺼두면 이 두 이벤트를 더 이상 받지 못하지만, 주문 결제 완료 및 결제 생성 이벤트는 Shopify 서버에서 오기 때문에 관계없이 계속 도착합니다. 비활성화된 테마 임베드가 주문 추적도 일시 중지한다고 가정하지 마세요.

PW_ProductViewed는 중복 제거 기능이 없습니다

PW_ProductViewed는 모든 제품 페이지 로드 시 발생합니다. 동일한 세션 내의 반복 방문, 페이지 새로고침, 봇 또는 크롤러 트래픽이 모두 포함됩니다. 중복 제거나 스로틀링 기능은 없습니다. 조회한 내용을 기반으로와 같은 전략은 이 이벤트를 기반으로 구축되므로, 노이즈가 많은 트래픽도 해당 추천에 반영됩니다.

결제 단계 이벤트

Shopify 웹 픽셀은 구매자가 결제 양식을 작성할 때 두 가지 결제 마일스톤을 보고합니다:

• PW_CheckoutContactInfo: 구매자가 연락처 정보를 입력했습니다.
• PW_PaymentInfoSubmitted: 구매자가 결제 세부 정보를 제출했습니다.

완료된 구매는 이 픽셀의 일부가 아닙니다

웹 픽셀은 의도적으로 완료된 구매를 추적하지 않습니다. 이는 위에서 설명한 서버 측 주문 결제 완료 이벤트입니다. 웹 픽셀 이벤트를 사용하여 구매자가 결제 중에 어디서 이탈하는지 확인하고, 주문 이벤트를 사용하여 실제로 판매가 발생했는지 확인하세요.

6부. 데이터 규정 준수

Shopify는 모든 공개 앱이 의무적인 GDPR/CCPA 웹훅에 응답하도록 요구합니다. Pushwoosh는 다음과 같이 처리합니다:

• customers/redact: 구매자가 스토어에 데이터 삭제를 요청하면, Pushwoosh는 Shopify가 보내는 식별자(이메일, 전화번호, Shopify 고객 ID)를 사용하여 일치하는 Pushwoosh 기록을 삭제합니다.
• customers/data_request: 구매자가 자신의 데이터 사본을 요청하면, Pushwoosh는 지원팀의 내부 채널에 알림을 게시하고 담당자가 수동으로 요청을 처리합니다. Shopify는 앱이 30일 이내에 이러한 요청에 응답하도록 요구합니다.
• shop/redact: Shopify는 스토어가 앱을 제거한 후 48시간 후에 이 웹훅을 보내 스토어 데이터 삭제를 요청합니다. Pushwoosh는 설계상 이에 대한 별도의 핸들러가 없습니다. 앱을 제거하면 이미 스토어의 전체 연동 기록(기기 API 키, 애플리케이션 코드, 청구 ID 포함)이 삭제되므로, 이 웹훅이 도착할 때쯤에는 삭제할 것이 남아 있지 않습니다.

사용 사례 요약

시나리오	사용된 도구
개인화된 후속 조치	고객별 알림
장바구니 포기 알림	Shopify Flow + Pushwoosh 작업
세그먼트 기반 프로모션	세그먼트별 알림
가입 후 환영 메시지	Flow + 메타필드 추적
푸시 옵트인	테마 임베드 + Push Init 토글
수익 기여도 및 RFM 세분화	전환 이벤트에 매핑된 주문/결제 이벤트
결제 이탈 분석	PW_CheckoutContactInfo / PW_PaymentInfoSubmitted 이벤트
브라우징 또는 장바구니 포기 세그먼트	스토어프론트 제품 조회 / 장바구니 추가 이벤트