Shopify를 GA4에 원클릭으로 연결 — Converlay가 수동 API 시크릿 설정을 없앴습니다
서버사이드 GA4 트래킹을 수동으로 설정해 본 적이 있다면, 아마 같은 벽에 부딪혔을 것입니다: 바로 Measurement Protocol API 시크릿입니다. Google Analytics 4가 서버사이드 이벤트를 수신하려면 이 시크릿이 필요하지만, 이를 생성하는 위치를 찾으려면 GA4 관리(Admin) 인터페이스의 여러 메뉴를 깊숙이 들어가야 합니다. 많은 판매자가 잘못된 종류의 자격 증명을 생성하거나, 잘못 입력하거나, 설정을 아예 포기해 버립니다. 그 결과, 원래 얻고자 했던 완전한 구매 데이터를 끝내 확보하지 못하게 됩니다.
Converlay v2.17.0에서는 이러한 번거로움이 사라졌습니다. 새로운 "Google로 연결" 플로우는 OAuth를 통해 Google 계정으로 인증하고, Shopify 스토어에 해당하는 GA4 속성과 데이터 스트림을 정확히 선택할 수 있게 해 주며, Measurement Protocol API 시크릿을 서버사이드에서 자동으로 생성합니다 — GA4 관리 화면을 열 필요가 전혀 없습니다. 그리고 다음 날 출시된 v2.18.0은 마지막 남은 수동 단계까지 제거합니다: 프로비저닝 후 전송 대상을 활성화하는 작업도 이제 자동으로 이루어집니다.
그 결과, GA4 API를 한 번도 다뤄 본 적 없는 Shopify 판매자도 Google OAuth 승인 화면을 통과하는 데 걸리는 시간만으로 제로에서 완전한 서버사이드 이벤트 전송까지 도달할 수 있습니다.
기존 설정 프로세스가 왜 문제였는가
GA4의 Measurement Protocol은 강력합니다 — 어떤 서버든 브라우저, 광고 차단기, 쿠키 제한을 완전히 우회하여 Google Analytics에 직접 이벤트를 보낼 수 있습니다. 하지만 이를 사용하려면 두 가지 정보가 필요합니다: Measurement ID(GA4 데이터 스트림 개요 페이지에서 확인 가능)와 Measurement Protocol API 시크릿(같은 페이지의 다른 영역, 많은 판매자가 끝내 발견하지 못하는 섹션에서 별도로 생성)입니다.
이 시크릿에 도달하려면 GA4 관리(Admin)로 이동해 속성을 선택하고, 데이터 스트림을 열고, 웹 스트림을 선택한 뒤, 관련 없는 여러 설정을 지나 스크롤하고, 마지막으로 하단 하위 섹션에 있는 "Measurement Protocol API 시크릿"을 클릭해야 합니다. 거기서 새 시크릿을 생성하고 별칭을 지정한 뒤 생성된 토큰을 복사해야 하며 — 이를 오타 없이 Converlay의 전송 대상 설정에 붙여넣어야 합니다.
이 단계들 하나하나가 잠재적인 실패 지점입니다. 판매자들은 웹 스트림 시크릿 대신 Firebase App 시크릿을 생성하기도 합니다. 올바른 종류의 시크릿을 만들었지만 잘못된 속성에 만드는 경우도 있는데, GA4 속성이 여러 개 있어 실수로 개발용 속성을 선택했기 때문입니다. 모든 것을 올바르게 진행한 판매자조차 가끔 붙여넣기 실수를 하여, 한 글자 차이로 잘못된 API 시크릿을 트러블슈팅하느라 한 시간을 허비하기도 합니다.
이 중 어느 것도 Google의 잘못은 아닙니다 — Measurement Protocol은 비기술 사용자를 위해 설계된 것이 아닌 개발자 API입니다. 하지만 분석을 설정하는 Shopify 판매자가 정확한 구매 데이터를 얻기 위해 GA4 자격 증명 시스템의 내부 구조까지 이해해야 할 필요는 없습니다.
새로운 "Google로 연결" 플로우의 작동 방식
v2.17.0부터 Converlay의 GA4 전송 대상은 수동 자격 증명 입력 폼 대신 "Google로 연결" 버튼을 표시합니다. 클릭하면 표준 OAuth 승인 플로우가 시작됩니다 — 어떤 앱이든 Google 계정 접근을 요청할 때 보게 되는 것과 동일한 로그인 및 동의 프로세스입니다.
승인이 완료되면 Converlay는 Google Analytics 계정을 가져와 접근 권한이 있는 모든 GA4 속성을 나열하고, Converlay 대시보드 안의 속성 선택기에 표시합니다. Shopify 스토어에 해당하는 속성을 선택하면 되고 — 속성이 여러 개라면 선택기에 각 속성의 이름이 표시되어 올바른 속성을 식별할 수 있습니다 — 그다음 해당 속성 내의 데이터 스트림을 선택합니다.
이후 Converlay는 GA4 Management API를 서버사이드에서 호출하여 해당 스트림에 대한 Measurement Protocol API 시크릿을 생성하고, 자격 증명을 스토어에 안전하게 연결하여 저장하며, 연결이 완료됩니다. 원본 API 시크릿 값을 볼 일도 없고, 탭 사이를 오가며 복사-붙여넣기할 일도 없습니다.
v2.18.0에서는 프로비저닝 후 전송 대상도 자동으로 활성화됩니다. 이전에는 전송 대상을 켜고 저장해야 하는 최종 검토 및 활성화 단계가 있었습니다. 라이브 전에 설정을 검토하고 싶은 판매자를 위해 이 단계는 여전히 존재하지만, OAuth 선택기 플로우를 거친 판매자의 경우 — 데이터 스트림을 선택하는 것 자체가 이미 명확한 의사 표현이므로 — Converlay는 이제 단일 서버사이드 호출로 전송 대상을 활성화하고 저장된 자격 증명과 병합합니다. 전송 대상을 일시 중지하고 싶을 때는 언제든 토글을 사용할 수 있습니다.
GA4로 전송되는 데이터
기반이 되는 이벤트 파이프라인은 변경되지 않았습니다 — 설정 경험만 달라졌습니다. 연결이 완료되면 Converlay는 Measurement Protocol을 사용하여 Shopify 스토어프런트 이벤트를 GA4로 전달하며, 다음이 포함됩니다:
- purchase — 주문이 접수될 때 발생하며, 전체 트랜잭션 ID, 매출, 세금, 배송비, 통화, 상품 배열을 포함합니다. 정확한 이커머스 보고를 위한 가장 중요한 이벤트입니다.
- add_to_cart 및 remove_from_cart — Shopify 스토어프런트 장바구니 인터랙션에 의해 트리거되며, 상품 상세 정보를 포함합니다.
- begin_checkout — 고객이 결제 프로세스를 시작할 때 발생합니다.
- page_view — 각 페이지 로드마다 전송되며, 표준 URL과 리퍼러를 포함합니다.
- view_item 및 view_item_list — 전체 상품 메타데이터를 포함한 상품 및 컬렉션 조회입니다.
모든 이벤트에는 세션 중 브라우저가 캡처한 GA4 클라이언트 ID가 포함됩니다. 이를 통해 서버사이드 이벤트가 GA4의 사용자 탐색기와 어트리뷰션 보고서에서 브라우저사이드 세션과 올바르게 연결됩니다 — 구매가 고립된 별개의 이벤트가 아니라 올바른 세션 아래에 표시됩니다.
이벤트 중복 제거는 purchase 이벤트의 트랜잭션 ID를 사용하므로, 브라우저사이드 GA4 트래킹도 함께 활성화되어 있는 경우 GA4가 동일한 트랜잭션 ID를 사용해 구매 이중 집계를 자동으로 방지합니다. 서버사이드 이벤트는 광고 차단기나 브라우저 스크립트 실패로 인한 공백을 채워 줍니다.
연결 후 GA4에서 확인할 수 있는 것
연결 후 몇 분 이내에 GA4의 실시간 보고서에 서버사이드 이벤트가 나타나기 시작합니다. purchase 이벤트에는 완전한 상품 배열이 포함되어 있으므로 GA4의 기본 제공 이커머스 보고서 — 매출, 거래, 구매 상품 — 가 실제 데이터로 채워집니다.
대부분의 판매자에게 가장 눈에 띄는 개선은 구매 이벤트 완전성입니다. 브라우저 기반 GA4 트래킹은 일반적으로 거래의 60~80퍼센트만 캡처합니다 — 나머지는 광고 차단기, 브라우저 개인정보 보호 기능, 또는 결제 직후 탭을 바로 닫는 고객으로 인해 유실됩니다. Converlay의 서버사이드 트래킹은 Shopify의 주문 웹훅에서 직접 구매를 캡처하므로, 구매자의 브라우저나 개인정보 설정과 관계없이 캡처율이 일관되게 95퍼센트를 넘습니다.
Google Ads 캠페인을 운영하고 있다면 이러한 완전성은 자동 입찰에 중요합니다. Google의 스마트 자동 입찰(Smart Bidding)과 실적 최대화(Performance Max) 캠페인은 전환 신호를 향해 최적화합니다. 구매의 상당 부분이 GA4에 도달하지 못하면 입찰 알고리즘이 실제 전환율을 과소평가하고 예산을 보수적으로 배분합니다. 더 완전한 구매 데이터는 알고리즘이 실제로 무엇이 전환되는지 더 정확하게 파악하게 하며, 이는 일반적으로 시간이 지남에 따라 더 나은 캠페인 성과로 이어집니다.
세션 토큰 안정성 (v2.18.0)
v2.18.0의 또 다른 수정 사항 중 하나는 간헐적인 저장 실패를 일으킬 수 있었던 안정성 엣지 케이스를 해결합니다. Converlay는 Shopify 관리자 임베드에서의 인증된 요청에 App Bridge 세션 토큰을 사용합니다. 이 토큰은 60초의 만료 시간을 가지며, 기존 동작에서는 토큰이 발급된 시점과 서버사이드에서 요청이 검증되는 시점 사이의 짧은 구간에서 토큰이 만료되면 저장이 401 오류로 실패했습니다.
v2.18.0은 서버사이드 토큰 검증에 10초의 클록 스큐(clock-skew) 허용치를 추가했으며, 이제 클라이언트는 401 응답 시 새 App Bridge 토큰을 자동으로 재발급받아 한 번 재시도합니다. 연결이 느리거나 네트워크 지연이 있는 판매자에게, 이는 설정과 무관하게 발생하던 답답한 "다시 시도해 주세요" 유형의 오류를 제거해 줍니다.
Google이 요청을 차단할 때 개선된 오류 가시성
v2.18.0 릴리스는 GA4 API 오류가 표시되는 방식도 개선합니다. Converlay가 사용하는 HTTP 클라이언트인 Axios는 원본 응답 본문을 자체 오류 메시지로 감쌉니다 — 즉 Google이 구조화된 오류(예: 어떤 권한이 없는지 설명하는 reason 필드가 포함된 403)를 반환할 때, 그 맥락이 이전에는 사라져 버렸다는 뜻입니다. 판매자에게는 "Request failed with status code 403"만 보였습니다.
이제 Google이 구조화된 오류 응답을 반환하면 Converlay가 그 이유(reason)를 추출하여 서버 로그와 판매자에게 표시되는 오류 문구 모두에 포함합니다. 선택한 GA4 속성에 대해 Google 계정에 수정 권한이 없다면, 일반적인 실패 메시지 대신 그 사실을 설명하는 메시지가 표시됩니다. 이는 특히 OAuth 연결은 성공했지만 연결된 Google 계정이 해당 속성에 대한 적절한 권한이 없는 경우에 트러블슈팅을 훨씬 빠르게 만들어 줍니다.
Shopify 스토어를 GA4에 연결하는 방법
이미 Converlay 사용자라면, 새 플로우는 오늘부터 전송 대상(Destinations) 설정에서 사용할 수 있습니다. GA4 전송 대상으로 이동해 "Google로 연결"을 클릭하세요. 이전에 자격 증명을 수동으로 입력했더라도 언제든 OAuth 방식으로 전환할 수 있습니다 — 선택기 플로우가 이벤트 기록에 영향을 주지 않고 저장된 자격 증명을 업데이트합니다.
아직 Converlay를 사용하지 않는다면 설정에 몇 분이면 충분합니다:
- Shopify App Store에서 Converlay를 설치하고 Shopify 관리자에서 엽니다.
- 전송 대상(Destinations)으로 이동해 Google Analytics 4를 선택합니다.
- "Google로 연결"을 클릭하고 GA4 속성에 접근 권한이 있는 Google 계정으로 승인합니다.
- 드롭다운에서 GA4 속성과 데이터 스트림을 선택합니다.
- Converlay가 API 시크릿을 생성하고 트래킹을 자동으로 활성화합니다.
몇 분 안에 GA4가 Shopify 스토어의 서버사이드 구매 이벤트를 수신하기 시작합니다. 전환 데이터는 더 완전해지고, 어트리뷰션은 더 정확해지며, Google Ads 캠페인은 더 나은 신호를 바탕으로 작동하게 됩니다.
설정 스트레스 없이 정확한 GA4 데이터
서버사이드 GA4 트래킹은 언제나 Shopify 스토어에 올바른 접근 방식이었습니다. 한계는 기술적인 것이 아니었습니다 — Measurement Protocol은 안정적이고 잘 지원됩니다. 한계는 설정의 번거로움이었습니다: 깊숙이 숨겨진 자격 증명, 여러 단계의 수동 프로세스, 그리고 실수할 수 있는 너무 많은 지점이었습니다.
v2.17.0과 v2.18.0의 "Google로 연결" OAuth 플로우와 자동 활성화 변경 사항이 그 번거로움을 없앴습니다. Google 계정을 승인하고 속성을 선택하는 데는 1분도 걸리지 않으며, 그 이후의 API 자격 증명 라이프사이클은 Converlay가 처리합니다.
자격 증명을 찾아 헤매지 않고 GA4에서 완전하고 정확한 이커머스 데이터를 얻고 싶다면, 새로운 설정 플로우를 오늘 바로 Converlay에서 사용할 수 있습니다. Shopify App Store에서 Converlay를 설치하고 단 한 번의 OAuth 단계로 GA4 속성을 연결하세요.