Shopify 설정

연동 개요

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

연동 유형

• 대상: Shopify가 고객 데이터를 Pushwoosh로 보내며, 이는 타겟팅과 메시징에 사용됩니다.

전제 조건

• Pushwoosh 계정
• Shopify 관리자 패널에 대한 액세스 권한
• Pushwoosh 디바이스 API 토큰 및 Application Code
• 고객 및 주문 데이터가 있는 Shopify 스토어
• 주문/장바구니 이벤트를 위한 read_orders 액세스 범위, 그리고 체크아웃 단계 추적을 위한 write_pixels와 read_customer_events의 승인

이미 연결되어 있나요? 액세스를 다시 승인하라는 요청을 받게 됩니다

주문, 장바구니, 체크아웃 추적 기능이 생기기 전에 Pushwoosh 앱을 연결한 경우, 다음에 앱을 열 때 Shopify가 새로운 범위를 승인하도록 요청합니다 — 이는 Shopify가 추가된 권한을 배포하는 정상적인 방식이며, 오류가 아닙니다. 주문, 장바구니, 체크아웃 이벤트를 받기 시작하려면 이를 승인하세요.

동기화되는 엔티티

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

참고

Pushwoosh의 고객 동기화 방식

기술적 제약으로 인해, Pushwoosh는 알림에 사용되는 커뮤니케이션 채널에 따라 여러 가지 고객 동기화 방법을 제공합니다:

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

어떻게 작동하나요?

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

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

• 고객 세그먼트: 그룹 기반 타겟팅 및 메시징에 사용됩니다
• 이벤트 및 트리거(예: 주문 완료, 태그 적용): Shopify Flow에서 채널 간 메시징을 자동화하는 데 사용됩니다
• 스토어프론트: 임베드된 스크립트를 통해 web push 옵트인을 캡처하는 데 사용됩니다
• 제품 피드: 스토어의 스토어프론트 피드(products.json)는 앱을 연결하면 Pushwoosh 제품 카탈로그에 자동으로 연결되고, 앱을 제거하면 자동으로 연결이 끊깁니다.
• 주문 및 장바구니: Shopify의 orders/paid, checkouts/create, checkouts/update webhook에서 발생하는 서버 대 서버 이벤트입니다. Shopify 이벤트 및 캠페인을 참조하세요.
• 스토어프론트 탐색 행동: 제품 조회 및 장바구니 담기 작업으로, web push 옵트인에 사용되는 것과 동일한 테마 임베드로 수집됩니다.
• 체크아웃 단계: 입력된 연락처 정보와 제출된 결제 정보로, Shopify Web Pixel을 통해 수집됩니다.

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

Shopify	Pushwoosh
Customer	User ID
orders/paid webhook	이벤트 PW_OrderCreated — 다른 이커머스 연동과 공유됨(예: Magento)
checkouts/create webhook	이벤트 PW_AbandonedCart — 동일한 공유 이벤트이며, Products 블록의 Cart 소스에서도 사용됨
checkouts/update webhook	이벤트 PW_AbandonedCartUpdate — 쇼핑객이 동일한 체크아웃을 계속 수정하는 동안 트리거되며, PW_AbandonedCart에서 저장된 장바구니를 덮어씀
제품 페이지 조회	이벤트 PW_ProductViewed
장바구니 담기(페이지 새로고침 없음)	이벤트 PW_AddToCart
Web Pixel checkout_contact_info_submitted	이벤트 PW_CheckoutContactInfo
Web Pixel payment_info_submitted	이벤트 PW_PaymentInfoSubmitted

연동 작동 방식

Pushwoosh는 Shopify의 메시징 대상 역할을 합니다. 연동이 완료되면 Shopify는 고객 및 행동 데이터를 Pushwoosh로 보내며, 이는 실시간 알림, 고객 세그멘테이션, 채널 간 개인화된 메시징을 구동합니다.

연동의 핵심 구성 요소

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

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

   • 새 주문 발생
   • 고객에게 태그 적용
   • 장바구니 이탈

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

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

   • Notification by Customer: 개인적인 후속 조치나 테스트용
   • Notification by Segment: 캠페인 기반 메시지용

스토어프론트 임베드를 통한 Web push 알림

Shopify 테마에서 Pushwoosh 임베드를 활성화하면, 모바일 앱 없이도 웹사이트 방문자에게 브라우저 기반 push 알림 구독을 요청할 수 있습니다.

데이터 흐름 개요

Shopify 고객 및 이벤트 데이터
         ↓
Pushwoosh API(앱을 통해)
         ↓
User ID → 세그멘테이션 → 트리거 또는 수동 알림

이 연동을 통해 자동으로 또는 요청 시 적시에 관련성 높은 메시지를 보내 사용자 유지율을 개선하고, 전환율을 높이고, 고객 경험을 향상시킬 수 있습니다.

1부. 설치

Shopify에 로그인

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

참고

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

Pushwoosh 앱 설치

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

Pushwoosh 앱 연결

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

1. Connect를 클릭합니다.

2. Pushwoosh Control Panel → Settings → API Access에서 찾을 수 있는 Application Code와 API Key를 입력합니다. 여기서 API Key는 디바이스 API 토큰입니다.

연결되면 “Pushwoosh app connected.”라는 성공 메시지가 나타납니다.

Shopify가 권한(주문, pixel, 고객 이벤트)을 요청하면 이를 승인하세요. 이 범위는 Shopify 이벤트 및 캠페인 추적에 필요합니다. 이전에 앱을 연결한 경우 이미 연결되어 있나요? 액세스를 다시 승인하라는 요청을 받게 됩니다를 참조하세요.

자동 제품 카탈로그 연결

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

플랜 구독

1. Upgrade Subscription을 클릭합니다
2. 사용량 기반의 단일 플랜이 표시됩니다.
3. 결제를 확인합니다.

참고

메시지 전송 및 세그멘테이션 기능을 사용하려면 결제가 필요합니다.

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

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

1. Settings → Metafields and metaobjects → Customers로 이동합니다

2. Add definition을 클릭하고 다음 값을 사용합니다:

필드	값
Namespace and key	custom.pushwoosh_userid
Namespace	custom
Type	Single line text
Validation	None
Customer Account Access	Read and Write
Storefront API Access	Enabled

위 표와 같이 Customer accounts access와 Storefront API access를 설정합니다.

이것이 중요한 이유

이 메타필드는 알림 및 세그멘테이션을 위해 모바일/웹 기기 전반에서 사용되는 지속적인 사용자 식별자입니다.

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

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

확장 프로그램 1. Send notification by customer

사용 사례

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

단계

1. Customers → 고객 선택을 엽니다
2. More actions → Notification by customer를 클릭합니다
   
3. 메시징 플랫폼(예: Email)과 콘텐츠 프리셋을 선택합니다.
4. Send를 클릭합니다

팁

구매 후 리마인더, 개인적인 감사 인사, 또는 재활성화 유도에 이것을 사용하세요.

확장 프로그램 2. Notification by segment

사용 사례

장바구니 이탈, 첫 구매자, 고액 소비자 등 고객 그룹을 타겟팅합니다.

단계

1. Customers → Segments로 이동합니다

2. 세그먼트를 선택 → Use Segment를 클릭합니다

3. Notification by Segment를 선택합니다
4. 원하는 커뮤니케이션 채널과 메시지 프리셋을 선택합니다. Send를 클릭합니다.

팁

세그먼트는 구매 이력, 위치, 활동, 또는 태그를 기반으로 만들 수 있습니다.

확장 프로그램 3. Shopify Flow의 Pushwoosh

사용 사례

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

단계

1. Shopify Flow에서 새 Flow를 생성합니다
2. 액션 추가 → Pushwoosh send notification을 선택합니다

3. 메시지와 동적 필드를 구성합니다

예를 들면:

• 주문 완료 후 메시지 보내기

• 장바구니가 이탈되었을 때 사용자에게 리마인드

• 30일간 비활성 상태일 때 재활성화 push 보내기

4부. Web push 활성화(및 스토어프론트 탐색 이벤트)

web push만 사용하려면 선택 사항입니다. Shopify 이벤트 및 캠페인에서 제품 조회 및 장바구니 담기 이벤트가 필요한 경우 필수입니다.

스토어프론트에서 브라우저 web push를 위한 테마 임베드를 켭니다:

1. Online Store → Themes → Customize로 이동합니다
   
2. 왼쪽 메뉴에서 App Embeds를 엽니다
3. Push Init Embed를 켭니다

참고

이제 스토어에서 스토어프론트로부터 직접 사용자에게 web push 구독을 요청할 수 있습니다. 이 토글을 건너뛰면 Shopify 이벤트 및 캠페인에서 스토어프론트 탐색 이벤트도 얻지 못합니다. 주문 결제 및 체크아웃 이벤트는 이것이 없어도 계속 도착합니다.

데이터 규정 준수

Shopify는 모든 공개 앱이 필수 GDPR/CCPA webhook에 응답하도록 요구합니다. Pushwoosh는 다음과 같이 이를 처리합니다:

• customers/redact: 쇼핑객이 스토어에 데이터 삭제를 요청하면, Pushwoosh는 Shopify가 보낸 식별자(email, 전화번호, Shopify 고객 ID)에 따라 해당 Pushwoosh 레코드를 삭제합니다.
• customers/data_request: 쇼핑객이 자신의 데이터 사본을 요청하면, Pushwoosh는 지원팀의 내부 채널에 알림을 게시하고, 담당자가 요청을 수동으로 처리합니다. Shopify는 앱이 이러한 요청에 30일 이내에 응답하도록 요구합니다.
• shop/redact: 스토어가 앱을 제거한 지 48시간 후 Shopify가 이를 보내며, 스토어 데이터 삭제를 요청합니다. Pushwoosh는 제거 자체가 트리거하는 것과 동일한 삭제를 다시 실행하여, 남아 있는 세션을 정리하고 스토어의 연동 기록(디바이스 API 키, 애플리케이션 코드, 결제 ID 포함)을 삭제합니다. 이는 제거가 처음에 완전히 정리되지 않은 경우를 위한 안전망으로 존재합니다.

사용 사례 요약

설정 후, Shopify에서 메시지를 보내는 일반적인 방법:

시나리오	사용된 도구
개인화된 후속 조치	Notification by Customer
세그먼트 기반 프로모션	Notification by Segment
가입 후 환영 메시지	Flow + 메타필드 추적
장바구니 이탈 리마인더	Shopify Flow + Pushwoosh 액션
Push 구독	테마 임베드 + Push Init 토글

주문, 장바구니, 체크아웃, 스토어프론트 이벤트에 대한 journey와 세그먼트는 Shopify 이벤트 및 캠페인을 참조하세요.