AI 코딩 도구로 FinallyData 설치하기

이 웹사이트(내쇼핑몰.com)에 "FinallyData" 방문·구매 분석 스크립트를 설치해 줘. 코드는 네가 직접 고치고, 끝나면 바꾼 파일과 위치를 알려 줘.

## 1. 모든 페이지에 스크립트 한 줄
모든 페이지의 <head> 안에 아래 한 줄을 그대로 넣어 줘. 이미 있으면 건너뛰어.

<script async src="https://app.finallydata.com/t/내사이트키.js"></script>

- 공통 레이아웃(모든 페이지가 지나가는 한 곳)에 넣어. 예: Next.js App Router 는 app/layout.tsx 의 <head>, Pages Router 는 pages/_document.tsx, React·Vue 는 index.html, WordPress 는 테마의 wp_head, 그 밖은 공통 헤더 템플릿.
- async 는 지우지 마 (페이지 속도에 영향 없게).
- 새로고침 없이 페이지가 바뀌는 사이트(SPA)도 스크립트가 알아서 따라가. 라우터에 따로 코드를 넣을 필요 없어.

## 2. 구매(주문) 완료 신호
구매가 끝난 순간(주문 완료 페이지, 또는 결제 성공 콜백) 한 번만 아래를 실행해 줘. 주문번호와 결제금액은 그 화면·응답의 실제 값으로 바꿔.

<script>
  window.adp = window.adp || function () { (adp.q = adp.q || []).push(arguments) };
  adp('purchase', { id: '주문번호', amount: 결제금액, shipping: 배송비, currency: 'KRW' });
</script>

- amount 는 결제 화폐 단위의 숫자 (배송비 포함 실제 결제금액 — 원이면 49000, 달러면 49.99). shipping 은 없으면 빼도 돼.
- currency 는 실제 결제 화폐의 ISO 코드 (KRW · USD · JPY · EUR …). 화폐를 빼면 원화로 세니 원화가 아니면 꼭 넣어.
- 새로고침할 때마다 다시 보내지 않게 해 줘 (같은 주문번호는 서버가 한 번만 세지만).
- 이미 GA4 구매 이벤트(dataLayer 의 purchase 또는 gtag('event', 'purchase'))를 보내고 있으면 이 단계는 하지 마 — 스크립트가 그걸 자동으로 읽어.
- 구매자 이름·이메일·전화번호·주소 같은 개인정보는 절대 넣지 마.

## 3. 결제사를 쓰면 — 결제에 방문 번호 싣기
Stripe·LemonSqueezy·Polar·토스페이먼츠·포트원으로 결제를 받는다면, 결제를 만드는 코드에 우리 스크립트의 방문 번호를 실어 줘.
결제사가 결제·환불·구독 갱신을 FinallyData에 바로 알려 주고, 이 번호로 어디서 온 손님이 결제했는지 이어. (결제사 연결 자체는 FinallyData 설정 → 결제 연결에서 대표가 한다)
- 방문 번호 = 쿠키 _adp_v (16자). 세션 번호 = 쿠키 _adp_s 의 '~' 앞부분 (선택). 브라우저에서는 window.adp.visitorId 로도 읽을 수 있어.
- Stripe Checkout: sessions.create 에 metadata: { adp_visitor_id, adp_session_id } 와 client_reference_id: 'adp_<방문 번호>_<세션 번호>', 구독이면 subscription_data.metadata: { adp_visitor_id } 도
- Stripe PaymentIntent 만 쓰면: paymentIntents.create 의 metadata: { adp_visitor_id }
- LemonSqueezy: checkout_data.custom: { adp_visitor_id, adp_session_id }
- Polar: checkouts.create 의 metadata: { adp_visitor_id, adp_session_id }
- 토스페이먼츠: requestPayment 의 metadata: { adp_visitor_id }
- 포트원 V2: requestPayment 의 customData: { adp_visitor_id }
- 그 밖의 PG(KG이니시스·NHN KCP 등)나 토스 자동결제: 서버에서 결제를 확인한 직후 https://app.finallydata.com/api/v1/payments 로 POST
  (헤더 Authorization: Bearer <결제 API 키 — 대표에게 받아 환경변수로>, 본문 { "transaction_id", "amount"(화폐 단위), "currency", "adp_visitor_id" }). 키를 브라우저 코드에 넣지 마.
- 결제사를 쓰는 경우 2번의 adp('purchase') 는 남겨 두되 id 에는 결제사가 성공 화면에 주는 번호(Stripe session_id · 토스 orderId · 포트원 paymentId)를 넣어 줘 — 같은 결제로 이어서 두 번 세지 않아.

## 4. 확인
1. 배포한 뒤 https://내쇼핑몰.com/?adp_check=1 를 브라우저로 열어. FinallyData 앱의 설치 탭에서 "설치 확인"에 체크 표시가 뜨면 성공이야.
2. 개발자 도구 네트워크 탭에서 스크립트 주소의 /api/e 로 가는 요청이 204 로 끝나는지 봐.

## 하지 말 것
- 다른 분석 도구(GA4·GTM·픽셀) 설정은 건드리지 마.
- 스크립트 주소나 키를 바꾸지 마.
- 새 패키지를 설치하지 마 (한 줄이면 충분해).