연관 문서
TagMe Help Center
TagMe API 가이드
🔒 프라이빗 모드란?
<aside>
자세히 알아보기
[프라이빗 모드] 굿즈 소유자만 볼 수 있는 프라이빗 모드
</aside>
- 프라이빗 모드를 활성화하면 NFC 굿즈를 통해서만 콘텐츠를 확인할 수 있습니다.
- 별도의 복잡한 개발 없이 Script를 적용하는 것만으로 기능을 적용할 수 있습니다.
- 이 기능은 태그미 라이팅앱으로 프로그래밍된 NFC 굿즈가 있어야 온전히 활용 가능합니다.
💡 프라이빗 모드 활성화 및 Script 삽입
<aside>
자세히 알아보기
[프라이빗 모드] 활성화 및 스크립트 코드 복사하기
</aside>
- 태그미 프로젝트 상세 페이지에서 프라이빗 모드를 활성화합니다.
- Script가 발행되며 이를 통해 태그미 링크의 접근 권한을 확인합니다.
- 발행된 Script를 프라이빗 모드를 적용할 루트 페이지<head> 영역에 붙여넣습니다. 이로써 인증된 사용자만 링크의 목적지에 도달할 수 있습니다.
- 스크립트는 프라이빗 모드를 활용할 웹페이지의 실행 사이클에서 한 번만 실행되도록 설계해야 합니다.
☑️ 프라이빗 모드 적용 웹사이트 개발시 확인 사항
-
보안 설정 필수
- API 호출과 인증 데이터는 반드시 HTTPS로 전송하세요.
- 인증된 사용자만 리소스에 접근할 수 있도록 서버에서 보호해야 합니다.
-
페이지 전환 설정 필수
- 새로고침 없이 URL만 업데이트되도록 설정하세요.
- PHP 개발 환경:
- SPA 방식으로 개발해야 정상 작동합니다.
- 스크립트가 태깅 URL 기준으로 한 번 실행 되어야 하는데, MPA 구성방식은 해당 조건을 충족할 수 없어요.
- Next.js 개발 환경:
- 페이지 전환 시 Shallow Routing 방식으로 처리합니다.
- shallow: true 옵션을 사용하여 불필요한 페이지 리렌더링을 방지합니다.
-
콘텐츠 보호 설계 필수
- 인증 이후 요청은 클라이언트 측에서 처리되도록 설계하세요.
- Saas에 등록된 도착지 링크는 SPA(single page application) 방식으로 개발해야 합니다.
-
URL 데이터 요구사항 권장
- URL에 picc_data, enc, cmac가 포함되어야 하며, 이 필드에는 uid를 추출하기 위한 정보가 담겨야 합니다.
- URL에 해당 데이터가 포함되지 않을 경우 제품 식별이 어렵습니다.
-
도착지 URL 구성 일치 권장
- 프라이빗 모드는 도착지 URL과 리다이렉트 되는 페이지의 URL이 일치되어야 합니다.
- 따라서, 프라이빗 모드를 정상적으로 사용하기 위해서는 도메인 구조의 DNS 설정과 리디렉션, 서브도메인 관리를 신경써야 합니다.
- 참고) 루트 도메인(example.com)만 사용하는 경우는 www 서브 도메인(www.example.com)을 사용한 경우와 같지 않다는 점을 주의해주세요.
- 예시)
www.google.com은 google.com의 서브도메인이에요. 구글은 이 둘을 서버에서 리디렉션 처리해서 SEO 중복 이슈 없이 하나의 사이트로 통합합니다. 도착지 링크에 google.com를 적용해도 서버가 자동으로 www.google.com으로 리디렉션 해주어 도착지 URL과 리다이렉트 되는 페이지의 URL이 일치할 수 있고 프라이빗 모드도 정상적으로 작동할 수 있습니다.
참고) 유저가 Safari-개인정보 보호 브라우징 ‘ON’ 설정시, 잠금화면이 보입니다.
- ‘Safari-개인정보 보호 모드’에서 외부 스크립트가 삽입된 URL의 접근을 막고 있는 브라우저 정책으로 개인정보 보호 모드를 설정한 유저에게는 잠금화면이 노출됩니다.
- 프라이빗 모드와 관련된 고객 문의가 있을 경우 유저가 개인정보 보호 모드를 설정한 상태인지 확인 하고 설정 해제를 요청해주세요.
- 관련 안내 가이드: NFC 태그 방법 안내 ☑️
CONTACT
개발 가이드라인에 맞춰 개발하는 데 어려움이 있으시다면 [email protected]로 문의주시면 최대한 신속하게 도움을 드리겠습니다. 단 권장 개발 가이드와 다르게 적용된 부분에서 발생한 이슈에 대해서는 지원이 어려운 점 너른 양해부탁드립니다.