임베드 위젯 문서

임베드 가능한 위젯이란?

단일 iframe 태그로 Akousa의 557+개 이상의 도구를 자신의 웹사이트에 임베드하세요. 위젯은 완전히 반응형이고 커스터마이징 가능하며 20개 언어를 모두 지원합니다.

임베드 갤러리를 방문하여 도구를 탐색하고, 미리 보고, 임베드 코드를 복사하세요. 사이트에 맞게 테마(라이트/다크), 언어, 크기를 커스터마이징하세요.

도구 임베드 방법

1. 1임베드 갤러리 또는 도구의 문서 페이지를 방문하세요
2. 2iframe 임베드 코드를 복사하세요
3. 3웹사이트의 HTML에 붙여넣으세요

임베드 코드 예시

'<'iframe src="https://akousa.net/embed/json-formatter?theme=dark&lang=en" width="100%" height="500" frameborder="0">'<'/iframe>

기능

• ✓/embed-gallery를 방문하여 임베드 가능한 도구를 탐색하세요.
• ✓iframe 코드를 복사하세요. lang 및 theme 파라미터로 커스터마이징하세요.
• ✓HTML에 iframe을 붙여넣으세요.

커스터마이징 옵션

• 테마 (라이트/다크/시스템)
• 언어 (20개 옵션)
• 크기 (HTML 속성으로 너비 및 높이 조정)

Content Security Policy & Security

All embed widgets use strict Content Security Policy headers with frame-ancestors configured for cross-origin embedding. Data processing happens entirely in the visitor's browser — no user data is transmitted to Akousa servers. The embed is served over HTTPS with the same security standards as the main platform. Your visitors' data stays on their device.

Anonymous Analytics

임베디드 위젯은 사용 패턴을 이해하는 데 도움이 되도록 익명 조회수를 내부적으로 추적합니다. 방문자로부터 개인 식별 정보를 수집하지 않습니다. 분석은 가볍고 위젯 성능이나 로드 시간에 영향을 주지 않습니다.

성능 최적화

임베드 페이지는 빠른 초기 로드를 위해 사전 렌더링되고 주기적으로 재검증됩니다. iframe은 비동기적으로 로드되며 페이지 렌더링을 차단하지 않습니다. 지연 로딩(loading="lazy")과 결합하면 임베디드 위젯이 사이트의 Core Web Vitals 점수에 거의 영향을 미치지 않습니다.

Speakable Structured Data

Each embed page includes Speakable schema markup, making widget content eligible for voice assistant read-aloud. This improves accessibility for visually impaired users and positions your embedded tools for voice search discovery.

자주 묻는 질문

어떤 도구를 임베드할 수 있나요?

/embed/[slug] URL 형식으로 557+개의 도구 전부.

임베딩이 무료인가요?

네, 사용 제한 없이 완전히 무료.

외관을 커스터마이징할 수 있나요?

네, ?lang=tr 및 ?theme=dark URL 파라미터로.

임베디드 콘텐츠는 안전한가요?

Yes. Embedded widgets use a strict Content Security Policy (CSP) with frame-ancestors configured to allow cross-origin embedding. All data processing happens in the visitor's browser — no user data is transmitted to our servers.

임베디드 도구가 내 웹사이트를 느리게 만드나요?

Embedded tools load asynchronously within the iframe and do not block your page rendering or affect your site's performance. The iframe loads independently, so even if the widget takes a moment to initialize, your page content appears instantly. The widget code is optimized and cached for fast loading via static generation with periodic revalidation.

WordPress에 도구를 임베드할 수 있나요?

네. WordPress 블록 에디터의 맞춤 HTML 블록에 iframe 코드를 붙여넣으세요. WordPress 사이트에서 iframe을 제거하는 보안 플러그인을 사용하는 경우, 플러그인 설정에서 akousa.net을 허용 목록에 추가하세요. 임베드는 WordPress.com Business 플랜과 모든 셀프 호스팅 WordPress.org 설치에서 작동합니다.

임베드된 위젯이 분석 데이터를 추적하나요?

임베디드 위젯은 내부 분석을 위해 익명 조회수만 기록합니다. 방문자에게 쿠키가 설정되지 않고, 개인 데이터가 수집되지 않으며, iframe 내부에 타사 추적기가 로드되지 않습니다. 사이트의 자체 분석(Google Analytics, Plausible 등)은 임베드의 영향을 받지 않습니다.

임베딩을 위해 CSP 헤더를 설정해야 하나요?

사이트에서 Content Security Policy를 사용하는 경우, CSP 헤더에 'frame-src https://akousa.net'을 추가하여 iframe을 허용하세요. 명시적 CSP가 없는 대부분의 사이트는 바로 작동합니다. 임베드 엔드포인트 자체는 모든 오리진에서 로드할 수 있도록 허용적인 frame-ancestors 헤더를 설정합니다.

임베딩이 페이지 성능에 어떤 영향을 주나요?

각 임베드된 위젯은 격리된 iframe 컨텍스트에서 로드되므로 페이지의 메인 스레드, DOM, 핵심 렌더링 경로를 차단하지 않습니다. iframe 태그에 loading="lazy"를 추가하면 위젯이 뷰포트에 스크롤될 때까지 로딩을 지연하여 페이지의 코어 웹 바이탈을 더욱 향상시킬 수 있습니다.

임베드된 도구를 상업 프로젝트에 사용할 수 있나요?

네, 상업 웹사이트, SaaS 대시보드, 클라이언트 프로젝트, 내부 도구에 모든 도구를 자유롭게 임베드할 수 있습니다. 라이선스 비용, 사용 제한, 각 위젯에 자동 포함되는 작은 'Powered by akousa.net' 링크 외에 속성 표시 요구 사항이 없습니다.

관련 문서

• 도구 문서

  557+개의 무료 온라인 도구 사용법에 대한 완전한 가이드입니다. 개발자 도구, 텍스트 프로세서, 컨버터, 제너레이터에 대해 알아보세요 — 모두 브라우저에서 실행되며 가입이 필요없습니다.

• 개발자 API 레퍼런스

  13개 그룹에 걸친 64개 엔드포인트를 가진 akousa.net REST API의 완전한 문서.

• Embed Gallery

  The Embed Gallery at /embed-gallery is a dedicated landing page for webmasters. Browse all 557+ embeddable tools, preview how each looks as a widget, check recommended dimensions, and copy the ready-to-use iframe code with one click.

• PDF Suite 문서

  13개의 PDF 도구 가이드: 병합, 분할, 압축, 변환 등.