IP 주소, 위치, 사용자 에이전트 및 장치 속성

Amplitude는 각 이벤트와 함께 도착하는 데이터로부터 사용자의 위치, 기기 및 플랫폼 속성을 파생하며, 사용자가 이러한 속성을 직접 설정할 필요가 없습니다. 이 기능은 MaxMind GeoIP 데이터베이스를 사용하여 이벤트의 IP 주소에서 도시, 지역 및 국가를 조회하고, 클라이언트측 SDK가 전송하는 사용자 에이전트 문자열을 분석하여 장치 컨텍스트, 운영 체제 및 웹 브라우저 정보를 확인합니다. HTTP API를 통해 서버 측에서 위치 값을 재정의하거나, SDK에서 IP 추적을 비활성화하거나 수집 후 IP 주소를 삭제하여 Amplitude가 IP 주소를 사용하지 못하도록 막을 수 있습니다.

Amplitude가 위치 속성을 추적하는 방법

Amplitude는 MaxMind 데이터베이스를 사용하여 사용자의 IP 주소로부터 위치 정보를 조회합니다. MaxMind 데이터는 신뢰할 수 있지만 도시 및 지역 정보의 정확성과 가용성은 국가마다 다를 수 있습니다.

기본적으로 Amplitude는 GeoIP를 사용하여 location_lat및 location_long을 기반으로 위치 속성 값을 수집합니다. Amplitude가 사용자의 위치 속성을 서버 측에서 추적하는 방법을 명시적으로 정의할 수 있습니다. Amplitude의 HTTP API를 사용하면 이벤트와 함께 고유한 [Amplitude] City, [Amplitude] DMA, [Amplitude] Region, 및 [Amplitude] Country 값을 전송할 수 있습니다.

IP 주소를 사용할 수 없는 경우 Amplitude가 위치 속성을 결정하는 방법

Amplitude는 SDK 구성에서 IP 주소 추적을 비활성화하고 수집 후 IP 주소를 삭제하는 것을 모두 지원합니다. 선택한 방법은 Amplitude가 위치 속성을 결정하는 방법에 영향을 줍니다.

SDK에서 IP 주소 추적 비활성화

SDK 구성에서 IP 주소 추적을 비활성화하면(예: 브라우저 SDK, Android-Kotlin SDK, iOS Swift SDK), Amplitude는 절대로 IP 주소를 수신하지 않습니다. Amplitude의 백엔드 서비스는 사용자의 위치를 조정할 수 없으며, 위치 속성은 모두 비어 있습니다.

IP 주소 필터링

수집 후 IP 주소를 삭제하도록 Amplitude 서포트에 요청하는 경우, Amplitude의 백엔드 서비스는 IP 주소를 처리하여 위치를 확인하지만, IP 주소 자체는 Amplitude에 지속되지 않습니다. Amplitude는 이벤트의 위치 속성을 채우지만 IP 주소는 비어 있습니다.

Amplitude가 사용자 에이전트 및 기기 정보를 구문 분석하는 방법

Amplitude는 클라이언트측 SDK 필드의 기기 컨텍스트를 처리하며, 웹 이벤트의 경우 사용자 에이전트 문자열도 처리합니다. Amplitude는 처리된 값을 이벤트에 저장하고 선택된 값을 분석을 위한 내장 속성으로 노출시킵니다.

사용자 에이전트 구문 분석

클라이언트측 SDK는 다음을 설명하는 장치 컨텍스트를 전송할 수 있습니다.

1. 장치 모델: 특정 장치 모델(예: iPhone 13, Samsung Galaxy S21).
2. 운영 체제: OS 및 해당 버전(예: iOS 15.4, Android 12).
3. 브라우저: 웹 트래픽의 경우 브라우저 및 해당 버전(예: Chrome 98.0.4758.102).
4. 플랫폼: 일반 플랫폼 범주(예: iOS, Android, Web).
5. 제조업체: 장치 제조업체입니다(예: Apple, Samsung).

장치 속성

필드 이름은 이벤트 수집, 내보낸 이벤트 및 Amplitude UI마다 다릅니다. 이 표에서는 다음 용어를 사용합니다.

• HTTP V2 API 필드: 이벤트를 전송할 때 HTTP V2 API가 허용하는 최상위 필드입니다.
• Export API 필드: Amplitude가 이벤트를 처리한 후 Export API가 반환하는 필드입니다.
• UI 레이블: 차트 및 필터 속성 선택기에 표시되는 이름입니다.

예를 들어 Export API는 os_name및 os_version를 별도의 필드로 반환합니다. UI는 이들을 결합하고 결과를 OS로 표시합니다.

Amplitude는 별도의 내장 browser 기능이나 browser_version 필드를 노출하지 않습니다. 브라우저 SDK가 user_agent를 전송합니다. 웹 트래픽의 경우, Amplitude는 파싱된 브라우저 이름과 주요 버전을 os_name및 os_version에 저장합니다. UI는 OS 속성 내에서 해당 필드들을 결합합니다.

Amplitude는 device_brand, device_manufacturer, 및 device_model을 결합하여 표준화된 device_family 값과 device_type 값을 결정합니다. 인식된 조합은 Amplitude의 표준화된 장치 제품군 및 유형에 매핑됩니다. 인식되지 않는 패밀리는 제공된 장치 구성요소에 대한 결합된 설명을 사용할 수 있지만 device_type유형 매핑이 없을 경우 비어 있을 수 있습니다.

UI는 Apple iPhone 또는 Samsung Galaxy Phone과 같은 광범위한 그룹에 대해 장치 제품군을 사용합니다. 이 도구는 Apple iPhone 6 또는 Samsung Galaxy S5와 같은 특정 유형에 대해 장치 유형을 사용합니다. 기본 제공 속성의 전체 목록을 보려면 기본 사용자 속성으로 이동하십시오.

사용자 에이전트 구문 분석 작동 방식

1. 클라이언트측 컬렉션: 브라우저 SDK는 이벤트와 함께 사용자 에이전트 문자열을 전송합니다. 다른 SDK는 지원되는 필드를 통해 장치 컨텍스트를 전송할 수 있습니다.
2. 서버측 파싱: 웹 이벤트의 경우 Amplitude는 브라우저 및 장치 컨텍스트를 파싱user_agent합니다. 명시적 os_name, os_version및 장치 필드는 Amplitude가 사용자 에이전트로부터 파생한 값보다 우선합니다.
3. 속성 할당: Amplitude는 처리된 값을 Export API 열에 나열된 이벤트 필드에 저장합니다.
4. 분석 가용성: Amplitude는 세그멘테이션, 필터링 및 분석을 위해 UI 레이블 열에 나열된 속성을 표시합니다.

장치 속성 추적 제어

특정 기기 속성에 대한 자동 추적을 비활성화하려면 SDK의 trackingOptions구성을 사용하십시오. 예를 들어 브라우저 SDK에서 다음을 수행합니다.

amplitude.init(AMPLITUDE_API_KEY, {
  trackingOptions: {
    platform: false,
    language: false,
  },
});

모바일 관련 장치 정보

모바일 SDK(iOS, Android)의 경우, Amplitude는 다음과 같은 추가 기기 정보를 수집합니다.

1. iOS: 기기 모델, OS 버전 및 통신사 정보(가능한 경우)입니다.
2. Android: 기기 모델, 제조업체, OS 버전, 통신사 및 화면 크기.

이 정보는 다양한 기기 유형과 OS 버전 간에 앱이 어떻게 작동하는지 이해하는 데 도움이 됩니다.

사용자 지정 장치 속성

Amplitude가 자동으로 캡처하지 않는 추가 기기 정보를 추적해야 하는 경우, 이벤트에 사용자 지정 속성을 추가할 수 있습니다.

// Example of adding custom device properties
amplitude.track("Button Clicked", {
  screen_resolution: "1920x1080",
  connection_type: "wifi",
  battery_level: 85,
});