무엇을 하나요
비자 체커 위젯은 Orizn 임베드 스위트에서 가장 많이 요청되는 위젯입니다. 여행 콘텐츠가 다뤄야 할 가장 흔한 질문 — "비자가 필요한가요?" — 에 독자를 외부 사이트로 보내 퍼널을 끊는 일 없이 바로 답합니다.
내부적으로 위젯은 Orizn의 비자 그래프를 조회합니다: 대사관 피드, IATA, 정부 보도자료, 그리고 200개 이상의 공식 소스를 수집하는 자체 스크레이퍼로부터 매일 밤 조정되는 39 601개의 여권-목적지 셀 데이터베이스입니다. 각 셀에는 정책 유형(비자 프리, 도착 비자, e-비자, 대사관, 입국 거부), 최대 체류 기간, 처리 기간, 수수료, 출처 URL이 담겨 있습니다.
독자가 검색 가능한 선택기(199개 옵션, 현지어 국가명)에서 여권을 고르고 목적지를 탭하면, 200 ms 이내에 규정, 다음 단계 CTA, 그리고 해당 목적지의 Orizn 전체 여행 가이드로 연결되는 선택적 제휴 링크가 담긴 결과 카드가 반환됩니다. 위젯은 완전히 자체 마운트됩니다 — 호출할 init 함수도, 연결할 React 프로바이더도 없습니다 — 모든 HTML 페이지, 주요 CMS 전부, 그리고 next/script를 통한 React/Next.js 내부에서 작동합니다.
위젯 빌더
아래 위젯은 실제 사이트에 붙여넣게 될 프로덕션 스크립트와 정확히 동일하게 실행됩니다. 언어, 테마, 색상, 화이트라벨 — 모든 옵션이 미리보기와 스니펫을 즉시 갱신합니다. 완성되면 두 줄 스니펫을 복사하세요.
Live preview · updates as you type
The widget above runs the exact production script you would paste on your own site — async, zero dependencies, scoped CSS. Every option on the left maps to a data-* attribute in the snippet.
기능
구체적이고 출처가 명확한 기능들입니다 — 형식적인 체크박스가 아닙니다. 아래 모든 항목은 지금 이 순간 프로덕션 위젯에 들어 있습니다.
비자 규정은 예고 없이 바뀝니다. Orizn 파이프라인은 200개 이상의 공식 대사관 사이트, IATA, Timatic급 피드에서 24시간마다 데이터를 수집하고 게시 전에 충돌을 검증·조정합니다.
ISO 3166-1 전체 커버리지. 방문자가 여권을 한 번 선택하면 퍼스트파티 쿠키 하나로 재방문 시에도 위젯이 이를 기억합니다.
비자가 필요한 경우 위젯이 가장 가까운 대사관 또는 e-비자 포털을 직접 링크로 안내합니다. 추가 클릭이 필요 없습니다.
결과 카드에 목적지의 평균 일일 예산과 방문자 여권의 이동성 점수가 함께 표시되어, 위젯 하나가 세 가지 질문에 동시에 답합니다.
한 번의 탭으로 방문자의 여권이 미리 채워진 딥링크가 복사되어, 맥락을 잃지 않고 동행자에게 결과를 바로 전달할 수 있습니다.
방문자의 브라우저 언어를 자동 감지합니다. 단일 언어 독자층이라면 data-lang으로 특정 로케일을 고정하세요.
data-affiliate="ORIZN-XXXXX"(aff_… 코드도 지원)를 추가하면 모든 가이드 구매의 50%가 귀하에게 배분되며, 클릭 후 30일간 어트리뷰션이 유지됩니다.
바닐라 JS — React도, jQuery도 없습니다. Lighthouse 성능 영향은 무시할 수준이며 CSS는 스코프 처리되어 충돌하지 않습니다.
빛을 발하는 곳
위젯은 범용이지만, 특히 네 부류의 사용자가 가장 자주 도입합니다. 아래에서 자신의 모습을 발견했다면 스니펫을 붙여넣은 지 몇 분 안에 가치를 얻게 될 것입니다.
모든 국가 가이드 상단에 한 번만 임베드하세요. 독자들이 기사를 떠나지 않고 "베트남 비자가 필요한가요?"에 대한 답을 얻습니다.
트래픽이 높은 기존 포스트에 위젯을 추가하세요. 가이드 판매 50/50 수익 배분이 AdSense가 제값을 못 주는 페이지를 수익화합니다.
웰컴 페이지나 고정 포스트에 위젯을 추가하세요. 구독자는 즉시 비자를 조회하고, 판매는 귀하에게 귀속됩니다.
/resources 페이지에 위젯을 고정하세요. 다음 국가 이동을 계획하는 멤버들이 몇 초 만에 입국 자격을 확인합니다.
데이터 출처
비자 정책은 공식 대사관 피드, IATA Timatic급 소스, 정부 보도자료, 그리고 200개 이상의 정부 부처 사이트를 커버하는 자체 Rust 스크레이퍼로부터 조정됩니다. 각 셀은 호버 시 출처 URL을 표시하며, 전체 그래프는 정책 변경 게시 전 두 개 소스의 일치를 요구하는 품질 게이트와 함께 매일 밤 재구축됩니다.
레퍼런스
모든 옵션은 컨테이너 div의 data-* 속성입니다. JavaScript 설정은 필요 없습니다 — 붙여넣고, 원하는 속성을 지정하고, 배포하세요.
| 파라미터 | 타입 | 기본값 | 설명 |
|---|---|---|---|
data-destination | ISO3 | "" | 목적지 국가를 미리 지정합니다(예: VNM, THA, JPN). 방문자가 직접 변경할 수도 있습니다. |
data-lang | string | "auto" | 자동 감지된 브라우저 언어를 재정의합니다. 16개 로케일 지원: en, fr, es, de, it, pt, ja, ko, zh, ru, ar, hi, th, vi, tl, tr (아랍어는 RTL로 렌더링). |
data-theme | string | "auto" | 테마 강제 지정: "auto"(OS 설정 따름), "light", "dark". |
data-affiliate | string | "" | ORIZN-XXXXX 또는 aff_… 코드(두 형식 모두 지원). 가이드 판매에 대한 50/50 수익 배분을 받으려면 필수입니다. |
data-show-score | bool | true | 결과 카드의 비자 프리 점수 칩 표시 여부를 설정합니다. |
data-show-budget | bool | true | 비자 결과 아래 일일 예산 추정치 표시 여부를 설정합니다. |
data-show-guide | bool | true | 제휴 전환에 사용되는 "전체 여행 가이드 구매" CTA 표시 여부를 설정합니다. |
data-color | hex | #2563EB | 버튼, 포커스 링, 링크, 결과 칩에 사용되는 강조 색상. hex 값만 허용됩니다(자동 정제). |
data-branding | string | "on" | "off"로 설정하면 화이트라벨 모드: "Powered by Orizn" 푸터, JSON-LD 스키마, 공유 텍스트의 orizn.app 언급이 숨겨집니다. |
data-radius | int | 16 | 위젯 카드와 입력 요소의 모서리 반경(px). |
data-font | string | "system-ui" | 위젯 전체에 사용되는 font-family. 모든 CSS 폰트 스택을 사용할 수 있습니다. |
data-no-cookie | bool | false | GDPR 모드: true로 설정하면 위젯이 쿠키를 전혀 저장하지 않습니다(재방문 시 여권 기억 기능 비활성화). |
data-api-key | string | "" | 선택적 Orizn API 키. 설정하면 조회 횟수가 공용 풀 대신 사용 중인 플랜의 할당량에서 차감됩니다. |
연동
같은 두 줄 스니펫이지만 스택에 따라 붙여넣는 경로가 조금씩 다릅니다. CMS별 단계별 상세 가이드:
수익화
컨테이너 div에 data-affiliate="ORIZN-XXXXX" 를 추가하세요 — ORIZN-…과 aff_… 두 코드 형식 모두 지원됩니다. 독자가 위젯을 통해 구매한 모든 가이드는 30일간 귀하에게 귀속되며, 정산은 매월 Stripe로 처리됩니다. 최소 금액 없음, 환수 없음, 제휴 대시보드에서 모든 내역을 투명하게 확인할 수 있습니다.
FAQ
위젯을 연동하는 개발자, 블로거, 제휴 마케터들이 실제로 묻는 질문입니다. 여기에 없다면 /embed/getting-started 문서가 롱테일을 다룹니다.
관련 위젯
다섯 개 위젯 모두 동일한 런타임을 공유하므로, 페이지에 두 번째 위젯을 추가해도 추가 비용이 전혀 없습니다. 스위트는 조합해 쓰도록 설계되었습니다.