오프라인 앱 설치 측정치 확보를 위한 QR 코드 트래킹 배포 방법

QR 코드로 앱 다운로드를 추적하는 방법은 무엇인가요? QR 코드를 통한 앱 다운로드 추적은 매개변수가 포함된 동적 QR 코드를 생성하여 사용자를 적응형 모바일 랜딩 페이지로 유도하고, 웹 SDK를 통해 유효한 캠페인 컨텍스트를 기록하며, 지원되는 설치 어트리뷰션을 활성화하는 동시에 적절한 앱 스토어로 방문객을 라우팅하는 방식으로 이루어집니다.

모바일 애플리케이션을 위한 QR 코드 트래킹은 고유한 캠페인 식별자를 동적 바코드에 인코딩하여 오프라인 마케팅 접점을 디지털 앱 설치로 연결하는 측정 방법론입니다. 스캔 기기를 매개변수 인식 트랜짓 엔드포인트로 라우팅함으로써, 빌보드, 리테일 전단지, 행사 배지 등의 구체적인 오프라인 소스를 식별하고 엔드투엔드 전환율을 측정할 수 있습니다.

오프라인의 사각지대: 정적 QR 코드가 앱 설치 측정에 실패하는 이유

스토어 직결형 QR 코드의 기술적 한계: 변경 불가능한 목적지와 제한적인 어트리뷰션 유연성

물리적 인쇄 매체는 그동안 모바일 성장 팀에게 어트리뷰션 측면의 난제로 작용했습니다. 마케팅 팀이 대중교통 역사 포스터, 상품 패키지, 다이렉트 메일, 컨퍼런스 배너 등의 인쇄물을 배포할 때 물리적 영역과 디지털 영역을 잇는 가교가 필요합니다. 가장 직관적인 메커니즘은 ISO/IEC 18004 표준을 준수하는 QR(Quick Response) 코드입니다.

그러나 정적 스토어 직결형 QR 코드는 본질적인 아키텍처 제약이 있습니다. 인쇄된 이후에는 인코딩된 데이터 페이로드를 변경할 수 없습니다. 정적 QR 코드에서는 목적지 웹 주소를 나타내는 영숫자 문자열이 생성 과정에서 흑백 매트릭스 모듈에 직접 패턴화됩니다. 만약 기업이 Apple App Store로 향하는 관리되지 않는 다이렉트 링크를 인코딩한다면:

https://apps.apple.com/app/id1234567890

해당 바코드는 오직 그 명시된 URL로만 스캔 기기를 유도할 수 있습니다. 정적 QR 코드는 중간 웹 페이지를 지정하는 경우 기술적으로 정적 URL 쿼리 매개변수를 인코딩할 수 있지만, 스토어 URL을 직접 인코딩하면 물리적 인쇄물이 유통되기 시작한 이후에는 서버에서 목적지를 수정할 수 없으며 스토어 직결 링크는 조건부 운영체제 라우팅을 실행할 수 없습니다. 스토어 직결형 QR 코드는 인쇄 후 라우팅 유연성이 제한적입니다. 자산 수준의 어트리뷰션은 지원되는 스토어 어트리뷰션 메커니즘과 인쇄 전에 구성된 캠페인 매개변수 또는 식별자에 따라 달라집니다.

멀티 플랫폼 문제: 하나의 앱 스토어 링크 하드코딩이 전체 오디언스의 절반을 배제하는 이유

모바일 오디언스는 근본적으로 Apple iOS와 Google Android라는 두 가지 지배적인 운영체제로 나뉩니다. Apple App Store 링크(apps.apple.com)가 하드코딩된 정적 QR 코드는 Android 기기에서 스캔할 때 즉각적인 막다른 길을 만듭니다. Google Play 서비스가 네이티브 iOS 스토어 스킴을 파싱할 수 없기 때문입니다.

반대로 Google Play 스토어 URL(play.google.com)을 인코딩하면 iOS 사용자가 iPhone에 네이티브 소프트웨어를 설치할 수 없는 웹 기반 Google Play 인터페이스로 강제 유도됩니다. 이를 우회하기 위해 레거시 인쇄 캠페인에서는 종종 두 개의 서로 다른 QR 코드를 나란히 인쇄했습니다. 하나에는 “iOS용 스캔”을, 다른 하나에는 “Android용 스캔”을 레이블로 지정했습니다.

이러한 듀얼 코드 방식은 상당한 운영 및 전환 비용을 초래합니다.

• 시각적 혼잡도 증가 및 스캔 속도 저하: 경쟁 관계인 바코드를 인쇄하면 소중한 물리적 표면적이 낭비되고 인지적 마찰이 발생하여, 사용자가 스캔하기 전에 레이블을 일일이 확인해야 합니다.
• 사용자 오인 및 이탈: 모바일 사용자가 잘못된 바코드를 정기적으로 스캔하여 호환되지 않는 스토어 페이지나 플랫폼 오류를 마주하고 온보딩 플로우를 완전히 포기하게 됩니다.
• 제한된 자산 수준 어트리뷰션: 스토어 직결형 QR 코드는 지원되는 일부 스토어 어트리뷰션 파라미터를 통해 캠페인 수준의 측정을 지원할 수는 있으나, 그 자체로는 중앙에서 관리되는 스캔 로그나 인쇄 후 라우팅 유연성을 제공하지 않습니다.

인쇄 후 취약점: 캠페인 목적지가 인쇄 후에 변경될 때 발생하는 상황

물리적 인쇄물 제작에는 엄격한 리드 타임이 필요합니다. 잡지, 제품 상자, 매장 내 디스플레이, 옥외(OOH) 빌보드는 마케팅 캠페인이 시작되기 수주 또는 수개월 전에 인쇄되는 경우가 빈번합니다.

엔지니어링 팀이 정적 스토어 직결형 QR 코드를 배포하는 경우, 디지털 인프라에 후속 변경이 생기면 물리적 인쇄물이 무용지물이 됩니다.

• 앱 스토어 승인 지연: 예상되는 App Store URL로 홍보물이 인쇄되었으나 앱 심사 과정에서 번들 ID나 기본 앱 식별자를 변경해야 하는 경우, 인쇄된 모든 홍보물이 영구적으로 구식이 됩니다.
• 캠페인 리디렉션 요구사항: 프로모션 이벤트가 종료된 후 스토어 목록을 직접 가리키는 정적 QR 코드는 새로운 계절별 랜딩 페이지로 리디렉션될 수 없으며, 만료된 혜택이나 404 오류 페이지를 계속해서 노출하게 됩니다.
• 도메인 폐기 및 깨진 엔드포인트: 관리되지 않는 단축 링크 서비스가 중단되거나 URL 형식이 변경될 경우 인쇄된 자산을 업데이트할 수 없어 낭비되는 물리적 광고 비용이 발생합니다.

동적 QR 코드 라우팅은 어떻게 프린트 캠페인을 앱 스토어와 연결하는가

디커플링된 아키텍처: 간접 레이어로서의 단축 URL

동적 QR 코드는 물리적 바코드와 디지털 목적지 사이에 디커플링된 간접 레이어를 도입하여 물리적 인쇄 매체의 한계를 해결합니다.

단말 앱 스토어 URL을 매트릭스 모듈에 하드코딩하는 대신, 동적 QR 코드는 가벼운 중앙 집중식 라우팅 엔드포인트를 인코딩합니다(예: 프로덕션 인쇄 자산에 직접 사용해서는 안 되는 예시 문서화 엔드포인트인 https://trk.example.com/c/poster_station_a).

QR 코드 자체가 소프트웨어 로직을 실행하는 것은 아니며, 동적 기능은 전적으로 간접 URL을 호스팅하는 웹 서버에 있습니다. 동적 QR 코드의 문자열은 짧고 균일하게 유지될 수 있으므로, 여러 매개변수가 포함된 복잡한 목적지 URL을 인코딩하는 것에 비해 물리적 바코드에 일반적으로 더 적은 데이터 모듈이 필요합니다. 이로 인해 모듈 밀도가 낮아져 ISO/IEC 18004 표준에 따른 우수한 스캔 허용 오차와 높은 오류 정정 수준을 유지하면서 더 작은 물리적 치수로 인쇄할 수 있습니다.

스마트폰 카메라가 동적 바코드를 스캔하면 기기는 라우팅 엔드포인트로 HTTP GET 요청을 시작합니다. 관리되는 트래킹 엔드포인트는 HTTP 302 리디렉션을 사용하여 적응형 트랜짓 페이지를 전달할 수 있습니다. 그런 다음 예시 트랜짓 페이지는 클라이언트 측 환경 지표를 검사하고 사용자가 시작한 스토어 이동 링크를 제공합니다.

클라이언트 User-Agent 헤더를 검사하여 iOS, Android 및 데스크톱 기기 감지

스캔 기기가 동적 라우팅 엔드포인트를 쿼리하면 브라우저 네트워킹 스택은 표준 HTTP 요청 헤더, 특히 User-Agent 문자열을 전송합니다.

라우팅 엔진은 휴리스틱 패턴 매칭을 사용하여 실시간으로 이 문자열을 파싱하고 기기 운영체제를 격리합니다.

• iOS 감지: 사용자를 Apple App Store 또는 관련 유니버설 링크 랜딩 페이지로 라우팅해야 함을 나타내는 iPhone, iPad, 또는 iPod과 같은 패턴과 일치합니다.
• Android 감지: 요청을 Google Play Store 또는 APK 배포 랜딩 페이지로 라우팅해야 함을 나타내는 Android가 포함된 패턴과 일치합니다.
• 데스크톱 / 워크스테이션 감지: 방문객을 고해상도 데스크톱 웹 개요 또는 보조 프로모션으로 안내하는 데스크톱 플랫폼 토큰과 일치합니다.

사용자를 Apple App Store, Google Play Store 또는 웹 랜딩 페이지로 동적으로 디스패치

스캔 시점에 클라이언트 기기의 기능을 평가함으로써 동적 라우팅 엔진은 조건부 분기 로직을 실행합니다.

• 모바일 iOS 트래픽: 애플리케이션의 고유한 App Store 제품 페이지 또는 유니버설 링크를 호스팅하는 관련 랜딩 페이지로 리디렉션합니다.
• 모바일 Android 트래픽: 올바르게 인코딩된 설치 레퍼러(Install Referrer) 메타데이터와 함께 Google Play 스토어 클라이언트로 직접 리디렉션하거나, 직접 APK 다운로드를 위한 최적화된 모바일 웹 페이지를 제공합니다.
• 데스크톱 트래픽: 전체 기능 쇼케이스가 포함된 데스크톱 최적화 웹 랜딩 페이지를 제공하거나 방문객에게 모바일 전화번호를 입력하여 직접 SMS 다운로드 링크를 받도록 유도합니다.

단일 통합 앱 QR 코드를 배포하여 조각난 소재 비용 제거

동적 간접 방식을 배포하면 단일한 범용 "앱 QR 코드"를 생성할 수 있습니다. 마케팅 및 디자인 팀이 경쟁 관계인 운영체제 배지를 위해 레이아웃 공간을 할당할 필요가 없어집니다.

“스캔하여 다운로드” 레이블이 지정된 단일 브랜드 QR 코드가 양대 주요 모바일 생태계를 모두 서비스합니다. 라우팅 백엔드는 운영체제 기능에 따라 트래픽을 투명하게 분기하여 물리적 소재 디자인을 간소화하고, 인쇄 오류를 최소화하며, 스캔 상호작용이 호환되는 소프트웨어 게이트웨이에 도달하도록 보장합니다.

매개변수화된 스캔-투-설치 어트리뷰션을 가능하게 하는 기술 아키텍처

채널 식별자와 캠페인 메타데이터를 쿼리 문자열에 인코딩

세밀한 어트리뷰션을 달성하기 위해 동적 QR 코드는 리디렉션 경로 내에 구조화된 트래킹 파라미터를 인코딩해야 합니다. 성장 마케팅에는 단순히 설치가 발생했다는 사실뿐만 아니라 정확히 어떤 물리적 자산이 그것을 생성했는지 파악하는 것이 필요합니다.

어트리뷰션 플랫폼은 각 물리적 배치에 대해 고유한 서브 채널을 생성하여 이를 달성합니다. 각 채널에는 명시적 파라미터 문자열이 할당됩니다.

?channelCode=subway_billboard_04&utm_source=offline&utm_medium=print_ooh&utm_campaign=spring2026

동적 QR 코드를 대량으로 생성할 때 플랫폼은 이러한 쿼리 매개변수를 각 물리적 위치에 매핑된 고유한 단축 URL과 연결합니다. 단축 URL은 어트리뷰션 데이터베이스에서 인덱스 키 역할을 하여 물리적 좌표를 디지털 어트리뷰션 레코드와 직접 연결합니다.

스토어 전환 전반에 걸친 컨텍스트 유지: 웹 JS 캡처와 네이티브 SDK 검색의 결합

오프라인 사용자가 동적 QR 코드를 스캔하고 앱 스토어로 리디렉션될 때, 표준 웹 쿼리 매개변수는 마켓플레이스 경계를 넘어 애플리케이션 런타임으로 자동으로 전달될 수 없습니다.

이 경계를 연결하기 위해 동적 트랜짓 아키텍처는 다단계 핸드오프 프로토콜을 배포합니다.

1. 1단계 (웹 JS 수집): 동적 QR 코드는 사용자를 웹 JS SDK를 호스팅하는 가벼운 모바일 트랜짓 페이지로 라우팅합니다. SDK는 쿼리 문자열 매개변수(channelCode, utm_campaign)를 추출하고 배포 구성에 따라 이를 보고하며 핸드오프 컨텍스트를 준비합니다.
2. 2단계 (스토어 핸드오프): 트랜짓 페이지는 사용자를 목적지 앱 스토어로 리디렉션합니다. Google Play 스토어를 방문하는 Android 사용자의 경우, 웹 페이지는 공식 Google Play 설치 레퍼러 URL에 정제된 매개변수를 삽입할 수 있습니다.
3. 3단계 (네이티브 SDK 매개변수 검색): 사용자가 앱을 다운로드하고 처음 실행하면 네이티브 모바일 SDK가 초기화되어 getInstallParam()을 호출합니다. 적격한 캠페인 매개변수는 지원되는 플랫폼 또는 SDK 메커니즘을 통해 설치 후에 복구될 수 있습니다. 성공적인 어트리뷰션은 설치 경로, SDK 구성, 사용 가능한 신호 및 플랫폼의 개인정보 보호 요구사항에 따라 달라집니다.

오프라인-온라인 어트리뷰션 파이프라인 분석

아래의 아키텍처 흐름은 물리적 스캔부터 네이티브 매개변수 복원까지의 데이터 파이프라인을 보여줍니다.

[실물 포스터 / 디스플레이] ──> 사용자가 카메라로 동적 QR 코드 스캔
             │
             ▼
[동적 트랜짓 엔드포인트] ──> User-Agent 검사 및 ?channelCode=poster_01 추출
             │
             ├──> [iOS 사용자] ──> 컨텍스트 전달 ──> Apple App Store 등록정보
             │                                             │
             └──> [Android 사용자] ──> 레퍼러 전달 ──> Google Play Store 등록정보
                                                           │
                                                           ▼
[최초 앱 실행] ──> 네이티브 SDK의 채널 검색 시도 ──> 매칭된 채널 / 기타 소스 / 알 수 없음 ──> 분석 대시보드

스캔-투-설치 전환 퍼넬 측정 (모듈 M4 모델)

오프라인 캠페인 측정에는 고유한 파이프라인 마일스톤 전반에 걸쳐 명확한 수학적 전환 비율을 정의하는 것이 필요합니다. 마케팅 팀은 동일한 채널, 관찰 윈도우 및 중복 제거 규칙 전반에 걸쳐 정규화된 지표를 평가하면서 관찰 가능한 이벤트를 플랫폼 제한적 전환과 분리해야 합니다.

• 기록된 트랜짓 방문 수 ($S$): 정의된 트랜짓 방문 관찰 윈도우 전반에 걸쳐 정규화된, QR 코드 스캔 시 동적 트랜짓 서버에 의해 로깅된 유효하고 중복 제거된 HTTP 요청의 총 수.
• 중복 제거된 스토어 핸드오프 시도 횟수 ($H$): $S$와 동일한 관찰 윈도우 및 중복 제거 기준 하에서 평가된, 최소 하나의 스토어 핸드오프 액션을 시작한 유효한 트랜짓 방문의 수. 핸드오프 지표($H$)는 확인된 리다이렉트 이벤트나 별도로 계측된 스토어 링크 활성화를 통해 수집되어야 합니다. href 단독 구성으로는 핸드오프 시도가 기록되지 않습니다.
• 스토어 핸드오프율 ($R_{\text{handoff}}$): $R_{\text{handoff}} = \frac{H}{S}$로 정의됩니다. 비율이 낮다면 네트워크 장애, 클라이언트 제한, 사용자 이탈 또는 이벤트 수집 방식의 차이를 반영할 수 있습니다.
• 어트리뷰션된 최초 실행 수 ($A_c$): 후속 어트리뷰션 성숙 윈도우 전반에 걸쳐 채널 $c$에 성공적으로 매칭된 중복 제거된 최초 애플리케이션 실행 횟수.
• 어트리뷰션된 최초 실행률 ($R_{\text{attributed-first-launch}}$): $R_{\text{attributed-first-launch}} = \frac{A_c}{S} \times 100\%$로 정의됩니다. 이 지표는 시간 경과에 따른 물리적 자산당 관찰된 어트리뷰션 최초 실행 대비 방문 비율을 평가합니다.
• 관찰 불가능한 파이프라인 이탈 고려사항: 스토어 페이지 이탈, 불완전한 설치, 지연된 최초 실행, 매칭되지 않은 어트리뷰션 이벤트는 리다이렉트 로그만으로는 개별적으로 정량화할 수 없습니다. 지원되는 스토어 또는 SDK 텔레메트리가 제공되지 않는 한 이러한 단계는 관찰되지 않은 것으로 보고해야 합니다.

개인정보 보호 경계: 플랫폼 개인정보 보호 규칙 및 공급업체 데이터 검토

현대 모바일 어트리뷰션 아키텍처는 운영체제의 개인정보 보호 프레임워크를 엄격하게 준수해야 합니다. Apple의 앱 추적 투명성(ATT) 정책 및 플랫폼 보안 지침은 IP 주소, 사용자 에이전트 문자열, 화면 해상도, 시스템 구성의 조합을 수집하여 영구적이거나 확률적인 기기 서명을 구축하는 기기 핑거프린팅을 명시적으로 금지합니다.

동적 QR 라우팅은 캠페인 수준의 방문을 기록하며 Google Play 설치 레퍼러 API와 같은 허용된 플랫폼 메커니즘을 통해 설치 어트리뷰션을 지원할 수 있습니다. 범위가 지정된 캠페인 식별자와 지원되는 플랫폼 어트리뷰션 채널을 우선적으로 사용하십시오. 선택한 타사 SDK가 핑거프린팅을 회피한다고 가정하지 말고, 배포 전에 실제 매칭 방법과 데이터 처리 관행을 검증하십시오. URL 매개변수만으로는 개인정보 보호를 준수하는 iOS 설치 매칭이 성립되지 않으며, 개발자는 배포된 SDK의 매칭 메커니즘이 Apple의 기기 핑거프린팅 금지 조항을 준수하는지 독립적으로 감사해야 합니다.

• 범위 지정 캠페인 식별자: 연관되지 않은 앱 간에 하드웨어별 식별자를 추적하는 대신, 결정론적 URL 쿼리 파라미터, 공식 Google Play 설치 레퍼러 API 및 일시적인 서버 측 세션 토큰을 사용하여 캠페인 소스를 어트리뷰션합니다.
• 데이터 최소화: 스캔된 파라미터는 캠페인 메타데이터(예: 빌보드 ID, 위치 토큰)를 나타냅니다. 단, 개발자는 네트워크 전송이 본질적으로 IP 주소와 요청 헤더를 처리하며 inviter_id와 같은 커스텀 토큰은 개인정보 보호 규정 하에서 식별 가능한 사용자 계정을 나타낼 수 있음을 인지해야 합니다.
• 클라이언트 권한 격리: 클라이언트에서 복원된 파라미터는 어트리뷰션 힌트 역할을 합니다. 다운스트림 백엔드 서비스는 인증된 사용자 계정을 사용하여 리퍼럴 로직 및 캠페인 자격을 검증하며, 검증되지 않은 클라이언트 측 권한 부여는 피합니다.

단계별 구현: 동적 앱 QR 코드 생성 및 트래킹

개발자 콘솔에서 채널 식별자 및 랜딩 페이지 템플릿 구성

물리적 바코드를 생성하기 전에 성장 팀은 어트리뷰션 대시보드에 채널 계층 구조를 구축해야 합니다.

1. 애플리케이션 자산 등록: 어트리뷰션 관리 콘솔에 액세스하여 애플리케이션 식별자(AppKey, Android 패키지 이름, iOS 번들 식별자)를 구성하고 테스트 설치 패키지를 업로드합니다.
2. 기본 채널 정의: 채널 통계 관리에서 기본 채널 그룹(예: Offline_OOH, Retail_Packaging, Event_Conference)을 생성합니다.
3. 매개변수화된 서브 채널 인스턴스화: 각 물리적 위치에 해당하는 고유한 서브 채널을 생성합니다. 시스템은 각 배치에 고유한 channelCode(예: ooh_chicago_01, pkg_retail_box_v2)를 할당합니다.
4. 트랜짓 랜딩 페이지 구성: 기본 모바일 랜딩 페이지 템플릿을 선택하거나 웹 JS SDK를 커스텀 H5 페이지에 통합합니다. 랜딩 페이지는 스캔 이벤트와 앱 스토어 간의 트랜짓 라우터 역할을 합니다.

웹 사이드 동적 리다이렉션 및 매개변수 보존 구현

동적 QR 코드 스캔을 서비스하기 위해 커스텀 웹 랜딩 페이지를 호스팅할 때 개발자는 수신되는 파라미터를 정제하고, 합법적인 스토어 목적지 URL을 구성하며, 딥 링크 또는 스토어 라우팅을 호출해야 합니다.

[CODE_BLOCK_01]의 구현 예시는 허용 목록에 대해 쿼리 문자열을 검증하고, 올바르게 인코딩된 referrer 파라미터와 함께 유효한 Google Play URL을 구성하며, 네이티브 스토어 앵커를 단일 내비게이션 소유자로 유지하면서 웹 JS SDK를 초기화하는 HTML/JS 트랜짓 페이지를 보여줍니다.

구성 파라미터 및 파라미터 파싱에 관한 기술 사양은 SDK 통합 레퍼런스를 참조하십시오.

<!-- HTML / JS 동적 QR 코드 리다이렉션 및 파라미터 처리 -->
<!-- 파일: qr_transit_page.html -->

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>앱 스토어로 이동 중...</title>

    <style>
        body {
            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
            background-color: #fafafa;
            color: #333;
            text-align: center;
            padding: 40px 16px;
            margin: 0;
        }
        .transit-card {
            background: #ffffff;
            border-radius: 14px;
            box-shadow: 0 4px 16px rgba(0,0,0,0.06);
            max-width: 420px;
            margin: 0 auto;
            padding: 32px 24px;
            box-sizing: border-box;
        }
        .app-badge {
            width: 72px;
            height: 72px;
            border-radius: 16px;
            margin-bottom: 16px;
        }
        .btn-action {
            display: inline-block;
            background-color: #007aff;
            color: #ffffff;
            font-size: 15px;
            font-weight: 600;
            padding: 12px 28px;
            border-radius: 22px;
            text-decoration: none;
            margin-top: 20px;
            border: none;
            cursor: pointer;
        }
        .status-msg {
            font-size: 13px;
            color: #777;
            margin-top: 14px;
        }
    </style>
</head>
<body>

    <div class="transit-card">
        <img src="https://cdn.example.com/assets/app-icon.png" alt="앱 아이콘" class="app-badge">
        <h2 id="card-title">앱 스토어로 계속 이동하기</h2>
        <p id="card-desc">적절한 앱 스토어를 열려면 아래 버튼을 선택하세요.</p>
        
        <!-- 접근 가능한 네이티브 대체 앵커 링크 -->
        <!-- 프로덕션 참고: https://app.example.com/default-store를 검증된 프로덕션 랜딩 URL로 교체하세요 -->
        <a id="fallback-store-btn" class="btn-action" href="https://app.example.com/default-store">다운로드 계속하기</a>
        <p class="status-msg">앱 스토어로 계속 이동하려면 위 버튼을 탭하세요.</p>
    </div>

    <!-- OpoInstall 웹 JS SDK 포함 (배포된 프로덕션 릴리스에 맞는지 확인하세요) -->
    <script src="https://web.cdn.opoinstallcloud.com/opoinstall.js"></script>
    <script>
    (function() {
        // 1단계: 실물 QR 스캔에서 수신된 트래킹 파라미터 파싱 및 정제
        function getSanitizedTrackingParams() {
            var allowedKeys = new Set([
                "channelCode",
                "utm_source",
                "utm_medium",
                "utm_campaign",
                "inviter_id"
            ]);

            var result = Object.create(null);

            try {
                var query = new URLSearchParams(window.location.search);
                // 파라미터 값 검증: 영숫자, 하이픈, 언더스코어, 점 (최대 64자)
                var validPattern = /^[A-Za-z0-9_.-]{1,64}$/;

                query.forEach(function(value, key) {
                    if (allowedKeys.has(key) && validPattern.test(value)) {
                        if (!Object.prototype.hasOwnProperty.call(result, key)) {
                            result[key] = value;
                        }
                    }
                });
            } catch (e) {
                return Object.create(null);
            }

            return result;
        }

        var campaignData = getSanitizedTrackingParams();

        // 2단계: 플랫폼 라우팅을 위한 클라이언트 측 User-Agent 검사
        var ua = navigator.userAgent || "";
        var isIOS = /iPhone|iPad|iPod/.test(ua) || (navigator.platform === 'MacIntel' && navigator.maxTouchPoints > 1);
        var isAndroid = /Android/.test(ua);

        var fallbackBtn = document.getElementById("fallback-store-btn");

        // 3단계: 정제된 파라미터가 포함된 플랫폼별 스토어 URL 구성
        if (fallbackBtn) {
            if (isIOS) {
                // Apple App Store 다이렉트 등록 URL (참고: iOS App Store는 임의의 쿼리 문자열을 파싱하지 않음)
                fallbackBtn.href = "https://apps.apple.com/app/id1234567890";
            } else if (isAndroid) {
                // 올바르게 인코딩된 'referrer' 파라미터가 포함된 Google Play Store URL 구성
                try {
                    var playUrl = new URL("https://play.google.com/store/apps/details");
                    playUrl.searchParams.set("id", "com.example.app");

                    var referrerParams = new URLSearchParams();
                    ["channelCode", "utm_source", "utm_medium", "utm_campaign", "inviter_id"].forEach(function(paramKey) {
                        if (campaignData[paramKey]) {
                            referrerParams.set(paramKey, campaignData[paramKey]);
                        }
                    });

                    if (referrerParams.toString()) {
                        playUrl.searchParams.set("referrer", referrerParams.toString());
                    }

                    fallbackBtn.href = playUrl.toString();
                } catch (e) {
                    fallbackBtn.href = "https://play.google.com/store/apps/details?id=com.example.app";
                }
            }
        }

        // 4단계: 단일 소유자 내비게이션 원칙을 적용한 웹 JS SDK 초기화
        // 위에서 구성된 fallbackBtn.href는 기본 접근 가능 목적지로 유지됩니다.
        // SDK는 앵커 내비게이션을 재정의하지 않고 파라미터를 수집 및 보고하기 위해 초기화됩니다.
        if (typeof OpoInstall !== "function") {
            console.error("OpoInstall 웹 SDK를 사용할 수 없습니다. 어트리뷰션 캡처가 확인되지 않았습니다.");
        } else {
            try {
                new OpoInstall({
                    appKey: "OPOINSTALL_APPKEY_PLACEHOLDER",
                    data: campaignData,
                    onready: function() {
                        // SDK가 준비 상태를 보고합니다.
                        // 파라미터 지속성 및 후속 설치 검색은 배포된 SDK 계약 및 플랫폼 매칭 지원에 따라 달라집니다.
                        // 내비게이션은 fallbackBtn.href 앵커가 단독 소유합니다.
                    }
                });
            } catch (error) {
                console.error("OpoInstall SDK 초기화 오류; 네이티브 스토어 href는 활성 상태로 유지됩니다:", error);
            }
        }
    })();
    </script>
</body>
</html>

서버 측 REST API를 통한 동적 QR 코드 생성 자동화

수천 개의 실물 SKU나 지역화된 프로모션 전단지를 배포하는 엔터프라이즈 캠페인에서는 웹 대시보드를 통해 수동으로 바코드를 생성하는 방식이 비효율적입니다.

다음의 예시 Node.js 워크플로우는 채널 등록, 트래킹 URL 검증 및 QR 이미지 생성을 보여줍니다. 실행 전에 배포된 OpoInstall API 계약에 따라 API 엔드포인트, 인증 체계, 요청 필드 및 응답 매핑을 구성하십시오.

[CODE_BLOCK_02]의 스크립트는 백엔드 서버가 승인된 요청 워크플로우를 실행하고, 승인된 API 및 트래킹 도메인 허용 목록에 대해 반환된 URL 구조를 검증하며, ISO/IEC 18004 표준을 준수하는 표준 기반 QR 코드 생성기에 검증된 HTTPS 엔드포인트를 전달하여 고해상도 PNG 바코드 이미지 파일을 생성하는 방법을 보여줍니다.

// 프로그래밍 방식 채널 생성 및 동적 QR 코드 생성을 위한 Node.js 스크립트
// 파일: generate_channel_qr.js
// 의존성: npm install qrcode

const https = require('https');
const QRCode = require('qrcode'); // ISO/IEC 18004 표준을 준수하는 표준 기반 QR 생성기

/**
 * 구성 객체:
 * 채널 등록, 트래킹 URL 검증, QR 이미지 생성을 시연하는 예시 자동화 워크플로우.
 * 실행 전에 배포된 OpoInstall API 계약에 따라 API 엔드포인트, 인증 체계,
 * 요청 필드 및 응답 매핑을 구성하십시오.
 */
const CONFIG = {
    apiKey: process.env.OPOINSTALL_API_KEY,
    apiHost: process.env.OPOINSTALL_API_HOST,
    channelAddEndpoint: process.env.OPOINSTALL_CHANNEL_ADD_PATH,
    channelGetEndpoint: process.env.OPOINSTALL_CHANNEL_GET_PATH
};

/**
 * 연속된 점이나 잘못된 레이블 형식 없이
 * RFC 1035 / RFC 1123 DNS 사양을 준수하는지 호스트 이름을 검증합니다.
 */
function isValidHostname(host) {
    if (typeof host !== "string" || host.length > 253) {
        return false;
    }
    const labels = host.split(".");
    if (labels.length < 2) {
        return false;
    }
    return labels.every(label =>
        label.length >= 1 &&
        label.length <= 63 &&
        /^[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?$/.test(label)
    );
}

/**
 * 환경 구성에서 승인된 호스트 허용 목록을 엄격하게 검색합니다.
 * 검증이 검증된 배포 도메인과 일치하도록 하드코딩된 프로덕션 기본값을 피하십시오.
 */
function getApprovedHosts(envVarName) {
    const raw = process.env[envVarName];
    if (!raw) {
        throw new Error(`${envVarName} 환경 변수는 명시적으로 구성되어야 합니다.`);
    }

    const hosts = new Set(
        raw.split(",")
            .map(host => host.trim().toLowerCase())
            .filter(Boolean)
    );

    if (hosts.size === 0) {
        throw new Error(`${envVarName} 허용 목록은 비어 있을 수 없습니다.`);
    }

    return hosts;
}

/**
 * 구성 존재 여부, 구문 및 권한 부여된 API 호스트 소속을 검증합니다.
 */
function validateConfig() {
    if (!CONFIG.apiKey || CONFIG.apiKey === "OPOINSTALL_API_KEY_PLACEHOLDER") {
        throw new Error("필수 OPOINSTALL_API_KEY 환경 변수가 누락되었습니다. 실행을 중단합니다.");
    }

    // apiHost에 대한 엄격한 DNS 레이블 검증 강제
    if (!CONFIG.apiHost || !isValidHostname(CONFIG.apiHost)) {
        throw new Error(`유효하지 않거나 잘못된 형식의 OPOINSTALL_API_HOST: "${CONFIG.apiHost}". 유효한 DNS 호스트 이름이어야 합니다.`);
    }

    // 전용 승인된 API 호스트 허용 목록에 대해 apiHost 확인
    const approvedApiHosts = getApprovedHosts("APPROVED_API_HOSTS");
    if (!approvedApiHosts.has(CONFIG.apiHost.toLowerCase())) {
        throw new Error(`권한이 없는 API 호스트: "${CONFIG.apiHost}". APPROVED_API_HOSTS에 호스트가 존재하지 않습니다.`);
    }

    // 슬래시로 시작하는 엔드포인트 경로 구조 강제
    const pathPattern = /^\/[a-zA-Z0-9/_-]+$/;
    if (!CONFIG.channelAddEndpoint || !pathPattern.test(CONFIG.channelAddEndpoint)) {
        throw new Error(`유효하지 않거나 누락된 OPOINSTALL_CHANNEL_ADD_PATH: "${CONFIG.channelAddEndpoint}". "/"로 시작해야 합니다.`);
    }

    if (!CONFIG.channelGetEndpoint || !pathPattern.test(CONFIG.channelGetEndpoint)) {
        throw new Error(`유효하지 않거나 누락된 OPOINSTALL_CHANNEL_GET_PATH: "${CONFIG.channelGetEndpoint}". "/"로 시작해야 합니다.`);
    }
}

/**
 * 시간 초과 및 크기 제한 보호 기능과 함께 파싱된 JSON을 반환하는 HTTPS GET 요청 실행 헬퍼
 */
function httpsGetJson(url) {
    return new Promise((resolve, reject) => {
        const req = https.get(url, (res) => {
            if (res.statusCode < 200 || res.statusCode >= 300) {
                reject(new Error(`상태 코드와 함께 HTTP 요청 실패: ${res.statusCode}`));
                res.resume();
                return;
            }

            let rawData = '';
            let bytes = 0;
            const maxBytes = 1024 * 1024; // 1 MB 페이로드 보호 제한

            res.on('data', (chunk) => {
                bytes += chunk.length;
                if (bytes > maxBytes) {
                    req.destroy();
                    reject(new Error("API 응답 페이로드가 1 MB 제한을 초과했습니다."));
                    return;
                }
                rawData += chunk;
            });

            res.on('end', () => {
                try {
                    const parsed = JSON.parse(rawData);
                    resolve(parsed);
                } catch (err) {
                    reject(new Error(`JSON 응답 파싱 실패: ${err.message}`));
                }
            });

            res.on('error', (err) => {
                reject(new Error(`응답 스트림 오류: ${err.message}`));
            });
        });

        req.on('error', (err) => {
            reject(new Error(`네트워크 요청 오류: ${err.message}`));
        });

        req.setTimeout(8000, () => {
            req.destroy();
            reject(new Error("8000ms 후 네트워크 요청 시간이 초과되었습니다."));
        });
    });
}

/**
 * 오프라인 트래킹 채널을 생성하고 ISO/IEC 18004 준수 QR 코드 이미지를 렌더링합니다.
 * 
 * @param {string} channelCode - 고유 실물 자산 식별자 (예: 'poster_station_01')
 * @param {string} channelName - 어트리뷰션 대시보드 보고용 설명 레이블
 * @param {string} groupName   - 채널 그룹화 카테고리 (예: 'Offline_OOH')
 * @param {string} outputFilePath - 생성된 QR PNG의 타겟 파일 경로
 */
async function generateOfflineTrackingQRCode(channelCode, channelName, groupName = "Offline_OOH", outputFilePath = "channel_qr.png") {
    // 네트워크 요청을 만들기 전에 구성 존재 여부, DNS 구문 및 승인된 API 호스트 검증
    validateConfig();

    // 1단계: 구성된 channelAddEndpoint를 통해 채널 메타데이터 등록 또는 업데이트
    const addParams = new URLSearchParams({
        apiKey: CONFIG.apiKey,
        channelCode: channelCode,
        channelName: channelName,
        groupName: groupName
    });
    const addUrl = `https://${CONFIG.apiHost}${CONFIG.channelAddEndpoint}?${addParams.toString()}`;

    console.log(`[OpoInstall API] 채널 등록 중: ${channelCode} (${channelName})...`);
    const addResponse = await httpsGetJson(addUrl);

    if (addResponse.code !== 0) {
        throw new Error(`API에서 채널 생성을 거부했습니다. 코드: ${addResponse.code}, 오류: ${addResponse.error}`);
    }
    console.log(`[OpoInstall API] 채널이 성공적으로 등록되었습니다. 코드: ${channelCode}`);

    // 2단계: 생성 본문에 없는 경우 channelGetEndpoint를 통해 검증된 채널 트래킹 링크 검색
    let verifiedRawUrl = addResponse.body?.linkUrl || addResponse.body?.channelUrl;

    if (!verifiedRawUrl) {
        const getParams = new URLSearchParams({
            apiKey: CONFIG.apiKey,
            channelCode: channelCode
        });
        const getUrl = `https://${CONFIG.apiHost}${CONFIG.channelGetEndpoint}?${getParams.toString()}`;
        
        console.log(`[OpoInstall API] 채널 세부 정보 쿼리 중: ${channelCode}...`);
        const getResponse = await httpsGetJson(getUrl);

        if (getResponse.code !== 0 || !getResponse.body) {
            throw new Error(`API에서 채널 세부 정보를 검색하지 못했습니다. 코드: ${getResponse.code}, 오류: ${getResponse.error}`);
        }

        verifiedRawUrl = getResponse.body.linkUrl || getResponse.body.channelUrl;
    }

    if (!verifiedRawUrl) {
        throw new Error(`채널에 대해 서버에서 반환된 트래킹 링크 URL이 없습니다: ${channelCode}`);
    }

    // 3단계: 승인된 QR 트래킹 호스트 허용 목록에 대해 프로토콜 및 신뢰할 수 있는 도메인 권한 검증
    const trackingUrl = new URL(verifiedRawUrl);
    if (trackingUrl.protocol !== "https:") {
        throw new Error(`안전하지 않은 프로토콜이 감지되었습니다: ${trackingUrl.protocol}. 트래킹 URL은 HTTPS여야 합니다.`);
    }

    const approvedQrHosts = getApprovedHosts("APPROVED_QR_HOSTS");
    if (!approvedQrHosts.has(trackingUrl.hostname.toLowerCase())) {
        throw new Error(`신뢰할 수 없는 호스트 도메인: ${trackingUrl.hostname}. APPROVED_QR_HOSTS에 호스트가 존재하지 않습니다.`);
    }

    console.log(`[성공] 검증된 트래킹 URL: ${trackingUrl.toString()}`);

    // 4단계: ISO/IEC 18004 표준을 준수하는 QR 코드 매트릭스 렌더링
    const qrOptions = {
        errorCorrectionLevel: 'Q', // 인쇄 매체를 위한 최대 25% 손상 복구
        type: 'image/png',
        margin: 4, // 규정 준수 4모듈 여백(quiet zone)
        width: 1024 // 인쇄 제작용 고해상도 출력
    };

    await QRCode.toFile(outputFilePath, trackingUrl.toString(), qrOptions);
    console.log(`[생성됨] 바코드 이미지가 다음에 성공적으로 저장되었습니다: ${outputFilePath}`);
    return outputFilePath;
}

// 지역화된 인쇄 홍보물 자산 생성을 위한 예시 실행
// 사용법: node generate_channel_qr.js
if (require.main === module) {
    generateOfflineTrackingQRCode("ooh_broadway_01", "뉴욕 브로드웨이 빌보드 #1", "Q3_Outdoor", "broadway_billboard_qr.png")
        .then((file) => console.log(`실행 완료: ${file}`))
        .catch((err) => {
            console.error(`실행 실패: ${err.message}`);
            process.exit(1);
        });
}

module.exports = { generateOfflineTrackingQRCode };

오프라인 앱 트래킹 기술 비교표

전통적 인쇄 코드, 정적 스토어 링크 및 동적 매개변수화된 QR 코드 평가

최적의 QR 트래킹 방식을 선택하는 것은 인쇄 후 유연성, 플랫폼 라우팅 기능, 어트리뷰션 깊이 및 운영 위험을 평가하는 것을 수반합니다.

아래의 비교표는 오프라인 트래킹 모델 전반의 근본적인 기술적 차이점을 요약합니다.

유지보수 오버헤드, 분석 세밀도 및 인쇄 후 유연성 평가

스토어 직결형 정적 구현은 막대한 운영 책임을 초래합니다. 기업이 정적 App Store 링크가 포함된 50,000개의 제품 패키지를 인쇄하는 경우, 향후 URL이 변경되면 패키지가 영구적으로 손상됩니다. 또한 모든 캠페인마다 별도의 웹사이트를 생성하지 않는 한 마케팅 팀은 제품 패키지가 10개의 설치를 유발했는지 10,000개의 설치를 유발했는지 파악할 수 없습니다.

동적 매개변수화된 QR 코드는 이러한 한계를 완화합니다. 관리형 QR 링크는 iOS 및 Android 방문객을 플랫폼에 적절한 목적지로 안내하고 물리적 배치 식별자를 스캔 활동과 연결할 수 있습니다. 설치 어트리뷰션은 지원되는 SDK 또는 스토어 메커니즘과 성공적인 매칭에 따라 유지됩니다. 마케팅 팀이 목적지를 다이렉트 스토어 등록정보에서 인터랙티브 홀리데이 경품 랜딩 페이지로 전환하기로 결정한 경우, 중앙 관리 콘솔에서 목적지 URL만 업데이트하면 되며 재인쇄가 전혀 필요하지 않습니다.

스캔 실패 및 오프라인 데이터 불일치 트러블슈팅

스캔 이탈 관리: 사용자가 스캔했으나 스토어 리다이렉션 전에 종료하는 경우

오프라인 마케팅 퍼넬에서는 이벤트 정의에 따라 트랜짓 방문 수가 어트리뷰션된 최초 실행 수를 초과하는 경우가 흔합니다. 스캔 이벤트는 실물 바코드가 스마트폰 카메라에 의해 인식되고 트랜짓 URL을 로드하는 순간 기록됩니다.

스캔 지표와 앱 설치 간의 불일치는 여러 실제 사용자 행동에서 비롯됩니다.

• 네트워크 지연으로 인한 이탈: 지하철역이나 혼잡한 컨벤션 센터와 같이 물리적 환경의 셀룰러 수신 상태가 불량한 경우, 사용자는 HTTP 302 리다이렉션이나 웹 JS SDK가 로드되기 전에 브라우저를 닫을 수 있습니다.
• 앱 스토어 뷰 이탈: 사용자는 앱 스토어 등록정보를 확인하고 파일 크기나 사용자 리뷰를 평가한 후 다운로드를 시작하지 않기로 결정하는 경우가 빈번합니다.
• 지연된 최초 실행: 셀룰러 데이터에 연결된 사용자는 “다운로드”를 탭할 수 있지만 Wi-Fi에 연결될 때까지 애플리케이션 열기를 연기할 수 있습니다. 어트리뷰션 콜백은 애플리케이션의 최초 실행 중에 실행되므로 설치는 스캔 타임스탬프보다 몇 시간 또는 며칠 지연됩니다.

원시 스토어 URL에 대한 인앱 소셜 스캐너 차단 대응

오프라인 사용자의 상당수는 네이티브 시스템 카메라 앱 대신 소셜 메시징 애플리케이션(예: WeChat, Line, WhatsApp)의 내장 카메라를 사용하여 QR 코드를 스캔합니다.

모바일 컨테이너 연구에서 살펴보았듯이 소셜 인앱 브라우저는 제한적인 샌드박스를 강제합니다.

• 스킴 인터셉션: 소셜 스캐너가 커스텀 스킴(market:// 또는 다이렉트 커스텀 URL)을 호출하려는 URL을 로드하면 인앱 컨테이너가 프로토콜을 차단합니다.
• 다운로드 억제: 소셜 웹뷰는 Android에서의 직접 APK 바이너리 다운로드를 일상적으로 제한합니다.
• 해결 프로토콜: 트랜짓 페이지는 지원되는 핸드오프 옵션이나 외부 브라우저에서 목적지를 열기 위한 명확한 지침을 제공할 수 있습니다. 실제 동작은 호스트 애플리케이션의 내비게이션 정책에 따라 다릅니다. 다이렉트 앱 또는 스토어 핸드오프를 사용할 수 없는 경우 접근 가능한 HTTPS 대안을 제공하십시오.

관리되지 않는 앱 다운로드 워크플로우 전반의 파라미터 손실 진단

애플리케이션이 최초 실행 시 파라미터를 검색하지 못하는 경우(getInstallParam이 빈 데이터를 반환함), 엔지니어링 팀은 다음 통합 검사점을 감사해야 합니다.

• SDK 초기화 범위: 네이티브 SDK 플랫폼 문서에 따라 기본 애플리케이션 프로세스 내에서 SDK 초기화가 올바르게 구성되었는지 확인합니다.
• 덮어쓰여진 설치: 애플리케이션이 이미 이전에 설치되었던 기기에서 테스트를 진행하면 SDK 캐싱 및 중복 제거 규칙에 따라 새로운 파라미터 콜백이 억제될 수 있습니다. 항상 애플리케이션을 완전히 제거하거나 신규 실물 테스트 기기를 사용하여 테스트하십시오.
• 설치 소요 시간(Time-to-Install) 윈도우 만료: 사용자가 실물 포스터를 스캔했으나 플랫폼 룩백 윈도우를 넘어 앱 다운로드 및 열기를 지연시키는 경우, 적격 어트리뷰션 윈도우가 만료되어 보고 규칙에 따라 매칭되지 않거나 달리 어트리뷰션된 상태로 남는 설치가 발생할 수 있습니다.

실물 검증 프로토콜: 크기 지정, 여백(Quiet Zones) 및 오류 정정

오프라인 어트리뷰션의 실효성은 실물 바코드 실행에 크게 좌우됩니다.

• 경험적 실물 크기 지정: 스캔 가능한 매트릭스는 경험적 거리 대비 크기 휴리스틱을 따라야 합니다: $\text{Estimated Minimum Width} \approx \frac{\text{Scanning Distance}}{10}$. 1.5미터 거리에서 보는 포스터의 경우 QR 매트릭스의 너비는 최소 15센티미터여야 합니다. 크기는 다양한 조명 조건에서 실물 테스트 인쇄를 통해 검증되어야 합니다.
• 여백(Quiet Zone) 보존: 바코드는 4개의 바깥쪽 가장자리 주변으로 최소 4개 모듈 너비의 인쇄되지 않은 “여백”을 유지해야 합니다. 그래픽 테두리, 텍스트 또는 예술적 텍스처를 모듈 매트릭스에 직접 맞닿게 인쇄하면 카메라 가장자리 감지 알고리즘이 손상됩니다.
• 오류 정정 튜닝: 물리적 마모, 저조명 또는 부분적인 장애물(예: 야외 현수막 또는 골판지 포장재)의 영향을 받는 인쇄 홍보물은 ISO/IEC 18004:2024 표준에 따라 레벨 M(15% 복구) 또는 레벨 Q(25% 복구) 오류 정정을 사용하여 생성해야 하며, 이를 통해 코드가 약간의 표면 긁힘을 입더라도 성공적으로 디코딩할 수 있습니다.

요약 및 구현 의사결정 프레임워크

QR 코드 트래킹 배포는 오프라인 광고를 측정 불가능한 비용 센터에서 정량화 가능한 사용자 확보 채널로 탈바꿈시킵니다. 스토어 직결형 정적 링크에 의존하면 마찰이 발생하고, 플랫폼이 배제되며, 일단 인쇄된 자재는 전체 링크가 깨질 위험이 있습니다.

엔지니어링 및 성장 팀은 동적이고 매개변수화된 앱 QR 코드를 표준화해야 합니다. 중앙 집중식 리다이렉트 간접 방식과 클라이언트 측 환경 감지 및 SDK 파라미터 복원을 결합함으로써, 플랫폼은 측정 가능한 캠페인 활동 및 지원되는 설치 어트리뷰션을 통해 물리적 영역과 디지털 영역의 간극을 좁힙니다.

실물 캠페인 채널을 구성하고 동적 트래킹 코드를 생성하려면 OpoInstall 개발자 콘솔에서 파라미터를 구성하거나 SDK 통합 레퍼런스를 검토하십시오. 클라이언트 SDK 통합 세부정보에 대해서는 OpoInstall SDK 다운로드를 방문하거나 모바일 어트리뷰션 구현 레퍼런스에서 광범위한 멀티 채널 분석을 살펴보십시오.

관련 자료

• 개념: QR 코드 트래킹, 동적 QR 코드, 앱 QR 코드, 스캔-투-설치 퍼넬

• 기술: ISO/IEC 18004 바코드 표준, HTTP 302 리다이렉션, User-Agent 스니핑, 웹 JS SDK

• 표준: IETF RFC 3986 균등 자원 식별자 구문, ISO/IEC 18004:2024 정보 기술

• API: OpoInstall 채널 관리 API, OpoInstall getInstallParam 네이티브 API

• 공식 문서 및 레퍼런스:

  • 사용자 개인정보 보호 및 데이터 사용에 관한 Apple 개발자 지침

  • 설치 레퍼러 API에 관한 Google Android 개발자 가이드

  • 국제표준화기구 (ISO/IEC 18004:2024)