웹 푸시 알림, 고객 태그, 커머스 이벤트 및 행동 타겟팅을 위해 Vendo 통합을 통해 Shopify를 OneSignal에 연결합니다.
OneSignal은 Vendo와 파트너십을 맺어 원활한 Shopify 통합을 만들었습니다. Vendo는 클릭 한 번으로 Shopify 스토어에 OneSignal SDK를 배포합니다 — 테마 코드를 수동으로 편집할 필요가 없습니다. 고객 태그, 클라이언트 사이드 탐색 이벤트, 서버 사이드 커머스 이벤트를 OneSignal에 동기화하여 실제 행동과 구매 이력을 기반으로 세그먼트를 만들고 푸시 캠페인을 트리거할 수 있습니다.Vendo 문서는 Vendo OneSignal Destination을 참조하세요.
고객이 https://your-site.com/과 같은 커스텀 도메인을 통해 사이트에 액세스하는 경우 https://your-site.myshopify.com/을 사용하지 마세요.
Default Icon URL: 알림 프롬프트 및 메시지용 256x256px 정사각형 PNG 또는 JPG 이미지를 업로드합니다. 설정하지 않으면 벨 아이콘이 사용됩니다.
3
서비스 워커 경로 구성
Shopify는 사이트 루트에서 파일을 제공할 수 없으므로 Vendo가 서비스 워커 파일을 제공하는 위치를 OneSignal에 알려야 합니다.OneSignal에서 Settings > Push & In-App > Web Settings으로 이동하고 Advanced Push Settings까지 스크롤하여 다음과 같이 구성합니다:
설정
값
Service Worker Path
/apps/vendo/
Service Worker Filename
OneSignalSDKWorker.js
Updater Filename
OneSignalSDKWorker.js
Service Worker Registration Scope
/apps/vendo/
Vendo를 사용하는 Shopify 스토어의 서비스 워커 구성.
Vendo는 https://yourstore.myshopify.com/apps/vendo/OneSignalSDKWorker.js에 필요한 OneSignalSDKWorker.js 파일을 자동으로 제공합니다 — 수동 파일 업로드가 필요하지 않습니다.
Updater Filename과 Service Worker Filename은 동일한 파일입니다. OneSignal v16+는 두 가지 목적 모두에 단일 서비스 워커를 사용합니다.
4
자격 증명 복사
OneSignal에서 Settings > Keys & IDs로 이동하여 App ID와 REST API Key를 복사합니다. Vendo에 입력할 것입니다.
모바일 앱이나 서드파티 연결이 있는 경우, 사용자 프로필이 플랫폼 전반에 걸쳐 일관되게 유지되도록 다른 도구와 일치하는 식별자(Shopify Customer ID 대 Email)를 선택하세요. Vendo 앱의 Settings > Customer Identifier에서 구성합니다.
푸시 구독자(OneSignal ID로 식별)가 나중에 로그인하거나 구매를 완료하면 Vendo는 해당 Shopify Customer ID 또는 이메일로 OneSignal.login()을 호출합니다. OneSignal은 푸시 구독을 식별된 사용자에 연결합니다 — 중복 사용자가 생성되지 않습니다. 모든 과거 푸시 구독이 보존되고, 서버 사이드 이벤트(주문, 이행)가 올바른 사용자 프로필에 도달합니다.
브라우저에서 https://yourstore.myshopify.com/apps/vendo/OneSignalSDKWorker.js를 방문합니다. JavaScript 코드가 보여야 합니다. 404가 표시되면 Vendo 앱이 설치되어 있는지 확인하세요.브라우저 DevTools(F12)를 열고 Application > Service Workers로 이동하여 OneSignalSDKWorker.js가 범위 /apps/vendo/로 등록되어 있는지 확인할 수도 있습니다.
서비스 워커는 /apps/vendo/OneSignalSDKWorker.js에 있어야 합니다. 루트 경로(/OneSignalSDKWorker.js)에서 404 오류가 표시되면 OneSignal에 서비스 워커 경로가 구성되지 않은 것입니다 — 서비스 워커 구성 단계를 따르세요. /apps/vendo/ 경로에서 404가 발생하면 Vendo 앱이 설치되어 있고 테마 블록이 활성화되어 있는지 확인하세요.
Vendo 앱의 OneSignal > Events에서 이벤트가 활성화되어 있는지 확인하세요. 클라이언트 사이드 이벤트는 Shopify Web Pixel이 활성화되어 있고 사용자가 식별되어 있어야 합니다. 서버 사이드 이벤트는 REST API Key가 구성되어 있어야 합니다.
식별되지 않은 방문자의 이벤트는 OneSignal로 전송되지 않습니다. 방문자가 자신을 식별하면(푸시 구독, 로그인, 뉴스레터 가입 또는 결제 완료), Vendo가 이벤트를 보내기 시작합니다. 이 식별된 사용자 전용 접근 방식은 중복 사용자를 방지하고 깔끔한 데이터를 보장합니다.
이전 버전은 Shopify의 세션 쿠키를 식별자로 사용하여 익명 방문자를 추적했습니다. 이로 인해 적절하게 병합할 수 없는 중복 OneSignal 사용자가 생성되어 사용자 수 부풀리기와 데이터 단편화가 발생했습니다. 식별된 사용자 전용 접근 방식은 모든 OneSignal 사용자가 실제로 존재하고 실행 가능함을 보장합니다.
