사용자 기기에 맞춰 연결하는 QR 코드 리다이렉트 시스템
QR Codes That Route to the Appropriate App Store
Hacker News인쇄된 명함의 QR 코드를 단일 짧은 URL로 통일하고, 서버가 스캔하는 기기(iOS/Android)에 맞춰 최적화된 앱 스토어 링크로 자동 연결합니다.
- 접속자의 User-Agent 정보를 분석하여 목적지를 결정하므로, 나중에 앱 스토어 주소가 변경되어도 QR 코드를 재인쇄할 필요 없이 서버 설정만으로 대응이 가능합니다.
- 캐싱 방지(Vary 헤더) 및 임시 리다이렉트(302)를 적용해 링크의 신뢰성을 극대화하고, 오프라인 홍보물의 마케팅 효과를 높입니다.
- 주요 플랫폼에서 앱으로 가로채기(Interception)가 불가능한 독립된 도메인을 사용함으로써, 링크의 안정성과 보안성을 기술적으로 확보했습니다.
인쇄물에 사용되는 QR 코드는 단일 URL을 인코딩할 수밖에 없지만, '앱 다운로드'라는 목표는 스캔하는 사용자 환경(iOS, Android 등)에 따라 다른 목적지를 필요로 합니다. 또한 명함과 같은 인쇄 매체는 한번 배포되면 수정이 불가능하므로, 나중에 앱 스토어 주소가 변경되더라도 링크가 계속 작동해야 하는 문제가 발생합니다. 이러한 문제를 해결하기 위해 서버에서 제어하는 단축 URL 호스트를 구축하여, 모든 QR 코드가 통제된 하나의 URL(예: `go.pokernexus.com/app`)을 가리키도록 설계했습니다.
이 시스템은 접속자의 User-Agent 헤더 정보를 분석하여 최종 목적지를 결정합니다. 서버는 웹사이트 방문 여부와 기기 유형(iOS, Android)을 확인하는 로직을 구현하며, 이를 통해 사용자가 어떤 플랫폼에서 접근했는지 파악하고 해당 플랫폼의 앱 스토어 링크로 리다이렉트합니다. 이 과정은 `Destination` 인터페이스를 사용하여 URL과 쿼리 문자열 처리 방식을 정의하고, 요청 경로에 따라 적절한 목적지를 선택하는 방식으로 작동합니다.
링크의 신뢰성을 높이기 위해 기술적인 고려가 필수적입니다. 영구 리다이렉트(301) 대신 임시 리다이렉트(302)를 사용하여 링크 주소 변경 시에도 시스템 업데이트만으로 대응할 수 있게 했습니다. 또한, 캐싱 문제를 방지하기 위해 `Vary: User-Agent` 헤더를 설정하여, 공유 캐시가 특정 기기의 리다이렉트 결과를 다른 기기에 잘못 제공하는 것을 막습니다. 더 나아가, 의도적으로 도메인을 미등록 상태로 유지함으로써 주요 플랫폼의 앱 가로채기(Interception) 기능을 우회하고 링크의 안정성을 확보했습니다.