스크립트 설치

설치는 페이지 head에 스크립트 태그 한 줄을 추가하면 완료됩니다. 비동기로 로드되어 화면 렌더링을 차단하지 않으며, 방문자 기기에 쿠키를 저장하지 않습니다.

스크립트 태그

연동 화면에서 태그를 복사합니다. 태그에는 공개 키가 포함됩니다. 공개되어도 무방한 키이며 등록한 도메인에서만 동작합니다.

<script async src="https://…/l.js" data-loop="pk_live_…"></script>

터미널에서 설치

소스 코드가 있는 프로젝트에서는 명령어 하나로 태그를 추가할 수 있습니다. 연동 화면에서 키가 포함된 명령어를 복사하세요. 프레임워크를 감지하고 변경 내용을 표시한 뒤, 파일을 수정하기 전에 확인을 요청합니다.

옵션: --yes는 확인 없이 수정합니다(코딩 에이전트나 스크립트용). --dry-run은 변경 내용만 표시합니다. --dir로 다른 폴더를 지정합니다. 두 번 실행해도 두 번째에는 아무것도 변경되지 않습니다. 운영 중인 페이지에 태그가 있는지 확인하려면: npx https://loopis.net/cli.tgz check your-site.com

npx https://loopis.net/cli.tgz init --key pk_live_…

자동으로 수정하는 대상: Next.js(App Router, Pages Router), Remix, React Router, SvelteKit, Astro, Vite, Create React App, 그리고 head를 닫는 HTML, Liquid, PHP, Nunjucks 템플릿. Nuxt와 Gatsby는 수정하지 않고 추가할 코드 한 줄을 출력합니다. Node.js 18 이상이 필요하며, 아직 npm 레지스트리에 등록되어 있지 않으므로 주소를 그대로 입력합니다.

플랫폼별 설치 위치

플랫폼위치
워드프레스외모 → 테마 파일 편집기 → header.php, 또는 헤더 스크립트 플러그인
Ghost설정 → Code injection → Site header
티스토리스킨 편집 → HTML → <head> 안
Webflow사이트 설정 → Custom code → Head code
Squarespace설정 → 고급 → Code Injection → Header
Wix설정 → Custom code → Head
Shopify온라인 스토어 → 테마 → 코드 편집 → theme.liquid

AI로 설치

연동 → AI로 설치에서 Claude Code, Cursor, Codex용 지시문을 제공합니다. 추가할 태그, 프레임워크별 위치, 수정하면 안 되는 항목, 확인 방법이 정확히 명시되어 있습니다. 검토를 마친 고정 문장으로 구성되며 공개 키만 포함됩니다.

React와 Next.js

스크립트와 슬롯을 감싼 컴포넌트가 SDK 패키지에 포함되어 있습니다. 패키지는 아직 npm에 등록되어 있지 않으므로 대부분의 경우 스크립트 태그 사용을 권장합니다. Next.js App Router에서는 app/layout.tsx에 추가하거나 next/script에 같은 속성을 지정하면 됩니다.

Content-Security-Policy

사이트가 Content-Security-Policy 헤더를 전송한다면, 스크립트의 출처를 script-src와 connect-src 양쪽에 허용해야 합니다.

사이트 인증 방식

업로드할 파일도, 추가할 DNS 레코드도 없습니다. 해당 도메인의 페이지에서 스크립트가 Loopis를 호출하는 것이 곧 사이트 관리 권한의 증명입니다. 가장 먼저 호출이 확인된 계정이 해당 도메인을 소유합니다. 그 전에는 누구나 인증되지 않은 초안을 보유할 수 있으며, 인증되지 않은 사이트는 트래픽 교환에 참여하지 않습니다.

자주 묻는 질문

스크립트 크기는 얼마인가요?
압축 기준 4KB 미만입니다.
쿠키를 저장하나요?
쿠키는 저장하지 않으며, 유닛을 노출하는 사이트에서는 방문자 기기에 아무것도 저장하지 않습니다. 예외는 하나입니다. 추천을 눌러 도착한 사이트에서는 그 방문을 가리키는 표시를 해당 탭에만 최대 1시간 보관합니다. 그 사이트에서 일어난 가입이나 구매를 세기 위한 것이며, 탭을 닫으면 사라지고 다른 사이트에서는 읽을 수 없습니다.
태그 매니저로 넣어도 되나요?
가능합니다. data-loop 속성만 유지되면 됩니다. head에 직접 추가하면 인증이 더 빠르게 완료됩니다.

다음노출 위치 →